<aside> <img src="/icons/reorder_gray.svg" alt="/icons/reorder_gray.svg" width="40px" />
Navigation
</aside>
<aside> 💡 A level scene holds the terrain and all objects of one level. It is loaded additively on top of the Game scene.
</aside>
A level scene has no camera, UI, GameController or launcher. These objects are in the Game scene and in the LevelSetup prefabs. Open Level together with Game to see the whole picture.

Every level scene needs one enabled instance of each:
| Object | Component | Purpose |
|---|---|---|
| Level Scene Controller | LevelSceneController |
Entry point for GameController. |
| Start Point | StartPoint |
Where the launcher and the character stand. Its forward axis is the run direction. |
| Finish Point | FinishPoint |
End of the level. The distance along the start forward axis is the level length used for the progress bar and the record. |
| Finish Wall | FinishWall |
Crossing it completes the level. |
StartPoint and FinishPoint draw gizmos in the Scene view: a green sphere with a forward line for the start and a red one for the finish.
Keep only one active StartPoint and one active FinishPoint per scene. GameController logs an error when none is found and a warning when several are found, and uses the last one.
| Field | Description |
|---|---|
| Chunk Size | Length in meters of one chunk along the world Z axis. |
| Active Chunk Radius | Number of chunks around the character that stay active. |
| Use Scene Environment | Makes the level scene the active scene, so its skybox, ambient light and fog are used instead of the Game scene settings. |
| Small Prop Cull Distance | Small props under the Props root stop rendering after this camera distance. |
| Small Prop Max Extent | Props larger than this are never culled. |
| Start Point, Finish Point | Read-only references, filled on scene save. |
The controller splits all IChunkActivatable objects into chunks by their world Z position. Only the chunks within Active Chunk Radius of the character chunk are active. The level must therefore run along the Z axis. The Bake Chunks button rebuilds the chunk list. The scene save does it automatically.
In the Scene view, chunk borders are drawn as lines: green for active chunks and gray for inactive ones.
When the scene is saved, the controller:
Save the level scene after moving the points or adding chunk objects. Without the save, the baked data is outdated. The LevelTests check that the baked references exist.
After the level scene is loaded, GameController calls LevelSceneController.Init(levelId). The controller calls InitSave(levelId) on every ISceneSaveObject in the scene, for example pickups. As a result, one scene can be reused by several Level assets and each Level keeps its own save data.
GameConsts defines the physics layers used by the level objects:
| Layer | Index | Use |
|---|---|---|
| Player | 10 | The character. |
| Pickup | 11 | Pickups. They collide only with the Player layer. |
| Obstacle | 12 | Obstacles. |
Lighting comes from the active scene. The Game scene is active by default. Enable Use Scene Environment on the Level Scene Controller to use the lighting settings of the level scene. The post-processing volume of the level is a regular Volume object in the level scene.
The wall dissolves from the crossing point when the character passes it. Crossing is detected as a change of the character side of the wall plane between two physics steps, so a fast vehicle cannot pass through it.
| Field | Description |
|---|---|
| Trigger Offset | Distance before the wall at which the level completes. |
| Size | Width and height of the wall. |
| Sink | How far the bottom edge goes below the ground. The wall is placed on the ground under its position at runtime. |
| Ground Mask | Layers used to find the ground. |
| Burst, Reveal, Dissolve, Clear values | Timing and radius of the dissolve animation. |
Place the wall on the Finish Point, facing along the run direction.
Renderers under the root object named Props are culled by distance with a CullingGroup. Keep decorative objects under that root to reduce the draw calls on mobile.