> ## Documentation Index
> Fetch the complete documentation index at: https://docs.worldlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> Connect and arrange multiple worlds to create larger, seamless environments for games and experiences.

# Compose

<iframe width="100%" height="400" src="https://www.youtube.com/embed/vp0x4jUWCHw" title="Welcome to Marble" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

# Studio compose: building connected worlds

Use Studio Compose to connect multiple existing worlds into larger, seamless environments. Perfect for creating game maps, architectural complexes, or any scenario where you need to join separate scenes into one cohesive experience.

## Getting started with compose

The Studio Compose interface provides powerful tools for world arrangement:

* **3D Viewport**: The main canvas showing your connected worlds
* **Scene Panel**: Manage and add worlds to your composition
* **Controls Panel**: Fine-tune positioning, rotation, and scaling
* **Project Tools**: Save, share, and export your composed world

## How to add worlds to your composition

Build your composition by importing existing worlds:

1. **Click *Add scene***: In the Scene Panel, select **Add** to browse your worlds
2. **Choose your world**: Select from your saved worlds or community creations
3. **Position the world**: The world appears in the viewport with positioning handles
4. **Repeat as needed**: Add multiple worlds to build your larger environment

## How to build a multi-room house

Marble's image and Auto Layout inputs reconstruct a single space, so a whole house comes together by generating each room on its own and joining them here. There is no floor plan input that auto-connects rooms, so you place and connect them yourself.

1. **Generate each room**: Create each room as its own world (for example, a multi-image or panorama prompt per room).
2. **Add the rooms**: Use **Add scene** to bring each room world into the composition.
3. **Lay out to your plan**: Position, rotate, and scale each room to match your floor plan. Keep the plan open as a visual reference for placement, since Marble does not read it as a layout input.
4. **Connect the rooms**: Align floor heights and overlap shared walls or doorways so you can walk from room to room. See [How to fine-tune world connections](#how-to-fine-tune-world-connections).

## Splat removal

2. **Brush**: Use circle or square brushes to delete splats.
3. **Brush size**: Adjust the brush size for more precise control.

## How to position and align worlds

Precisely control world placement:

1. **Select a world**: Click on any world in the viewport or Scene Panel
2. **Use position controls**: In the Controls Panel, adjust X, Y, Z coordinates
3. **Set rotation**: Modify rotation values to orient worlds correctly
4. **Adjust scale**: Change the scale value to resize worlds proportionally
5. **Visual alignment**: Use the grid and bounding corners for visual reference

## How to navigate your composition

Move around your large-scale environment:

1. **Adjust movement speed**: Set movement speed (default: 3) for comfortable navigation
2. **Enable natural mouse**: Toggle natural mouse controls for intuitive camera movement
3. **Set field of view (FOV)**: Adjust to 92 or your preferred viewing angle
4. **Use grid reference**: Toggle grid visibility to help with alignment
5. **Show bounding corners**: Enable to see world boundaries clearly

## How to fine-tune world connections

Create seamless transitions between worlds:

1. **Check overlapping areas**: Look for where worlds meet or overlap
2. **Align ground levels**: Ensure floor heights match between connected worlds
3. **Match lighting**: Adjust worlds so lighting conditions blend naturally
4. **Test transitions**: Navigate between worlds to check for smooth movement
5. **Adjust background color**: Set consistent background (BG Color: #3f3f3f) across scenes

## How to save and export your composition

Preserve and share your connected world:

1. **Save your project**: Use the save controls to preserve your composition
2. **Share settings**: Enable sharing if you want others to view your creation
3. **Export options**: Use the export button to generate files for external use
4. **Monitor splats**: Keep track of your splat usage (500,000 / 2,000,000 limit shown)

## FAQ

### What does the splat count represent?

Splats represent the 3D Gaussian Splat data that makes up your worlds. The counter shows your current usage against your account limit. Larger, more detailed worlds use more splats.

### What is the Layer panel for?

The Layer panel lets you organize and manage the visibility of different worlds in your composition. You can hide or show specific worlds while working.

### How do I delete a world from my composition?

Select the world you want to remove and press delete key. The world will be removed from the composition but remains in your library.