Skip to content

User Data

smallketchup82 edited this page Oct 29, 2026 · 1 revision

Location and contents

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.

Back up or move to another Mac

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.

Collect logs

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.

Clone this wiki locally