Project Viewpoint QOL

Project Viewpoint QOL

A quality-of-life companion for Project Viewpoint: seamless mouse control, one-key looting, inventory actions and hotbar cycling for first-person play.

This Workshop item also includes two optional sub-mods: Controller Support (works without QOL) and Project Viewpoint QOL Legacy 0.1.6 for Viewpoint 0.1.6.1.

[hr][/hr]

QOL Features

• Mouse unlock/re-lock: Viewpoint owns inventory cursor handling; QOL frees the cursor for managed menus, appliances, maps and crafting, and locks again when they close.
• Smart Cursor Lock: Viewpoint's cursor key returns to camera look while keeping panels open; native key follows rebinds.
• Hotbar Cycling (Shift + Wheel): cycle equipped hotbar weapons and tools, including while sprinting.
• 1-Key Equip & Read (Z): equip weapons, clothing and bags, or read books and magazines from containers or the ground; multi-slot items open a placement chooser.
• Loot Destination (V): send grabs and loot to your inventory or an equipped bag; the current destination appears in the loot hint.
• Loot Menu Toggle (/): hide or show Viewpoint's crosshair loot menu; syncs with Viewpoint's own option.
• Store All: hold the All Containers key (default left bracket) to move your inventory into the open or aimed container; favorites, keys, equipped and hotbar items are protected.
• Loot All Protection: keep favorites and keys out of Viewpoint's and the loot window's Loot All (off by default).
• See All Nearby Containers: tap left bracket to show loot from every container in the vanilla loot radius, grouped by container; tap again for the aimed one; hold to Store All.
• 1-Key Ingest & Smoke (Z): smoke, take pills, or choose a Quarter/Half/All portion for food and drinks (detects lighters).
• First-Aid Alert & Treatment (Z): injury HUD prompt; bandage, disinfect or suture from medical loot (shares the Item Action key).
• Container Crafting (B): hover an ingredient and press B to open Crafting pre-filtered to recipes using it; works with vanilla and Neat Crafting.
• Ammo & Magazines (Z): unpack ammo boxes and load carried magazines and shotguns from container loot (shares the Item Action key).
• Hands-Free Auto-Walk (. or Right Alt + Forward): walk forward while steering with mouse look; any movement key or damage cancels it.
• Auto-Open Doors & Gates: jog or sprint into a closed, unlocked door or gate to open it without slowing down; locked doors still stop you.
• Fast-Forward While Auto-Walking: keep your fast-forward speed while auto-walking; manual movement and Shift/Sprint drop to normal, or use the optional manual mode with nearby-zombie slowdown and tunable radius.
• Third-Person Strafing (optional): honor Viewpoint's Strafe setting in third person; strafe and backpedal with the character turning with the camera.
• Panini in First Person Only: keep Viewpoint's Panini projection in first person and turn it off in third person.
• Independent Camera Zoom: wheel zooms third person smoothly by moving Viewpoint's camera distance; fully in switches to first person. Works on foot and in vehicles; CTRL + wheel adjusts FOV.
• Classic Camera Toggle: removes follow-camera float, camera sway and automatic shoulder swap; restores your previous values when disabled.
• Disable Extra Camera Effects: removes reaction camera moves such as bite push-in, knockdown dip, death cam and climb/getup shifts.
• Panel Suppression: suppresses character health/info panels, the Crafting menu and safety toggles during container actions.
• Notifications: turn QOL popup messages on or off; the injury alert HUD keeps its own toggle.
• Full Options Support: every setting lives in Viewpoint's QOL tab (DELETE) and Options -> Mods -> Project Viewpoint QOL, always in sync.
• Optimized Updates: smoother idle and placement updates with less repeated work.

Requirements

• Project Viewpoint 0.1.7 release or nightly (other versions disable the mod with an on-screen message). For 0.1.6.1, enable only Project Viewpoint QOL Legacy 0.1.6.
• ZombieBuddy (Java bridge, cursor control, fast-forward keep-alive)

Installation

Enable ZombieBuddy, Project Viewpoint and Project Viewpoint QOL in your Mods list.

For Viewpoint 0.1.6.1, disable all current QOL sub-mods and enable only Project Viewpoint QOL Legacy 0.1.6. Current and legacy sub-mod sets are mutually incompatible.

Load order: place this mod after ZombieBuddy and Viewpoint (declared automatically); the mod retries the Java bridge automatically and recovers from a wrong order without a restart.

Multiplayer & Dedicated Servers

This is a client-side mod: servers run none of its code. Servers do not need to install it - enable ZombieBuddy, Viewpoint and this mod on your PC and they load on any server; the client adds the required mods to the session's list.

• On every player's PC: enable ZombieBuddy, Viewpoint and this mod, complete ZombieBuddy's one-time setup, then approve this mod's JAR when prompted (re-approve after updates - ZombieBuddy pins the JAR hash).
• Optional server setup: adding the mods to the server .ini auto-installs them for every player:
• [code]Mods=ZombieBuddy;Viewpoint;ProjectViewpointQOL
• WorkshopItems=3619862853;3809306528;3811256204[/code]
• Troubleshooting: check console.txt for ProjectViewpointQOL log lines. If the bridge warning appears, hold Shift during load to force ZombieBuddy's approval dialog, tick Allow and restart.