Repository navigation
Development Migration
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 |
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/workspaceThe 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.
ZkMacOS source · Download the DMG · Report a bug · Get help
Unofficial, experimental Zero-K client. These guides describe the current source; older releases may differ.
- Getting Started
- Playing Zero-K
- Development
- Contributing
- Environment Setup
- Build and Release
- Internals and Validation
- Licensing and Credits
- Source · Downloads