Upgrading from Voxel Play 3

Getting the upgrade price

Voxel Play 3 owners are entitled to a special upgrade price for Voxel Play 4 on the Unity Asset Store.

• Sign in to the Unity Asset Store with the same account you used to buy Voxel Play 3.
• Open the Voxel Play 4 store page. The discounted upgrade price is shown automatically for eligible owners - there is no coupon code to enter.
• The discount is applied at checkout. As a major-version upgrade, your Voxel Play 3 purchase is recognized by the store.

Technical compatibility with Voxel Play 3 projects

Voxel Play 4 is built on the same foundation as Voxel Play 3 and shares the same VoxelPlay namespace and the same asset data model, so an existing Voxel Play 3 project can be upgraded to Voxel Play 4. Most of the work is meeting two new platform requirements; the rest is reviewing a handful of behavior changes.

What carries over

Your existing assets keep working. Voxel Play 4 preserves the script identities of the core types, so your World Definitions, Voxel Definitions, Biome Definitions, Model Definitions, Item Definitions and terrain generators keep their references after the upgrade; new Voxel Play 4 fields simply take sensible defaults. Because the public VoxelPlay API is carried forward, most custom C# scripts compile without changes.

Two requirements to meet first

• Unity 6: upgrade the project to Unity 6 before importing Voxel Play 4.
• URP: if your project used the built-in render pipeline, switch it to the Universal Render Pipeline (add a URP asset and convert your materials). Projects already on URP only need the Unity 6 step.

Behavior and API changes to review

These are the main differences that may affect an existing project after the upgrade:

• Structural Collapse is on by default. Destroyed voxels now bring down unsupported structures (the Collapse On Destroy World Definition switch). For the classic "the voxel just disappears" behavior, turn it off. The old Fragile flag is replaced by per-voxel Collapse Behavior and Max Debris Size.
• Biomes use three axes. BiomeZone now adds a temperature range alongside altitude and moisture, plus new fields (per-biome shore voxel, global geological layers). Existing biomes keep working; set the new fields when you want the new behavior.
• Terrain is unchanged unless you opt in. Your classic terrain generators still work. The new 3D Terrain Graph is optional; a built-in converter migrates a classic world to a graph if you want smooth terrain, caves, floating islands, super chunks or graph-driven water.
• Assemblies were split. Voxel Play 4 uses several assembly definitions instead of one. If your own scripts have assembly definitions that reference Voxel Play by assembly name, update those references.
• A few renames. For example, the environment's Obscurance Mode is now Sunlight Curve. The API is mostly additive; see What's New in Voxel Play 4 for the full list.
• Shaders and materials are URP. Any materials left over from a built-in setup must be reassigned to the Voxel Play 4 (URP) shaders.

Recommended migration steps

1. Duplicate or back up your Voxel Play 3 project.
2. Open the copy in Unity 6.
3. If the project used the built-in pipeline, switch it to URP.
4. Delete the old Assets/Voxel Play package folder, then import Voxel Play 4 (a clean import avoids leftover renamed files). Your own world and voxel assets, which live in your project folders, keep their references because the script GUIDs are unchanged.
5. Let Unity recompile, open your world, and review the items above (collapse, biomes, materials).
6. Test thoroughly on the copy before adopting it as your main project.