# Viewpoint Better Terrain 0.3.24

Physical hills, valleys, gentle urban slopes, rigid building foundations and rural road profiles.
Requires Windows x64 or Linux x64, Project Zomboid 42.21 with its bundled Java 25, Project Viewpoint and ZombieBuddy >=2.3.0.
The Java physics bridge checks the supported PZBullet library fingerprint and refuses unsupported builds.

Install: subscribe, enable the mod and its dependencies, approve the Java mod if prompted,
then fully restart PZ. Launch from Steam normally. Standard-map feature data is included;
no developer directories, companion DLLs or separately generated files are required.

This replaces the earlier visual-only implementation with geometry and native collisions.
Back up saves before upgrading. Physical multiplayer and custom maps are not validated.
Shader-pack compatibility depends on the Viewpoint/Iris pipeline and the individual pack.
The earlier DEL slope slider is not provided by this physical release.
Optional Viewpoint - Grassier Grass Port support covers native and Iris grass rendering,
including mown grass and clippings. Grassier Grass is not required by Better Terrain.


Prepared terrain: the package includes terrain-plan.bin for default settings. It is
checked against the map fingerprint, terrain revision and amplitude. Custom settings
are cached in Zomboid/physical-terrain/cache; missing or invalid data is recalculated.
This cache does not contain saves, native pointers or mutable building objects.

Optional configuration: Zomboid/physical-terrain/lab.properties. Omit it for defaults.
To customize, use physicalTerrain=true and amplitude=24 (supported range 0..24).
Existing development configurations may also override mapFeatures and gameRoot; ordinary
Workshop subscribers do not need these paths. Restart after changes.

Uninstall: disable the mod and fully restart PZ. Remove duplicate local copies with the
same ID if they still load. Keep a save backup; do not assume vehicle positions are safe
when switching between physical terrain and a flat world. No map-save tiles are rewritten.
Troubleshooting: check Zomboid/console.txt for [ViewpointBetterTerrain] and ZombieBuddy errors.

Credits: Project Viewpoint, ZombieBuddy and their respective authors. Implementation and
release preparation assisted by OpenAI Codex. Included terrain descriptors are derived
water/building/road bounds for the standard map; no game binaries or textures are included.
No additional redistribution license is granted by this package.
BloodFX support is automatic when that optional mod is installed. Restart the game after updating Better Terrain. The BloodFX JAR is not modified or redistributed.

Compatibility credit: BloodFX and its author. BloodFX is an optional, separate Workshop subscription (3811472160).

Linux support targets the original PZ 42.21 Bullet 1.0.0.28 x64 libraries (client and NoOpenGL). Native physics tests cover both; a complete rendered Linux game session remains to be verified. Unsupported native fingerprints are rejected explicitly. The mod uses the game's own library; no native binary is bundled.


Optional Viewpoint True Ballistics 1.4.6 support: terrain-aware aiming, projectile flight,
world, body and vehicle hits, and tracer rendering. True Ballistics is not required.


