Remote Sandbox

Third-party mods are tested in a VibeLands-hosted sandbox, so no local game runtime is required and the game client never imports mod code from a user-supplied local URL. The canonical authoring source is the local Creator project installed with npm install --global @vibelands/creator; the hosted Sandbox is its visual multiplayer runtime. The optional browser editor requires neither a checkout nor a local runtime.

vibelands serve .

The command validates the mod, targets your Developer Sandbox (a private 3-player world, one per account, created on first use), uploads a source archive to https://playvibelands.com/api/mods/sandbox, polls the hosted build, and prints the status URL, build log URL, artifact URL, remote game URL, sandbox world id, runtime URL, and any sandbox runtime error returned by the service. If the build fails, the CLI prints the tail of the hosted build log before exiting.

For CI, editor, or developer-portal integrations, request structured output:

vibelands serve . --json

The JSON response includes buildId, statusUrl, logUrl, artifactUrl, gameUrl, and a sandbox object with serverId, worldId, runtime, and error. A published build with sandbox.error means compilation succeeded but the hosted sandbox runtime could not be prepared yet; open the statusUrl or rerun serve after fixing the runtime issue.

To re-check a build later or pull the hosted build log tail from your terminal:

vibelands status <buildId>
vibelands status <buildId> --logs --log-lines 120
vibelands status <buildId> --json --logs

Use this when a teammate shares a build id, when the browser URL fails after a successful build, or when a CI job needs to archive the sandbox diagnostics.

What Runs Remotely

1. The sandbox builder compiles and scans the source package.
2. The mod is deployed into your Developer Sandbox. --clone-world <worldId> first replaces the sandbox content with a copy of one of your worlds.
3. The game loads from VibeLands-hosted infrastructure only.
4. Mod server code runs in an isolated worker container.

Local ?devMod=<url> loading is intentionally unsupported. Mods never run in your regular worlds during development; install a released version through the Marketplace for that. Paid plans include the Developer Sandbox; free accounts can be granted one. vibelands sandbox shows its status.