Skip to main content

Look right on every platform

One world scene becomes a bundle for each platform: Windows (desktop and PC VR), Android (Quest, Pico, phones) and, if you tick them, macOS, iOS and visionOS. The builder prepares textures, lighting and shaders for each one, so you don't need to switch platforms or keep separate scenes. What you do need is a world that every one of those devices can draw. This page lists what that means.

Design for the smallest device. A standalone headset has a phone GPU, little memory and has to draw two eyes at 72 frames per second or more. A world that runs well on Quest runs well everywhere.

Quick checklist​

  • Fix Project Setup pressed and the Project Setup section in the Build Window shows no problems.
  • Every material uses a URP shader (no pink materials in the Scene view).
  • Lighting is baked with Unity's lightmapper, and baked again after your last change to the level.
  • Moving objects and players are lit by an Adaptive Probe Volume.
  • Every platform your players use is ticked in the Build Window.
  • You tried the world in VR with Build & Test (VR), not only on the desktop.

Project setup​

Press Fix Project Setup in the Build Window (see Install the SDK). It sets what every platform needs: linear colour, ASTC textures for Android, and OpenXR in Single Pass Instanced mode, which is how StageTime draws both eyes. Without that last one, shaders may draw in one eye only. Use the Unity version StageTime is built with (see Requirements); bundles from another version may not load.

Shaders and materials​

Use URP shaders. They work on every platform:

ShaderUse it for
Universal Render Pipeline/LitMost surfaces
Universal Render Pipeline/Simple Lit or Baked LitCheaper surfaces, large areas, anything far away
Universal Render Pipeline/UnlitScreens, signs, glowing or stylised surfaces that ignore light
Universal Render Pipeline/Particles/...Particle systems
Shader Graph (Universal target)Your own effects
Skybox/... (Procedural, 6 Sided, Cubemap, Panoramic)The world's skybox
TextMesh Pro shadersText
  • Built-in render pipeline shaders don't work. Standard, Legacy and Mobile shaders draw pink. Convert them with Window → Rendering → Render Pipeline Converter, or change the material's shader by hand. Assets from the Asset Store often ship with built-in materials, so check them after importing.
  • Prefer Shader Graph to hand-written shaders. Shader Graph supports single-pass VR and every graphics API StageTime uses. A hand-written shader must be written for URP and support Single Pass Instanced rendering (the UNITY_VERTEX_INPUT_INSTANCE_ID, UNITY_VERTEX_OUTPUT_STEREO and UNITY_SETUP_STEREO_EYE_INDEX_POST_VERTEX macros), or it draws in one eye only in VR.
  • No geometry or tessellation shaders. Apple devices (Metal) don't support geometry shaders, and they are slow on standalone headsets.
  • Don't rely on the camera's depth or opaque texture. StageTime doesn't render them, so effects that read the scene behind a surface (refraction, depth-faded water edges, soft particles) don't show.
  • No HDR or post-processing. StageTime renders without HDR and worlds can't add Volumes, so there is no bloom: bright and emissive colours are clamped, not glowing. For a glow, use an unlit texture or a soft particle sprite.
  • Use few materials. Each material is a draw call per object. Share materials between objects and combine textures into atlases where you can. Mark objects that never move as Static so Unity can batch them.
  • Keep transparency small. Large alpha-blended surfaces that overlap (glass walls, fog cards, layered foliage) are among the most expensive things a headset draws. Use opaque materials where you can, and cut-out (alpha clip) sparingly.
tip

If you don't tick a platform, players on it may not be able to load the world, or may see a simplified version of it. Tick every platform your players use, so each one gets a bundle made for it.

Lighting​

Baked light is the most important thing for a good-looking world on a headset: it is almost free to draw, and it is how the builder carries your lighting to every platform.

  • Bake with Unity's lightmapper (Window → Rendering → Lighting → Generate Lighting), Progressive GPU or CPU. Third-party lightmappers that add their own components (such as Bakery) are not supported.
  • Keep the lightmaps as Unity writes them. Leave the .exr files in the scene's folder and don't change their import settings or replace them with other images. The builder prepares them for each platform when it builds; your scene and lightmaps are not changed.
  • Bake every light you can. Set lights to Baked. Real-time lights are expensive: StageTime gives each object one extra real-time light besides the main directional light, and only the main directional light casts real-time shadows (up to 50 m away). A Mixed directional light is fine if you want sharp shadows on moving objects.
  • Light moving objects with an Adaptive Probe Volume. Players, pickups and anything animated are lit from probes. Add an Adaptive Probe Volume that covers where they go. Light Probe Groups do nothing in StageTime.
  • Bake reflection probes, at a small resolution (128 or 256) and only where reflections matter, such as shiny floors and metal.
  • Watch lightmap size. Lightmaps are some of the largest textures in a world. Keep Max Lightmap Size at 1024 or 2048, lower Lightmap Resolution for large or distant surfaces, and turn off Contribute Global Illumination for small objects (let the probe volume light them). Directional lightmaps look better on normal maps but double the lightmap memory.
  • Rebake after you change the level. The builder packs the baked data as it is, so moved or new objects keep old or missing lighting until you bake again.

See The scene for what else the scene's lighting brings with it.

Textures, meshes and size​

  • Leave texture compression to the project. Fix Project Setup makes Android use ASTC, and each platform gets its own compressed textures. You don't need per-platform overrides.
  • Size textures for what players see. 2048 is plenty for most surfaces and 1024 or less for props. Keep mipmaps on for 3D textures.
  • Keep meshes simple. Use LOD Groups for detailed objects, and give large mesh colliders a simpler mesh than the one you draw.
  • Mind the download. Every player downloads the world, and your account has a size limit per bundle. Textures and lightmaps make up most of a world's size.

Test​

Build & Test runs the Windows bundle on your PC. Try both Desktop and VR: some problems (a shader in one eye, wrong scale, too much transparency) only show in a headset. Then upload the world as Private and open it on the other devices you have, especially a standalone headset: sign in to the same StageTime account, and your uploaded worlds are listed in Create Room.