A world is a place: a loft, a tavern, a forest clearing. Ask for one in plain words and the agent generates it with World Labs and saves it into your project. You can then walk through it, put things in it and build on it.
Worlds are Gaussian splats: a way to show a place as it looks, with real light and detail, instead of as modelled geometry. Graspable shows them with the Spark renderer.
Ask for a world
In a project made from one of the splat templates, just ask:
Make this a greenhouse workshop at dusk, full of plants and glassware, with warm light from hanging lamps.
The agent asks you before it starts, because a world costs Credits. Generation takes about five minutes. The run waits for it and then switches the scene to the new world.
Good descriptions say what kind of place it is, what is in it, the light and the mood. One or two sentences are enough.
Sizes
| Size | What you get | Credits |
|---|---|---|
| Draft | A quick, rough version to check the idea | 2 |
| Standard | The default | 11 |
| Large | A bigger outdoor place or a large interior | 21 |
A world that fails to generate costs nothing. Generating worlds through Graspable comes with the Builder plan and higher. See Credits.
With your own World Labs account
If you have a World Labs API key, you can use it instead of Credits. Open Settings → Plugins and connectors, switch on World Labs and enter the key. World Labs then bills you directly, and the Graspable plan does not matter.
What is saved
Each world is a folder in your project, public/worlds/<name>/:
| File | What it is |
|---|---|
world-500k.spz |
The world, as 500,000 splats. This is what is shown |
world-100k.spz |
A light version |
collider.glb |
The same place as a plain mesh, for standing on floors and bumping into walls. It is never shown |
pano.png |
The panorama the world was made from |
world.json |
Its name, description, the scale that turns it into metres, and the credit line |
The templates read world.json for you, so a world appears at real size with its floor at your feet.
A world you generated is yours to keep in the project. Worlds are generated with World Labs Marble; keep the credit in world.json with the files.
Use a splat of your own
A world does not have to be generated. A Gaussian splat you captured yourself, or made in another tool, works in the same three templates.
- Open a project made from Splat World, World Explorer or World Game.
- Choose Worlds in the project header, then Choose a file… and pick the splat:
.spz,.ply,.splat,.ksplator.sog, up to 500 MB. - Choose Use it next to the new world. The agent switches the app to it.
The file is copied into the project as public/worlds/<name>/. It stays on your computer; nothing is uploaded until you publish the app.
Things to know:
- Size and floor. A splat does not say how big it is or where its floor is. If the place looks too big or too small, or the floor is not under your feet, tell the agent, for example "the room should be about 5 metres wide" or "the floor is a metre too low". It corrects the two numbers in the world's
world.json. - Upside down? Most splat files have their y axis pointing down, and Graspable expects that. Tick its y axis points up when you add one that comes in upside down.
- Nothing is solid. A splat of your own has no collider mesh, so the floor is one flat plane at your feet: you can walk and things can land on it, but nothing rests on the furniture you see.
- Keep it small. A published app may be 60 to 500 MB depending on your plan, a project on a Cloud Agent 100 MB to 1 GB, and a headset has to download all of it. A
.plysaved as.spzis about ten times smaller with no visible loss; one to two million splats is plenty for a room.
The templates that use worlds
- Splat World: look around a world and add things to it.
- World Explorer: walk through a world as if it were solid.
- World Game: a game inside a world, with physics.
See Templates.