Skip to main content

ST World

The root of every world. The world builder packs everything under it into the world bundle.

Field
World IdLowercase id: letters, digits, ., _, - (e.g. my-first-world)
VersionBump it for every published change (letters, digits, ., _, -)
Display NameThe name players see (up to 64 characters). Empty uses the World Id
DescriptionA short description players see (up to 500 characters)
Extra PlatformsmacOS, iOS and visionOS bundles, built in addition to Windows and Android (always built). See Build and test
Spawn PointWhere players appear; its forward (blue Z) is the facing direction. Empty = the world root
SkyboxOptional 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.