Skip to content

Development Migration

smallketchup82 edited this page Oct 29, 2026 · 1 revision

The portable folder is not a build input. Its downloaded content and personal settings are imported separately into ~/Library/Application Support/Zero-K. The migration script verifies copied files with SHA-256 and keeps conflicting older settings under that directory's migration-backup/ folder. Its detailed report is private under .local/, never tracked or bundled.

Previous change/data Canonical destination
macOS ARM64 graphics integration Recoil fork, July macOS branch
Grey selection panel fix Chobby fork, macos/game-data/LuaUI/ctrlpanel.txt
Native trackpad events and camera controls Recoil input/platform code
Trackpad settings widget Chobby fork, macos/game-data/LuaUI/Widgets
Retina surfaces, UI fonts, viewports and pixel capture Recoil renderer/font/Lua code
Native FPS counter Recoil game UI code
CAS Full Retina capture Chobby fork's macOS game widget resources
Lobby Retina dropdown and restart notice Chobby graphics settings source
In-game Retina dropdown/restart notice Chobby macOS game widget resources
Forced VSync and one Dock entry Recoil macOS presenter/platform code
Steam login and explicit engine/resource/data paths Infrastructure fork's ARM64 helper
CircuitAI Apple ARM64 calling convention fix CircuitAI fork, pinned by the engine submodule
Bundle construction, dependency relocation, icons and audits Central app/ and scripts/
Maps, game archives, packages, pool, missions and downloads Application Support
Accounts, user keys/preferences, saves, replays and logs Application Support, never the app
Software-rendering/Rosetta engine experiments and foreign executables Superseded; excluded from build inputs

Import an old development profile

scripts/migrate-data.py is an optional developer tool. It looks for zero-k-portable/ and native-data/ under the supplied workspace; it is not a general importer for arbitrary directory layouts. Quit Zero-K and back up the destination before using it.

uv run --no-project --python python3 python scripts/migrate-data.py \
  --workspace /path/to/old/workspace

The default destination is ~/Library/Application Support/Zero-K; --destination selects another folder. The tool copies user data, preserves conflicting settings under migration-backup/, verifies SHA-256 values, and writes a private .local/migration-report.json in the supplied workspace. Review that report and check that the packaged app works independently before removing old data.

The distributed app never imports a developer workspace or another person’s account. First launch seeds only clean bundled defaults. Shipped AI profiles come from public source defaults and freshly built ARM64 AI; old private AI configuration and scripts are not distribution inputs.

Clone this wiki locally