Client-side mod for Project Zomboid (Build 42.21) that automatically tunes Project Viewpoint's settings for optimal FPS, with step-by-step measurement and in-game diagnostics.

Viewpoint FPS Optimization v10.11.2026 · ModsFire, 230.9 КБ · 23 downloads
Contents

Viewpoint FPS Optimization is a client-side mod for Project Zomboid (Build 42.21) designed to automatically optimize performance by adjusting Project Viewpoint's own settings in real time. It measures the effect of each change on frame time and reverts any that do not improve performance.

Key Features

  • Adaptive tuning of 31 Viewpoint settings across CPU and GPU, including chunk build budgets, cooking, chunk walks, far-world jobs, floor and ground bake pages, GPU upload pacing, far reach, LOD bands, tree share, texel density, character animation rate, and corpse posing.
  • Step-by-step verification: Each adjustment is measured against the previous frame time. If no improvement is detected, the change is rolled back and that optimization path is paused. After three unsuccessful attempts, the mod stops and reports where frame time is actually spent.
  • Spike vs. sustained lag detection: Distinguishes between brief hitches (such as chunk-building or loot-menu spikes) and ongoing performance issues.
  • Viewpoint loot menu toggle: Option to disable Viewpoint's aiming loot list, which is a major source of single-frame spikes (30-50 ms); disabling reverts to the game's default loot window.
  • Viewpoint presets: Quickly apply presets from Potato to Extreme, with adaptive tuning layered on top.
  • In-game FPS cap and UNCAP options.
  • RAM/VRAM pool scaling and live memory statistics.
  • Diagnosis tab: Shows the proportion of frame time spent on Viewpoint, world capture, and the base game.
  • F12 panel and Alt+F9 overlay: Both interfaces are polled within the frame loop to prevent key conflicts with other mods. Esc closes the panels.
  • Optional CSV benchmark export.
  • Compatibility: Works with PZ_Optimization (its F9 overlay remains unaffected). If a Viewpoint setting is missing, it is skipped without causing errors.

Requirements

  • ZombieBuddy
  • Project Viewpoint

Installation and Usage

  1. Enable mods in this order: ZombieBuddy, Viewpoint, then Viewpoint FPS Optimization.
  2. Approve the JAR in ZombieBuddy if prompted.
  3. In game, use O for first person, F12 for the panel, and Alt+F9 for the overlay.

Controls

  • F12 panel (rebindable)
  • Alt+F9 overlay (rebindable)
  • Esc closes the panel

F8/F9/F10/F11 are intentionally avoided due to conflicts with vanilla controls and other mods.

Settings and Logs

  • Adjust settings via Options > MODS > Viewpoint FPS Optimization, the F12 panel, or by editing Zomboid\vpfps.properties (hot-reloads in about 5 seconds).
  • Log file: Zomboid\Logs\vpfps.log
  • This mod is client-side only and does not require server installation.

Diagnostic Information

If frame time does not improve when Viewpoint settings are lowered, the issue is not with Viewpoint. The Diagnosis tab will indicate where the performance cost lies, and the mod will stop making further changes to avoid unnecessary quality loss. Common causes include high zombie counts, heavy mod content, large save files, limited CPU cores, or existing frame caps.

Add to collection Report