The short answer
Project Viewpoint does not work out of the box on Apple Silicon Macs (M1, M2, M3, M4 and M5): the game crashes when the world loads. To play it on your Mac, subscribe to VPMac on Steam along with its three requirements, approve VPMac in ZombieBuddy's window and restart the game once. That's it.
Why Project Viewpoint doesn't work on Mac
Project Viewpoint (the first person 3D camera mod for Project Zomboid B42) uses OpenGL 4.2 to 4.5 functions. macOS stopped at OpenGL 4.1, which on Apple Silicon Macs runs on top of Metal. When Viewpoint calls a function the Mac doesn't have, the game crashes; and some shaders make Apple's Metal shader compiler crash or hang.
VPMac rewrites Viewpoint in memory while the game loads: it swaps those calls for versions that work on OpenGL 4.1 and fixes the problem shaders with the same result. The Viewpoint files you got from the Workshop are never changed.
Requirements
Subscribe to all three (and to VPMac):
- ZombieBuddy, installed following its own guide.
- Project Viewpoint.
- Project Viewpoint - Patch for Mac, by xiveboy.
Important: do NOT run the "Patch for Mac" installer. Being subscribed is enough: VPMac only reads its files. If you used it before, undo it first with the installer's restore option.
How to install it, step by step
- Subscribe. Subscribe to VPMac and its three requirements on the Steam Workshop.
- Enable VPMac. In the game's mod list, enable VPMac. Its requirements are enabled with it.
- Approve it in ZombieBuddy. Start the game. ZombieBuddy asks you to approve VPMac: approve it.
- Restart once. Close and reopen the game. Done: first person works. Updates arrive through Steam.
Which Macs does it work on?
VPMac is made for Apple Silicon Macs: M1, M2, M3, M4 and M5 chips, including Pro, Max and Ultra, on MacBook Air, MacBook Pro, iMac, Mac mini and Mac Studio.
To be honest: it was tested in depth on a MacBook Air M5 with macOS 26.5.1. Other Apple Silicon Macs should work the same, since they all use the same OpenGL 4.1 over Metal, but your reports are how we confirm it. Intel Macs are not tested.
Performance: +75% FPS
Translating OpenGL has a cost, so VPMac brings its own accelerators (batched draws, no synchronous GPU readbacks, smarter texture packing). On a MacBook Air M5 in first person the game goes from 30 to 53 FPS (+75%) with all of them on. The measurements are in the repository.
If the game crashes or freezes
The next time you start the game, a window says your last session ended badly and offers a ready report. Click Copy short report, paste it in Discussions › Bug reports and say what you were doing (first person? driving?). The report is also saved in ~/Zomboid/vpmac/reports/.
Nothing is sent automatically: reports stay on your Mac until you paste them, and your user name and Steam IDs are hidden.
FAQ
Does Project Viewpoint work on Mac?
Not out of the box on Apple Silicon Macs: macOS only has OpenGL 4.1 and Viewpoint needs 4.2 or newer, so the game crashes. With VPMac it works.
Does it work on an M1, M2, M3 or M4 Mac?
It should: every Apple Silicon Mac uses the same OpenGL 4.1 over Metal. It was tested in depth on an M5; if you have another chip, tell us how it went on the Steam page.
Do I need to run the "Patch for Mac" installer?
No. Just subscribe to it: VPMac reads its files. If you already ran it, undo it with its restore option.
Does VPMac change my game or Viewpoint files?
No. It makes its changes in memory while the game runs; the Workshop files stay untouched.
What is the difference with xiveboy's "Project Viewpoint - Patch for Mac"?
VPMac uses xiveboy's work (his bridge and OpenGL shims) and adds what was missing for newer Viewpoint versions, shader fixes and FPS accelerators, with no installer. It is an alternative, not a competitor.
Is it free? Is it official?
It is free and open source (MIT license, on GitHub). It is not official: it is not endorsed by the Project Viewpoint authors.
Credits and transparency
Project Viewpoint belongs to ellu and norkus. The Mac bridge and shims are by xiveboy, who allowed anyone to modify and publish his patch. ZombieBuddy is by Zed. VPMac was built 100% with AI (Claude), directed and tested by Wenopal, and everything it does is public on GitHub.