Project Viewpoint: install, switch camera views and fix loading

Check which mod you actually installed

Project Viewpoint is Workshop item 3809306528, mod ID Viewpoint, and lists ZombieBuddy as required. “Project Zomboid Viewpoint” and “Project Viewpoint mod” refer to this same setup. Match the numeric item ID when following a search result.

Source: Project Viewpoint · author Workshop page · Mod author instructions

PZ3D is a different project

PZ3D is the separate Workshop item 3807334881 by kolpaque. Its 0.6.0 description introduces its own pz3d Loader and lists Insert as its 3D toggle. Those loader files and that key are not Viewpoint instructions.

For a first diagnostic run, choose one camera mod. If you previously changed launch options for PZ3D, keep a copy of them and follow that project’s own removal instructions before testing Viewpoint alone. Do not combine loader recipes just because both videos show a first-person camera.

Source: pz3d · author Workshop page · Separate mod author instructions

Prepare a small, reversible test

These are preparation checks, not claims that a new world makes every mod safe or compatible. Java addons can run code outside the game; approval should be a deliberate choice about the author and file you obtained.

1. Record the exact game patch shown in your menu, operating system, Normal or Alternate Launch choice, and installed mod versions. Keep those details together.
2. Back up the save you care about while the game is closed. Use a separate new test world with only the required mods for the first camera check; leave your established mod collection for later.
3. Confirm that the unmodified game reaches its menu. Preserve existing launch options and any launcher files you intend to edit so you can restore the previous configuration.
4. Open the author Workshop pages linked below in Steam, check their current dependencies, and let downloads finish. A missing item directory is a download/path problem to solve before copying anything.

Source: ZombieBuddy · GitHub README · Framework author documentation

Install and verify ZombieBuddy first

A framework loading is only the first checkpoint. It does not prove that Viewpoint’s Java code was accepted or that the camera can render a scene.

1. Use the ZombieBuddy guide linked at the end of this page for the operating-system-specific installation. Workshop subscription alone does not finish the loader setup.
2. Enable the dependency in the game mod manager, completely close the game, then launch through the method you configured.
3. During loading, look for the ZombieBuddy version indicator. If it never appears, work through the loader guide before changing Viewpoint graphics or keybindings.

Source: ZombieBuddy v2.3.4 · installation guide · Versioned author documentation

Do you still need the temporary 42.21 fix?

ZombieBuddy v2.3.4 was released on 3 October and explicitly backports fix #56. Therefore, the older advice to install a community temporary fix is not a universal requirement for a current setup. Start by comparing the version actually loaded by the game with the current author release.

Do not overwrite a newer official loader with a JAR from an old video simply to match its screenshot. If you previously used a replacement, record its origin, preserve your rollback copy, and return to a consistent author-supported installation before adding more patches.

Source: ZombieBuddy v2.3.4 · release · Framework author release

Enable Viewpoint and complete the first launch

The author added a setup wizard and configurable keybindings in the 30 September update. That means a current installation may differ from the first release shown in a tutorial.

1. Subscribe to the exact Viewpoint item and wait for the download to finish. In the game, enable Viewpoint with its dependency for the test setup; when using an existing save, inspect that save’s mod selection too.
2. Fully exit and restart. If the loader asks about Viewpoint, compare the displayed mod and file location with what you intended to install before deciding whether to allow it.
3. Enter the test world and finish any setup dialog shown by your installed release. Record the settings selected rather than changing several options at once.
4. Try the camera controls below. Confirm that you can return to the ordinary view, move, turn, open an inventory and interact with an object before trying your main save.

Source: Project Viewpoint · author change notes · Mod author release notes

Switch first person, third person and cursor mode

Test normal movement before free-camera modes. If a shortcut conflicts with your game controls, inspect your installed Viewpoint key settings and assign an unused combination. A key from another camera mod is not a useful loading test.

Source: Project Viewpoint · author Workshop page · Mod author instructions

Choose a shader without losing your baseline

The published settings offer Vanilla, Default and Vivid looks; custom packs go in Zomboid\viewpoint-shaderpacks. Start with Vanilla, then change one effect or preset at a time.

1. Stand in the same place and note the preset, resolution and visible problem before changing a setting. Compare the same scene after the change.
2. If a custom pack produces missing surfaces, severe flicker or an unusable frame rate, return to the built-in preset that previously worked. Restart the test if the result is unclear.
3. Keep the default working configuration available while trying optional addons. A shader change should not be used to repair a loader that never started.

Source: Project Viewpoint · author Workshop page · Mod author instructions

Treat Minecraft shader support as experimental

The 30 September author notes label Iris shader compatibility experimental. That is not a promise that any Minecraft shader ZIP will work. Follow the current Viewpoint pack instructions for the exact file you choose; avoid converting a failed experiment into your only working configuration.

The same update changed rendering and input behavior, followed by two 1 October hotfixes. When a video and the installed UI disagree, check the author’s Change Notes first.

Source: Project Viewpoint · author change notes · Mod author release notes

Diagnose the stage that failed

Upstream #56 documents a concrete 42.21 loader mismatch that could prevent Java mods from loading. Its original validation was code-level matching, not an in-game boot; this site has not independently tested the released correction.

Source: ZombieBuddy #56 · Build 42.21 loading fix · Upstream fix discussion

Recover from a blocked or mismatched Java file

A signature failure is a file identity/integrity problem to investigate. Obtain the JAR and any accompanying signature together from the author’s current distribution. Do not pair a replacement JAR from a comment with an unrelated signature or enable every Java file just to silence a message.

If you chose Deny by mistake, use the ZombieBuddy approval instructions to revisit that specific decision. Keep unrelated approvals intact. A valid signature identifies the signing key and file; it does not certify that an addon is harmless or compatible.

Source: ZombieBuddy v2.3.4 · mod signing · Versioned author documentation

Return to the original view or remove the setup

1. If the camera is still responsive, use your configured view toggle to leave 3D mode. If necessary, quit from the game menu.
2. Disable Viewpoint and optional Viewpoint addons in the test setup, then restart. Leave ZombieBuddy installed if other deliberately enabled mods need it.
3. To remove the loader too, follow the ZombieBuddy uninstall sequence: undo its launcher injection before deleting its loader files. Unsubscribing alone does not undo a copied loader or launcher edit.
4. Reopen the separate baseline world and confirm that the menu and ordinary view work again. Restore an affected save from your pre-test backup if needed; removing a mod is not proof of save repair.

Source: ZombieBuddy · uninstall guide · Current author removal instructions

What to include in a useful bug report

Capture one reproducible sequence, the game patch, loaded ZombieBuddy version, Viewpoint item/version, operating system, launch method, GPU, preset and optional mods. Add the relevant Viewpoint lines from Zomboid\console.txt and an actual screenshot if the symptom is visual. Review logs for private paths or server details before posting.

If Steam cannot display or download an item, open the exact author link inside the Steam client and check the author’s current notices. A search extractor’s removed/incompatible banner is not enough evidence of an actual takedown; do not substitute an unverified mirror.

Source: Project Viewpoint · author Workshop page · Mod author instructions