An unofficial update of Viewpoint True Ballistics for Project Zomboid 42.22 and Project Viewpoint nightly 0.1.7 (RC4), bringing realistic projectile simulation and multiplayer support.
Contents
The True Ballistics Unofficial Update is an adaptation of Bluesky’s Viewpoint True Ballistics mod for Project Zomboid 42.22 and Project Viewpoint nightly 0.1.7 (RC4). This update ensures compatibility with the latest game and Viewpoint versions, maintaining all original features, physics, and design by Bluesky. It uses the same mod ID as the original, so server mod lists and add-ons remain functional. Only one version should be active; unsubscribe from the original to avoid conflicts.
Key Features
- Real projectile simulation: Every shot is individually simulated from the gun’s muzzle to the crosshair point, both in first and third person. Projectiles take time to arrive, experience bullet drop, break glass, stop at walls, and hit the actual body part they contact.
- Travel time and bullet drop: Rounds slow down and fall over distance. Players must compensate for long shots or adjust their sights.
- Cover and obstacles: Walls, closed doors, cars, trees, and solid furniture stop projectiles. Glass breaks, allowing rounds to continue. If the barrel is behind an obstacle, the obstacle is hit, regardless of camera angle.
- Precise hit locations: The mod determines the exact body part struck, wounding that specific area for players (down to hands and feet). Zombies receive damage based on vanilla head/torso/limb logic.
- Penetration: Rifle rounds with sufficient energy can pass through one body and hit another behind it.
- Shotgun mechanics: Each pellet is a separate projectile.
- Skill-based accuracy: Aiming level, weapon accuracy, movement, moodles (panic, stress, tiredness, drunkenness, pain), and weapon condition all influence shot grouping.
- ADS & Optics support: With Project Viewpoint ADS & Optics, rounds follow the real sight line, including recoil. Each sight uses its own zero, and spread is tighter when aiming down sights.
What Remains Vanilla
- Ammo, chambering, jams, reloads, sounds, noise, recoil, muzzle flash, Aiming XP, weapon condition, damage rolls, critical hits, armor, and hit reactions. Modded guns work without patches, using their ammo type for ballistics.
Update Changes (1.4.7 - 1.4.8)
- Updated for Project Zomboid 42.22 (firearm hit networking and methods changed).
- Multiplayer support for 42.22: one hit packet per shot, sent when the round lands. Placed items on the floor can be shot in multiplayer.
- Server-side (ZombieBuddy required): Player projectile hits are not re-rolled for hit chance; headshots can knock off helmets; wounds and damage are applied to the exact hit part. Failed line-of-fire checks result in a miss.
- Viewpoint 0.1.7 (RC4) supported.
- Smaller aim ring (half real spread by default); adjustable in Options > MODS > True Ballistics Unofficial Update > Aim ring size.
- Fixed two single-player crashes in 42.22.
Requirements
- Java mod loader (must be installed into the game; see its page)
- Project Viewpoint nightly 0.1.7 / RC4
- Project Zomboid build 42.22
- Optional: Project Viewpoint ADS & Optics
Multiplayer Server Setup
For full functionality in multiplayer, including server-side hit validation and extended range, the server must run ZombieBuddy:
- Copy ZombieBuddy to the server: - From the ZombieBuddy mod’s libs folder, copy ZombieBuddy.jar (Linux) or ZombieBuddy.jar and zbNative.dll (Windows) to the server’s main folder.
- Configure the server:
- Edit ProjectZomboid64.json in the server folder. Add the appropriate line to the "vmArgs" list:
- Linux:
"-javaagent:ZombieBuddy.jar=policy=allow-all", - Windows:
"-agentlib:zbNative=policy=allow-all",
- Linux:
- Add mods to server settings: - Add the required WorkshopItems and Mods entries, including this mod’s Workshop ID.
- Verify setup: - The server console should display loading messages for True Ballistics and ZombieBuddy. Players’ console.txt should confirm full ballistic range is enabled.
Sandbox Options ("Viewpoint True Ballistics" page)
- Global velocity scale (default 0.4): 1.0 = real speeds, almost no visible drop. Lower values increase visible travel time and drop.
- Max projectile distance (default 3x weapon range, cap 200 m). 5x covers the loaded world.
- Spread scale (default 1.0): lower for tighter groups.
- Zero distance, Gravity, Drag, Damage falloff, Penetration, Hit locations, Furniture collision, Server hit validation, Use in isometric view.
Note: The game only loads about 75 tiles around each player; projectiles cannot hit beyond this range.
Console Commands (debug mode)
VTB_status()- Shows mod status.VTB_debug("trajectories", true)- Draws projectile trajectories.VTB_tracers(1)- Makes every round a tracer.VTB_ringSize(0.4)- Sets aim ring size.
Compatibility
- Do not use with other mods that replace firearm hit detection.
- Gun packs with custom ammo names are recognized by calibre; authors can fine-tune values via VTB.registerAmmoProfile / VTB.registerWeaponProfile.
- Compatible with OneShotOneKill and Viewpoint Line of Sight mods.



Comments 0
No comments yet — be the first.
Log in or sign up to leave a comment.