Skip to main content

Build and test

Everything below happens in StageTime SDK → Build Window. Dock it next to the Inspector and pick your world at the top: a scene (keeps baked lighting) or a prefab. The window also edits the world's details (id, version, display name, description), its platforms and the project setup.

There are three ways to try your world, from fastest to most realistic:

What it runsUse it for
Play in your projectyour scripts as plain C#, one offline playerlayout, logic, UI
Build & Testthe real StageTime app on your PCeverything: sandbox, networking, pickups, seats
Build Worlda bundle per platformthe final check before publishing

Preview with Play​

Open a scene that contains your world prefab and press Play. The SDK notices the ST World and starts a local preview: you are the only player, the room's master and the owner of every object.

  • Fly with W A S D, Q / E for down and up, and hold the right mouse button to look around.
  • Click an object to run its script's Interact(). World-space UI works with the mouse.
  • SendCustomEvent, delayed events, GetProgramVariable / SetProgramVariable and OnPlayerJoined (for you) work.

The preview runs your scripts as normal C#, so it does not check the allowed API, sync values or run pickups and seats. Always finish with Build & Test.

Build & Test​

In the Build Window, press Build & Test (desktop) or Build & Test (VR). The SDK:

  1. builds the Windows bundle (a few seconds after the first build),
  2. starts StageTime with -world <your world.json>, and
  3. StageTime puts you in a private room with your world.

By default it starts StageTime through Steam, so Steam must be running. To use a different copy, press Local Build... and pick its StageTime.exe; Use Steam switches back.

Script errors appear in the Console with the file and line, like normal C# errors:

RotatingCube.cs(14,9): error STC0102: 'UnityEngine.GameObject.Find' is not available to world scripts

Test with more players​

Start StageTime yourself with the same room name on several PCs (or accounts) to test networking:

StageTime.exe -desktop -world "C:\path\to\world.json" -worldSession my-test-room

Everyone needs the same world.json folder. Things worth checking:

  • Click things from both clients: the second player has to take ownership first.
  • Leave and rejoin with one client: late joiners should see the current state.
  • Close the first client (the room's master): the other player becomes master and takes over its objects.

Build World​

Build World builds a bundle for every platform the world supports. The builder:

  1. copies the scene or prefab (yours is never changed; an open scene with unsaved changes is saved first),
  2. compiles every script to WebAssembly and checks it only uses the allowed API,
  3. replaces each script with its compiled data (StageTime adds networking and interaction when the world loads),
  4. builds a bundle per platform, and
  5. writes them with a world.json manifest to Builds/WorldBuilds/<world id>/<version>/.

Before building it checks your project setup and prints a warning for anything that would make the world look wrong in StageTime. The Build Window's Project Setup section shows the same check.

tip

The first Android build takes a while because Unity imports the project for Android. Later builds are much faster.

Platforms​

PlatformUnity module
Windows (desktop and PC VR)always builtincluded
Android (Quest, Pico, phones)always builtAndroid Build Support
macOSoptionalMac Build Support
iOS (iPhone, iPad)optionaliOS Build Support
visionOS (Apple Vision Pro)optionalvisionOS Build Support (Unity on a Mac only)

Tick the optional platforms in the Build Window's Platforms section. Each platform needs its own bundle, because Unity builds shaders and textures separately for each one. Players on a platform without a bundle can't load the world. If a ticked platform's module isn't installed, the build skips it with a warning. Add modules in Unity Hub (Installs → Manage → Add modules).

Publish​

Publishing worlds is not open to creators yet. Share the Builds/WorldBuilds/<world id>/<version>/ folder with the StageTime team.