ST World
The root of every world. The world builder packs everything under it into the world bundle.
| Field | |
|---|---|
| World Id | Lowercase id: letters, digits, ., _, - (e.g. my-first-world) |
| Version | Bump it for every published change (letters, digits, ., _, -) |
| Display Name | The name players see (up to 64 characters). Empty uses the World Id |
| Description | A short description players see (up to 500 characters) |
| Extra Platforms | macOS, iOS and visionOS bundles, built in addition to Windows and Android (always built). See Build and test |
| Spawn Point | Where players appear; its forward (blue Z) is the facing direction. Empty = the world root |
| Skybox | Optional sky material (e.g. Skybox/Procedural). Empty keeps StageTime's default sky |
Rules
- Everything in the world must be inside this prefab, or in its scene (see below).
- Only allowed components may be used (renderers, colliders, lights, audio, UI, animators, particles, the StageTime components and your scripts). The builder lists anything it rejects.
- Keep the world small and efficient: it is downloaded by every player and runs on standalone headsets.
Scene or prefab
A world is either a scene or a prefab. Use a scene when you want baked lighting, like a VRChat world: lightmaps, Adaptive Probe Volumes, reflection probes and occlusion culling data all come with it.
In a scene world:
- Exactly one root object has ST World. The builder moves every other root object under it, so you can keep lights, probes and level geometry at the top of the hierarchy.
- The builder leaves out root objects tagged EditorOnly, and a scene camera or EventSystem on its own (StageTime brings its own).
- Bake lighting (Window → Rendering → Lighting → Generate Lighting) before you build. The builder packs the baked data as it is and does not bake.
- Use Unity's own lightmapper. Third-party lightmappers that add their own components (such as Bakery) are not supported.
- Light Probe Groups do nothing in StageTime, because StageTime lights dynamic objects with Adaptive Probe Volumes. Add an Adaptive Probe Volume to light moving objects and players.
Pick the scene in the Build Window, or select it (or its ST World object) and use Use Selection. You can edit the world's details while the scene is open.