# Build your world

Betworld worlds are shared 3D spaces built by their owners. Use the **in-game world builder** to place, move and rotate props and game stations, upload your own models, save a private draft and publish your layout.

You can also connect an AI assistant through **MCP** and design in Blender. Both workflows use the same world document, asset library and saved revisions.

## Start here

- **[Quickstart](/quickstart/)** — create and publish your first world.
- **[In-game world builder](/in-game-editor/)** — placement, transforms, manual uploads, saving and live updates.
- **[Connect MCP](/connect-mcp/)** — endpoint, credentials and client compatibility.
- **[Blender workflow](/blender/)** — download, build, export and upload.
- **[Custom betting-machine models](/betting-models/)** — safe static artwork, required controls and current support.
- **[Complete modeling workflow](/model-authoring-workflow/)** — detailed Blender setup, clearances, materials, normalization, alignment and upload steps.
- **[Measured model reference](/model-reference/)** — current native button bounds, runtime mounts and a Blender clearance-guide example.
- **[Agent instructions](/agent-guide/)** — a practical checklist for autonomous world builders.
- **[Limits and performance](/limits/)** — 1,000,000 entities, 500 MB estimated memory and 100 MB total download, whichever constraint is reached first.

- **[World HTTP API](/world-api/)** — every route, authentication method, request body, response and error.

## Give these docs to your AI

Send your assistant this URL: **https://docs.betworld.gg/llms-full.txt**.

The [documentation index](/llms.txt), [complete text](/llms-full.txt), [world schema](/world.schema.json), [catalog](/catalog.json) and [limits](/limits.json) are public. Every guide also has a raw Markdown copy under `/raw/`. No sign-in, JavaScript execution or captcha is required to read them.

Documentation never includes your private credential. Create one in Betworld and pass it through your client's secret settings.

## What you can customize

Arrange the supported betting stations, build scenery from built-in blocks or your own GLB props, and choose the floor, wall and prop colors. Betting stations keep their standard dimensions, interaction logic and odds. Game bodies and named physical button meshes can be replaced through [game skin contract v2](/game-skin-contract/). Use v2 placements and numeric clips/motions to customize controls and result presentation. Actions and game state are supplied by Betworld.

Players download the published world and its assets with a loading-progress screen before entering. The meadow lobby's active-world board and the world browser let players discover published worlds.

## Creator earnings

Owners earn **10% of user edge (the theoretical house edge)** on settled wagers in their world. This is not 10% of the wager or of a player's actual loss. A $100 wager on a game with a 1% theoretical edge earns the owner $0.10. Earnings are credited in $0.0001 increments; smaller fractions carry forward. See [publishing and earnings](/publishing/).