Loading...
  OR  Zero-K Name:    Password:   

ZkMacOS: A macOS Port of Zero-K

6 posts, 421 views
Post comment
Filter:    Player:  
sort

Announcing ZkMacOS, a fully functional native port of Zero-K’s client and Recoil engine for Apple Silicon Macs running macOS 26 or newer.

I’ve been actively working on getting Zero-K running on macOS since the parallels desktop VM's in 2024. ZkMacOS is the culmination of two years of research and trial and error. The engine and launcher run as native ARM64 code, and the Chobby lobby runs inside Recoil. A translation pipeline takes the engine’s OpenGL rendering to Metal for GPU acceleration.

Features


Feature What it adds
Trackpad mode Built from scratch for playing on a MacBook trackpad. Pan with two fingers, pinch to zoom, and tilt with Option + two fingers or an optional three-finger gesture. Sensitivity and momentum are adjustable.
Retina rendering Choose standard resolution, sharp text and UI with a lower-resolution world, or Full Retina.
MetalFX Optionally upscale the game world in UI-only Retina mode while keeping the interface at native resolution.
Steam login Sign in through your running Steam client using a bundled ARM64 helper.
Self-contained app Drag Zero-K.app into Applications. Everything needed to run the client is bundled, with no Rosetta, Wine, Mono, or separate .NET installation required.
In-app updates A native Sparkle updater checks GitHub for signed updates and waits until the game exits to install them.
Experimental HDR Displays bright effects in HDR on supported displays while keeping the UI at normal brightness.
Experimental GPU resource sharing Passes textures directly from Mesa to Metal where supported, reducing CPU readback for macOS graphics features.
Experimental DisplayLink An optional display-driven presentation mode designed to improve frame pacing.
Notchful fullscreen Optionally extends the game into the menu bar area and adjusts the resource bar and top-bar layout around the camera notch.

Feel free to submit feature requests by following this guide

Performance & Stability


The port is feature-complete and runs smoothly in typical play. With a fast connection, you can install it and get into a game in under five minutes. On my 2023 M3 MacBook Pro (10-core GPU, 16 GB RAM), the Low preset typically gets 60–90 FPS with UI-only Retina and 40–60 FPS with Full Retina. Map size and late-game battles can change those numbers.

ZkMacOS is an unofficial client in permanent beta. The graphics translation stack is experimental, and even if it runs beautifully most of the time, one crash can cost you a ranked game. Play with Elo on at your own risk. Please report port-specific bugs via the bug reporting guide.

Safety & Security


The app ships without Developer ID signing or notarization because I don’t have an Apple Developer membership. Expect a macOS approval prompt the first time you open a newly downloaded version. Donations could cover the membership and let future builds ship signed and notarized.

Each release links to its VirusTotal analysis on GitHub. The port’s source code is public, including the engine, lobby and launcher changes. You can audit it and follow the build guides to compile your own Zero-K.app. The port and build tooling were developed with substantial assistance from OpenAI Codex.

Release builds include Sentry. By default, automatic reporting is limited to crashes the reporter attributes to the macOS port. Error reporting is opt-in. Reports use minimal diagnostics to help catch serious bugs and identify faulty releases. Default reports omit account details and chat, and the reporter attempts to scrub identifying details. Full logs, replays, and other attachments are off by default. You can choose what to share or disable telemetry entirely in Settings → Telemetry.

Links


Releases • Main Page • Installation Guide • Documentation • Donate

Technical Details


Getting Recoil to launch was one thing. Getting water, reflections, and a crisp UI through two graphics translation layers was the fun part.

Recoil OpenGL → Mesa Zink → Vulkan → Mesa KosmicKrisp → Metal

Apple’s OpenGL implementation lacks functionality Recoil needs. Zink implements those OpenGL calls over Vulkan, and KosmicKrisp translates Vulkan to Metal. That last step uses Metal 4, which is where the macOS 26 requirement comes from. The port builds on the Recoil version Zero-K expects, with fixes for framebuffer handling, water, reflections, and input. CircuitAI even needed an Apple ARM64 calling-convention fix to get local skirmishes working.

