Script Package Path Migration

For developers who push remote Go scripts through the /auto endpoint, and anyone maintaining local scripts/*.majsoul samples: update the import paths in your scripts per this guide.

TL;DR

• For the vast majority of packages: only the import path changes. The pkg.Inst().Method() call style is completely unchanged.
• utils was split into 4 packages (drop .Inst(), call package-level functions instead — see B1). (The merged countdown / playerinfo UI-state packages have since been removed in the Unity migration — see the notice above.)
• Method names never change. The config path is unchanged. The engine packages github.com/moxcomic/lq and github.com/moxcomic/engine/tenhou_client are unaffected.

Why it changed

The Go script interpreter uses a symbols table to map the import paths in your script to the real Go packages. After the refactor these packages physically moved (new import paths), and the symbols table was updated to match. But the import paths hard-coded in your scripts must be changed by you — if a path doesn't match, the interpreter can't resolve the symbol and errors out at load or runtime.

A. Import path only (call style unchanged)

Call style is unchanged, for example:

// Only the import line above changes; the calls below stay exactly the same
gamestate.Inst().GetHandTile()
variable.Inst().GetInt("ju")
actions.NewMajsoulActions()
pusher.Inst().SendMasterText("...")

B. Call style also changed (split / merge)

B1. utils split into 4 packages (drop .Inst())

The old utils.Inst().X(...) now becomes the matching package's package-level function pkg.X(...):

B2 / B3. Countdown (countdown) and player info (playerinfo) — removed

Full example: a Tenhou room script before and after

Before (old paths + old utils call):

import (
	"github.com/moxcomic/Archer/utils"
	"github.com/moxcomic/Archer/gamestate"
	"github.com/moxcomic/Archer/userinfo"
	"github.com/moxcomic/Archer/variable"
	tenhouclient "github.com/moxcomic/engine/tenhou_client"
	"github.com/moxcomic/lq"
)

func dispatch() error {
	return utils.Inst().DispatchBot(1000, 20, strconv.Itoa(ROOM_ID), "high", "4.1b", "4.1b", "4.1b")
}

After:

import (
	"github.com/moxcomic/Archer/internal/platformutil/botdispatch"
	"github.com/moxcomic/Archer/internal/domain/gamestate"
	"github.com/moxcomic/Archer/internal/infra/userinfo"
	"github.com/moxcomic/Archer/internal/infra/variable"
	tenhouclient "github.com/moxcomic/engine/tenhou_client"
	"github.com/moxcomic/lq"
)

func dispatch() error {
	return botdispatch.DispatchBot(1000, 20, strconv.Itoa(ROOM_ID), "high", "4.1b", "4.1b", "4.1b")
}

The gamestate.Inst() / userinfo.Inst() / variable.Inst() / tenhouclient.Inst() calls are untouched — only the import lines and the single utils.Inst().DispatchBot call changed.

Migration checklist

1. Replace every github.com/moxcomic/Archer/<X> import in your script with the internal/... path from table A.
2. utils.Inst().X() → per B1, change to the package-level function in engineswitch / botdispatch / pagecontrol / extension (drop Inst().).
3. winmgr / huleshowmgr / scorechangemgr / playerinfomgr / otherplayerinfomgr and other UI-state query packages → removed in the Unity migration; delete those calls and derive state from the in-game event stream instead.
4. config, github.com/moxcomic/lq, and github.com/moxcomic/engine/tenhou_client stay unchanged.
5. If you used userinfo.Inst().IsVaild(), change it to IsValid().
6. Redeploy to the /auto push side. The local sample scripts/auto.majsoul has been updated and can be used as a reference.