Skip to content

Configuration

smallketchup82 edited this page Oct 29, 2026 · 1 revision

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

Defaults for a new profile

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

Applying changes

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.

Clone this wiki locally