Repository navigation
User Data
The app's code and bundled resources stay inside Zero-K.app. Your accounts,
settings, downloaded games and maps, replays, saves, logs, and caches live in:
~/Library/Application Support/Zero-K
In Finder, press ⌘⇧G and paste that path to open it.
| File or folder, relative to that directory | Purpose |
|---|---|
springsettings.cfg |
Engine settings, including Retina mode and native trackpad settings |
LuaMenu/Config/IGL_data.lua |
Saved lobby configuration |
LuaUI/Config/ZK_data.lua |
Saved in-game UI and widget options, including cursor locking |
games/, maps/, packages/, pool/, rapid/
|
Downloaded content and content-management data |
infolog.txt, log/
|
Engine and launcher logs |
demos/, saves/
|
Replays and saved games |
Prefer changing settings through the lobby or in-game menus. Quit the app before editing configuration files manually. Back up this directory if you want to preserve your setup. It can contain account information and other personal data: do not upload the whole directory with a bug report. Review logs and redact credentials, authentication tickets, and personal information before sharing them.
Quit Zero-K completely before copying the folder. Keep the original backup until the new installation opens with the expected settings, downloads and saves. Install the app separately from the DMG; personal data does not belong inside Zero-K.app.
If a developer run uses ZKMACOS_DATA_DIR, its profile is stored at that override instead. The default path above describes normal launches.
Copy infolog.txt soon after reproducing a problem, before another launch overwrites it. Check log/launcher.log or log/engine-launch.log when present for startup failures. A relevant macOS crash report may also be available in ~/Library/Logs/DiagnosticReports/.
Use Reporting Bugs to decide which files are useful. Share selected, reviewed logs rather than the whole profile.
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