Project Viewpoint on The Citadel
Project Viewpoint is a **client-side** Build 42 mod that replaces the vanilla isometric camera with true first person, third person, and free-look. The Citadel does **not** need it installed on the server. You run it on your own PC, then join Knox County like normal.
What it is
- Mod: Project Viewpoint (Workshop ID
3809306528, mod IDViewpoint) - Loader: ZombieBuddy (required Java framework)
- Optional pack: 3D furniture / prop models for Viewpoint (Voxel Studio pack)
- Scope: Your client only. Other players do not need it. The server does not list it.
- Version window: Built for Project Zomboid 42.21. Mismatch builds can load Lua and still do nothing in 3D.
How it works (short version)
- ZombieBuddy loads as a Java agent when the game starts (
zbNativeon Windows). - Viewpoint ships a signed Java jar. ZombieBuddy asks you to approve it once.
- Lua scripts handle menus, keys, and multiplayer UI glue.
- When you join The Citadel, the server mod list stays empty of Viewpoint, that is expected. Viewpoint still injects its client files so O works in MP.
⚠ Safety and disclosure
Read this before you install anything.
Java mods are not sandboxed like normal Lua mods. ZombieBuddy and Viewpoint run with full access to the game process. In principle a malicious Java mod could touch files outside the game, open network connections, or run arbitrary code. That is true of any Java loader ecosystem, not only this one.
The Citadel staff recommendation:
- Only install ZombieBuddy and Viewpoint from their official Steam Workshop pages (or the author's GitHub releases for ZombieBuddy if Steam fails).
- When ZombieBuddy shows the approval dialog, check the mod id, path, and SHA-256 hash. Click Yes only if you trust the source.
- Do not replace
ZombieBuddy.jarwith random "fix" jars from Discord unless you understand what you are installing. Official ZombieBuddy 2.3.4+ already supports Build 42.21. - Staff cannot audit every third-party Viewpoint add-on. Extra Java packs (doors, trees, ballistics, etc.) are at your own risk and can break after Viewpoint updates.
- This guide is not a warranty. If you run on older hardware, expect crashes. Lower settings first.
Install (Windows)
1. Subscribe
Subscribe on Steam Workshop:
- ZombieBuddy
- Project Viewpoint
- Optional model pack linked from Viewpoint's page (large download)
Launch Project Zomboid once so Steam finishes downloads, then quit.
2. Install the ZombieBuddy loader (one time)
Subscribing alone is not enough.
- Easiest: run
ZombieBuddyInstaller.exefrom the ZombieBuddy GitHub releases and choose Install or update. Prefer patching Both launch modes. - Manual: copy
ZombieBuddy.jarandzbNative.dllfrom the Workshop mod'slibsfolder into your game folder (…\steamapps\common\ProjectZomboid\), and ensureProjectZomboid64.jsonvmArgsstarts with-agentlib:zbNative.
You should see a ZombieBuddy watermark on boot.
3. Enable mods
Main menu → Mods → enable in this order:
ZombieBuddyViewpoint- Model pack (if used)
Save the preset. Restart the game.
4. Approve Viewpoint
On the next launch ZombieBuddy prompts for Viewpoint's jar. Choose Yes, then allow it to remember the decision.
Watermark should list Viewpoint | not "No active java mods".
5. Join The Citadel and finish setup
- Connect to The Citadel as usual.
- When Viewpoint's setup wizard appears, pick Low if your card is modest. Enable texture compression if asked, then restart if it requires it.
- Press O for first person. Shift+O cycles third person. Delete opens settings.
- Turn Terrain relief off under World / Detail if the ground stuttering is bad.
Default keys
| Key | Action | | --- | --- | | O | Toggle first person | | Shift + O | First / third person | | Delete | Viewpoint settings | | Middle mouse | Show / hide cursor | | Mouse 4 | Free look |
Rebinds live under Viewpoint's options if your layout differs.
Multiplayer notes for The Citadel
- Viewpoint is allowed as a client-only visual mod for personal use. It does not grant items, speed, or ESP.
- The server will not list Viewpoint in its required mods. That is correct.
- If something breaks after a hotfix, unsubscribe/resubscribe Viewpoint, keep ZombieBuddy 2.3.4+, and re-approve the jar.
- Do not mix Viewpoint with pz3d. Pick one 3D camera stack.
Staff position
The Citadel documents this mod so survivors stop learning it from ten conflicting Discord threads. We do not require it. We do not install it server-side. You install it at your own risk, keep your hardware honest, and keep Java approvals intentional.
Stuck on a step? Got questions? We'll help you out in Discord: #support , be sure to provide as much as details as you can!