[friendly-ripper]

Part 3 of 9 · base stack/02-il2cpp · 24 commits

Feature code, game bindings, and runtime helpers were tangled together. One hotkey file held the frame tick and the fleet state machine. Settings were a flat list of fields, and sync work ran on detached threads. This PR gives each feature ownership of its hooks, shortcuts, and state. Shared access moves into the IL2CPP and Unity libraries. The runtime fixes that this exposed land in the same stack.

What changes

Bindings and shared helpers:

• About 120 single-class headers under prime collapse into ten domain headers (chat, fleet, inventory, navigation, server, UI, Unity, viewers, and a few more). Unused bindings are removed; binding bodies otherwise move unchanged.
• Unity liveness, placement, and text helpers that features each spelled out move into the shared Unity binding header. In the last commit, Unity engine, UI, TextMeshPro, and input types move out of the game folder into a Unity library with the instance tracker; features call library helpers instead of the raw runtime API.
• Ship-name matching splits from the game localisation call so its text half can be tested without the game. Warp, pinned ships, and the window code share that one matcher.

Settings, input, and installation:

• Config held about 130 flat fields whose names had drifted from their TOML keys, with defaults declared a second time elsewhere. Each TOML section is now a struct whose members are named after their keys and carry their defaults. Keys, defaults, and vars output are unchanged.
• The frame tick checks the settings file once a second and reloads only after a change has held for a whole check, so a half-written file cannot reset everything to defaults. A reload parses first and keeps the current settings on failure. Patch groups are decided at startup, so changing one logs that it waits for a restart.
• Keyboard and mouse state move into an input module cached per frame. Hooks that read keys poll once per frame instead of asking Unity for the frame number on every query (about 190 input calls on an idle frame). Shortcuts gain one settings table with defaults, tiers, and deprecated aliases, and dispatch, fleet actions, and keybind badges become separate files.
• File becomes a namespace that parses the command line once. Path joining and legacy-file migration move with it, and window state and UI scale handlers move to the files that use them.
• Installation is centralised. The feature list is one table of name, install function, and patch-group member. Every feature exports a descriptor with its patch group, install function, and frame work. Hooks install in named groups, even when their setting starts disabled. Each hook reads the current switch at call time.

Sync:

• Every entity group and realtime slot message used to start its own detached thread, so a delta could be applied before the full list. One thread now handles messages in arrival order, and each queue drops its oldest entry when full.
• A game login resets sent state through the processing queue, in order, so an account or server switch is no longer diffed against the previous account. Record processors and their routing table move out of the game hooks into their own file.

Feature consolidation:

• Toast queue hooks, Windows notification mirroring, and battle result formatting become one file; the three loading screens share one implementation. The warp label and cargo formatting merge into the features that own them. Fleet labels get one owner type in the camera code, and the anomaly timer gets one owner that resolves its view from the visible canvas.
• Officer roster and assignment comparators, which differed only in predicate and tiebreaker sign, become one template that still picks the same four combinations.

Behavior changes

• Settings now reload in place when the file changes, without a restart, except [patches] groups, which still need one.
• -debug and -trace work as last arguments, and -ccm paths on macOS no longer get a doubled directory.
• Donation caps apply only inside the donation popup, and never above what the player owns. Before, a use-items popup could offer the donation cap.
• Camera fixes: entering a system while typing still jumps to the default system zoom, each flat renderable keeps its own scaled size, and a frame pans by keys or by glide, not both. A fleet-label preset of 0 no longer overwrites the default system zoom.
• Chat preview no longer forces alliance chat on every panel change when a channel is disabled, and mission HUD updates follow the current setting after a reload.
• Loading assets stay loaded while Unity reports them alive instead of decoding about 4 MB again on every login and transition. A JPG loader image now sizes its sprite from the loaded texture instead of a hand-parsed PNG header.

Testing

Built with xmake. Every commit was built on macOS arm64. Nothing was run in the game.