UI-only Retina came out of splitting the game scene from the UI. The world can render at a lower resolution and go through MetalFX, while text and menus are drawn at native display resolution. Getting those frames onto the screen is its own problem. The fallback path reads frames back through the CPU, so there’s an experimental path that shares GPU textures directly with Metal.

Chobby is a Lua menu hosted by ARM64 Recoil, with the Mac settings integrated into the lobby. A bundled ARM64 .NET helper talks to Steam through Steamworks.NET. The app bundle holds the runtime and static resources, while settings, maps, and game downloads live in ~/Library/Application Support/Zero-K. That lets Sparkle replace the app without touching your data.
+6 / -0
In the time between now and when I made the post, I have added:
- MetalFX spatial upscaling support. With experimental GPU resource sharing for better performance.
- Optimized fullscreen transitions and fullscreen handling on MacOS
- Added Game Mode support when the game is focused and fullscreened
- Added a custom notch-ful fullscreen mode which extends the game window to utilize the space taken up by your menu bar. Offers an alternative layout for your resource bars.
- Added an automatic update system.

Next up is likely going to be:
1. HDR support (in some capacity)
2. Heavy optimization of the lobby and engine for laptop environments
3. Possible controller support & handling.

I've looked into Temporal MetalFX and also ray tracing. Both could require substantial engine changes which would be hard to keep compatible with upstream engine updates, so for now they're very low priority.

A new release with the version 202610.27.2 will be published shortly. Make sure you download and install this version manually, as it contains the new auto update system.
+2 / -0
18 days ago
Yo dude this is epic! I was playing on my windows machine but recently had to sell it, so I lost access to ZERO-K. But if what your saying is true, this is incredible! I can get it on my mac now! Sure I imagine glitches will be present among other issues, but zero-k is still zero-k. Im curious, are you using claude to help make the game compatible with mac? Is claude capable of trouble shooting and fixing glitches from the git hub repository if I decide to download it and make changes to it myself? What are the known issues you are aware of now, and what new changes do you plan to add to this mac version of Zero-K?
+1 / -0
Hey TheCamerasEye, so I used mainly OpenAI Codex to build the tooling surrounding the port. The port itself uses existing code/PR's from the Recoil engine repository, to which my involvement was mostly just tying things together to make it work for Zero-K specifically.

The home page of the repo documents all of the changes that I've made to base Zero-K to improve the experience on MacOS. The issues tab on the repository documents the changes I plan to make eventually. There's pretty comprehensive documentation in the GitHub repo's wiki which should answer a lot of your other questions.

You can play with it right now by following the installation guide. It's really only 3 steps: you download the .dmg, drag the .app to your Applications folder, permit the app to run via your system settings, and done. Nothing else needs to be installed, it connects with the main server automatically, it behaves exactly like a normal Zero-K client.

I don't think there's any serious reproducible issues that I've noticed so far, but the list of current issues can be found here

As for bug fixing, you can certainly use the documentation I've written to set up a development environment and tinker with the port yourself. You can use any AI of your choice to make whatever changes you want. But if you strictly want to fix any bugs you encounter, I've built a "Bug Report" feature directly into the lobby client under Settings -> Telemetry, which you can use to manually report bugs/crashes to me. So there's no need for you to go through the trouble of patching things yourself or setting up a development environment unless you're explicitly interested in tinkering.

With all of that out of the way, I'd highly recommend giving it a try! And feel free to update me to share your experience or if you have any other questions.
+0 / -0
13 days ago
Ive been using it for the past day,a nd it works great! No issues so far, the only thing that I noticed that differs so far is that constructing is a laser line now instead of the colored clouds I usually see. Apart from that, smooth sailing! TAW works, coop works, bots work, FFA works, everything works. No glitches or problems as of yet. Very good mod! Id say its a success overall :D Tysm for making it! I recently had to get rid of my windows machine and I was worried I was gonna lose Zerok and then lo and behold, you show up after 2 years with a working MAC port.
+1 / -0
12 days ago
You can switch from the beam effect back to the cloud effect in the Graphics settings within the lobby. And I'm really happy that it's been working smoothly for you! Feel free to let me know if you have any more feedback.
+0 / -0