Voxel Play Environment Options

Modified on Tue, 8 Jul at 1:11 AM

Select your Voxel Play Environment in the hierarchy to show the current environment options:



The Voxel Play Environment script allows you to customize general gameplay settings, quality and effects, voxel generation as well as the sky properties.


Note that you can define any number of worlds separately (see Creating Worlds section) and assign one of them to the Voxel Play Environment component.


Also, you can customize any of these properties from script using VoxelPlayEnvironment.instance.property = xxx.



World Settings



  • In this section you can edit allthe options that control the generation behaviour of your environment. Add detail generators, biomes,control sky appearance and lighting, define water properties plus other additional voxel effects, each with their oun controls.


Terrain Settings



  • Control the terrain generation options, its height, size, altitude differences and much more. For detailed setp by step guide on how to setup a terrain from scratch follow this video:



World Editor



  • File: In this section you can toggle on/off, delete, reset, export and finally load or save the generated chunks.
  • Structs: Create predefined structure elements.
  • Terrain: Access tools to start building and editing the terrain, like raise or lower, smooth, reset, add rivers, vegetation or trees.
  • Sculpt: Access sculpting tools to modify your terrain shape at will.
  • Other: Additional tools to have more control over positioning and other important stats.


Voxel Generation



  • Enable Generation: Enables/disables world/voxel generation updates.
  • Chunk Pool Size: Number of total chunks allowed in memory.
  • Chunk Size: Total size of chunk.
  • Microvoxel Size: Size of the microvoxels based on the total size of the chunk.
  • Microvoxels Snap: When enabled, microvoxels space will snap to nearest microvoxel position.
  • Only Render in Frustum: When enabled, only chunks inside the camera frustum will be rendered.
  • Multi Thread Generation: When enabled, uses a dedicated background thread for chunks generation (only in build, deactivated when inside Unity Editor)
  • Visible Chunks Distance: Distance of the visible chunks based on their number.
  • Force chunks distance: Distance measured in chunks that will be rendered completely before starting the game.
  • Max CPU Time per frame: Maximum milliseconds that can be used by the CPU to generate the world.
  • Colliders: Enable/disable collider generation for opaque objects.
  • Navmesh: Enable/disable navmesh generation.
  • Hide Chunks in Hierarchy: Disable chunk visibility in hierarchy.
  • Trees: Enable/disable tree generation.
  • Vegetation: Enable/disable vegetation generation.
  • Detail Generators: Enable Disable World Detail Generation.
  • Particle Pool Size: Maximum number of active particles.
  • Particles Layer: The layer used by the particles.
  • Voxel Layer: Layer used by the voxels.
  • Clouds Layer: Layer used by the clouds. 


Shader Features



  • Preset: Select a set of predefined features.
  • Global Illumination: Enables Voxel Play's own lightmap computation that works at chunk level spreading the Sun and torch lights across voxel space.
  • Smooth Lighting: Interpolates lighting between voxel vertices producing a smoother transition between light and dark.
  • Obscurance Mode: Changes shader obscurance function (integrated AO).
  • Per-Pixel Lighting: If disabled, lighting will be calculated per vertex. Otherwise, lighting will be calculated per pixel which produces the most realistic results. Only use per-vertex if you need the maximum performace possible (ie. targeting old mobile devices).
  • Ambient Light: Minimum amount of light in the scene affecting voxels. The ambient light is configured in the Environment tab of the Unity Lighting window.
  • Shadows: Turn on/off shadows casting on voxels.
  • Realistic Water: Use realistic water shader with underwater fog, caustics and other effects.
  • Daylight Shadow Attenuation: Reduces shadow intensity when Sun is high.
  • Diffuse Wrap: Diffuse wrap factor. Simulates indirect lighting.
  • Normal Mapping: Enables use of normal maps. Disable if there're zero voxels using normals.
  • Relief Mapping: Enables parallax occlusion (relief mapping). Disable if there's zero voxels using relief mapping.
  • Physically Based Rendering: Enables use of PBR maps including metallic, smoothness and occlusion.
  • Texture Size: Texture size in multiples of 2.
  • Enable Tinting: Toggle individual voxel tinting.
  • Colored Shadows: When enabled you can customize shadow color in the world definition.
  • Outline: Enables outline on solid voxels.
  • Bevel: Enables bevel effect by tweaking top face normals.
  • Double Sided Glass: Renders both faces of transparent voxels.
  • Transparent Bling: Enables shining effect on transparent voxels.
  • Bright Point Lights: Improves appearance of point lights.
  • Curvature: Enables curvature vertex modifier on Voxel Play shaders.
  • See Through: Hides voxels between camera and desired target.
  • Origin Shift: Shift player to origin when its position passes a specific threshold.


Rendering Options



  • Compute Buffers: Enable compute buffers for custom voxels.
  • Instancing Culling Mode: Choose voxels occlusion culling mode.
  • Texture Sampling: Texture sampling filter mode.
  • Gaps/White Pixels Removal Options: This option tackle sub-pixel gaps which can lead to white pixels when underground in the dark. Voxel padding can cause some texture artifacts at the edges of voxels. Post processing produces the best result but it's slower.
  • Far Chunks Rendering: Enable rendering of far chunks.


Sky Properties




Common settings related to the sky shared by all worlds:

  • Sun: choose a directional light in your scene that represent the Sun.
  • Fog Amount, Fog Distance, Fog Falloff: controls the appearance of the fog in the scene. The fog produces a smooth transition between terrain and the far clip distance of the camera. You can configure additional sky properties in the World Definition file.
  • Enable Clouds: generates and animates random cloud voxel shapes.


Optional Game Features


  • Load Saved Game at Start: Load the file with a previous saved game.
  • Loading Screen: Display a loading screen with a custom text.
  • Initial Wait Time: Additional seconds to wait before loading the scene.
  • Enable Build Mode: Enables allowing build mode.
  • Enable Console: Enable/disable console in the scene.
  • Enable Status Bar: Toggle status bar on/off.
  • Enable Inventory: Enables inventory UI when pressing TAB.
  • Enable Debug Window: Enables debug window, pressing F2.
  • Show FPS: Display the fps count on screen.


Default Assets



  • Define the assets that will be used to generate the environment, like default voxels, UI prefab and much more.


Advanced & Stats



Access additional advanced features and control other display stats.


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article