Scenario 3D Worlds
Overview
These models build explorable environments as 3D Gaussian splats, not polygon meshes: volumetric
scenes to walk through and render in real time, with no UVs or topology to edit (Marble splats also
export to triangle or collider mesh). Three vendors sit side by side: World Labs Marble in three
quality tiers, Hunyuan's HY World pipeline, and TripoSplat for single objects. Discover them with
search and treat model_schema_get as the contract; HY World members carried a geo restriction
tag at authoring time, so hits differ by team and region.
Connection and the core loop: see the scenario skill; polygon meshes, rigging, and the 3D viewer:
the scenario-3d skill; skybox-only work with no splat stage: the scenario-skyboxes skill. If a
sibling skill named here is missing from your available skills, load it with skill_get (Scenario
MCP) or ask the user to install it (https://github.com/scenario-labs/skills#install); unattended,
proceed from tool schemas and flag the gap.
Quick reference
Pick the member by what you already have (input names from the live schemas):
| You have |
Member |
Inputs |
| A text idea |
Marble, any tier |
prompt alone |
| One image, flat or 360 |
Marble |
images, one entry; isPano: true if 360 |
| 2 to 8 photos of one scene |
Marble |
images |
| A walkthrough video |
Marble or HY Multi-view to Splat |
video |
| Many overlapping photos |
HY Multi-view to Splat |
images, 2 to 64 at authoring time |
| One photo of a place |
HY Image to Skybox, then Skybox to Splat |
image, then panorama |
| One photo of an object |
TripoSplat |
image; background removal is automatic |
images and video are mutually exclusive wherever both exist; isPano applies only when exactly
one image is passed. TripoSplat wants one clean object and every other member wants a scene: aiming
either at the other's subject is the main failure mode.
Draft on Marble, then upgrade
The three Marble tiers (1.0 Draft, 1.1, 1.1 Plus) take identical inputs, and the same inputs with
the same seed reproduce the same world on every tier. Iterate on Draft, which returned in about a
minute at authoring time, then rerun the identical parameters on 1.1 (balanced) or 1.1 Plus (highest
fidelity, dynamically grows larger worlds when the scene allows). The cost spread across tiers was
more than tenfold at authoring time, so dry_run before committing. splatResolution picks the
stored density (100k, 500k, full); disableRecaption: true stops Marble rewriting your
prompt.
The HY World pipeline runs long
Image to Skybox is an image model, not a 3D one: it expands one photo of a place into a 2:1
equirectangular panorama (backend trades full fidelity against qwen speed and cost). Its
output asset id goes to Skybox to Splat as panorama. There, the three trajectory toggles
(applyNavTraj, applyUpRoute, applyReconIteration, default true) drive cost and time;
maxSteps sharpens marginally and materially moves neither. The splat stage ran close to an hour at
median at authoring time: keep re-calling jobs_wait with pending_job_ids; a timeout is not a
failure and never justifies a second model_run. Multi-view to Splat is the opposite, fast and
cheap: best when the camera moved through a static scene with parallax.
Worked example: graybox a level from a concept image
search with target="models", query="marble world", public=true. Tiers appear side by
side, e.g. model_worldlabs-marble-1-0-draft (a live hit at authoring time: re-discover each
session).
model_schema_get with the Draft id: fields, caps, and defaults before anything else.
upload_asset the concept image (see the scenario skill) for an asset id.
model_run with dry_run=true and
parameters={"images": ["asset_x"], "prompt": "abandoned observatory interior, dusk light through the dome slit", "seed": 1234, "splatResolution": "full"};
repeat the dry run on the 1.1 id to see the upgrade cost.
model_run on Draft with wait=false, then jobs_wait with the job id, re-called with
pending_job_ids on timeout.
asset_display the splat and walk it; adjust and repeat on Draft until the layout is right.
- Rerun the identical parameters, same
seed, on the 1.1 or 1.1 Plus id from step 1, then
asset_download the final .spz.
Common mistakes
- Passing
images and video together: mutually exclusive on Marble and Multi-view to Splat.
- A single equirectangular input without
isPano: true: Marble reads it as a flat photo.
- Changing or omitting
seed between the draft and the upgrade tier: a different world comes back.
- Feeding TripoSplat a scene, or a world model a lone object.
- Treating a
jobs_wait timeout on Skybox to Splat as a failure: the job is still running.
- Adjusting
maxSteps to buy quality or cut cost: the trajectory toggles move cost, maxSteps
barely moves sharpness.
- Expecting UVs or editable topology from a splat: for polygon assets, use the mesh generators in
scenario-3d.
1---2name: scenario-3d-worlds3description: "Use when generating navigable 3D worlds or Gaussian splat scenes on Scenario via MCP: text-to-world, image-to-world, a 360 panorama or skybox turned into a walkable splat, multi-view photos or a video walkthrough reconstructed as a splat, or one object photo to splat. Keywords: World Labs Marble 1.1, 1.1 Plus, 1.0 Draft, Hunyuan World, HY World, image-to-skybox, skybox-to-splat, multiview-to-splat, TripoSplat, gaussian splatting, 3DGS, spz, world generation, explorable scene, VR."4license: MIT5metadata:6 source: https://skillmd.com/skills/scenario-labs/scenario-3d-worlds7---89# Scenario 3D Worlds1011## Overview1213These models build explorable environments as 3D Gaussian splats, not polygon meshes: volumetric14scenes to walk through and render in real time, with no UVs or topology to edit (Marble splats also15export to triangle or collider mesh). Three vendors sit side by side: World Labs Marble in three16quality tiers, Hunyuan's HY World pipeline, and TripoSplat for single objects. Discover them with17`search` and treat `model_schema_get` as the contract; HY World members carried a geo restriction18tag at authoring time, so hits differ by team and region.1920Connection and the core loop: see the `scenario` skill; polygon meshes, rigging, and the 3D viewer:21the `scenario-3d` skill; skybox-only work with no splat stage: the `scenario-skyboxes` skill. If a22sibling skill named here is missing from your available skills, load it with `skill_get` (Scenario23MCP) or ask the user to install it (https://github.com/scenario-labs/skills#install); unattended,24proceed from tool schemas and flag the gap.2526## Quick reference2728Pick the member by what you already have (input names from the live schemas):2930| You have | Member | Inputs |31| -------------------------- | ---------------------------------------- | ------------------------------------------ |32| A text idea | Marble, any tier | `prompt` alone |33| One image, flat or 360 | Marble | `images`, one entry; `isPano: true` if 360 |34| 2 to 8 photos of one scene | Marble | `images` |35| A walkthrough video | Marble or HY Multi-view to Splat | `video` |36| Many overlapping photos | HY Multi-view to Splat | `images`, 2 to 64 at authoring time |37| One photo of a place | HY Image to Skybox, then Skybox to Splat | `image`, then `panorama` |38| One photo of an object | TripoSplat | `image`; background removal is automatic |3940`images` and `video` are mutually exclusive wherever both exist; `isPano` applies only when exactly41one image is passed. TripoSplat wants one clean object and every other member wants a scene: aiming42either at the other's subject is the main failure mode.4344## Draft on Marble, then upgrade4546The three Marble tiers (1.0 Draft, 1.1, 1.1 Plus) take identical inputs, and the same inputs with47the same `seed` reproduce the same world on every tier. Iterate on Draft, which returned in about a48minute at authoring time, then rerun the identical parameters on 1.1 (balanced) or 1.1 Plus (highest49fidelity, dynamically grows larger worlds when the scene allows). The cost spread across tiers was50more than tenfold at authoring time, so `dry_run` before committing. `splatResolution` picks the51stored density (`100k`, `500k`, `full`); `disableRecaption: true` stops Marble rewriting your52prompt.5354## The HY World pipeline runs long5556Image to Skybox is an image model, not a 3D one: it expands one photo of a place into a 2:157equirectangular panorama (`backend` trades `full` fidelity against `qwen` speed and cost). Its58output asset id goes to Skybox to Splat as `panorama`. There, the three trajectory toggles59(`applyNavTraj`, `applyUpRoute`, `applyReconIteration`, default true) drive cost and time;60`maxSteps` sharpens marginally and materially moves neither. The splat stage ran close to an hour at61median at authoring time: keep re-calling `jobs_wait` with `pending_job_ids`; a timeout is not a62failure and never justifies a second `model_run`. Multi-view to Splat is the opposite, fast and63cheap: best when the camera moved through a static scene with parallax.6465## Worked example: graybox a level from a concept image66671. `search` with `target="models"`, `query="marble world"`, `public=true`. Tiers appear side by68 side, e.g. `model_worldlabs-marble-1-0-draft` (a live hit at authoring time: re-discover each69 session).702. `model_schema_get` with the Draft id: fields, caps, and defaults before anything else.713. `upload_asset` the concept image (see the `scenario` skill) for an asset id.724. `model_run` with `dry_run=true` and73 `parameters={"images": ["asset_x"], "prompt": "abandoned observatory interior, dusk light through the dome slit", "seed": 1234, "splatResolution": "full"}`;74 repeat the dry run on the 1.1 id to see the upgrade cost.755. `model_run` on Draft with `wait=false`, then `jobs_wait` with the job id, re-called with76 `pending_job_ids` on timeout.776. `asset_display` the splat and walk it; adjust and repeat on Draft until the layout is right.787. Rerun the identical parameters, same `seed`, on the 1.1 or 1.1 Plus id from step 1, then79 `asset_download` the final `.spz`.8081## Common mistakes8283- Passing `images` and `video` together: mutually exclusive on Marble and Multi-view to Splat.84- A single equirectangular input without `isPano: true`: Marble reads it as a flat photo.85- Changing or omitting `seed` between the draft and the upgrade tier: a different world comes back.86- Feeding TripoSplat a scene, or a world model a lone object.87- Treating a `jobs_wait` timeout on Skybox to Splat as a failure: the job is still running.88- Adjusting `maxSteps` to buy quality or cut cost: the trajectory toggles move cost, `maxSteps`89 barely moves sharpness.90- Expecting UVs or editable topology from a splat: for polygon assets, use the mesh generators in91 `scenario-3d`.