Repository navigation
Configuration
Use the lobby and in-game menus before editing configuration files. These pages cover the macOS additions; Zero-K’s normal gameplay settings are still available.
| Page | What it covers |
|---|---|
| Graphics and Display | Retina modes, MetalFX, HDR, GPU sharing, DisplayLink, fullscreen and FPS |
| Trackpad | Pan, zoom, tilt, sensitivity and momentum |
| Game and Interface | Start announcements, commander marker, cursor locking and Steam login |
| User Data | Configuration paths, logs, downloads and backups |
Before the lobby starts for the first time on each app version, a native
dialog repeats the warnings about this unofficial, experimental client and links to this project's issue tracker.
Choose I Understand to continue. Acknowledgments are
saved in startup-warning-versions.json in your Application Support data.
| Setting | Default |
|---|---|
| Lobby and game display | Windowed |
| Graphics preset | Low |
| Retina mode | Retina text and UI |
| Trackpad camera controls | Enabled |
| Three-finger tilt | Disabled; use Option + two fingers |
| Lock Cursor to Window | Disabled |
| Native FPS counter | Enabled |
| macOS HDR display output | Disabled |
| Experimental DisplayLink frame pacing | Disabled; toggle in Graphics (lobby) or Graphics → Display (game) |
| ZkMacOS start message and commander marker | Both enabled; toggle separately in lobby Settings → Game |
| VSync | Forced on |
Retina mode and notchful fullscreen require quitting the whole app and reopening it. Starting another battle is not enough. MetalFX, macOS HDR output, GPU resource sharing, DisplayLink, and trackpad toggles apply immediately. The startup announcement settings are read when each new game starts.
Updating the app preserves saved preferences. These defaults apply to a new profile, not every update.
If a setting is missing, compare your installed release with the wiki’s current-source instructions. Newer options may not be included in an older published build.
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