Skip to main content

Your First World

Build a scene in 5 minutes using the Wizard Console.

1. Create a World​

Click the world selector (top of the Wizard Console) and hit + Create. Name it whatever you want.

Each world is an independent save file stored in data/worlds/. You can have as many as you want.

2. Place Some Assets​

Open the Catalog tab in the Wizard Console. You'll see 565+ built-in 3D assets organized by category:

  • Medieval — castles, towers, walls, weapons (Kenney Retro Medieval Kit)
  • Urban — buildings, vehicles, street furniture (Kenney Retro Urban Kit)
  • Furniture — chairs, tables, beds, shelves (Kenney Furniture Kit)
  • Nature — trees, rocks, flowers
  • Characters — people, animals, creatures

Click any asset to enter Placement mode. Move your mouse to position it in the world, then click to place.

3. Transform Objects​

Select any placed object by clicking it, then use the gizmos:

KeyTransform
WTranslate (move)
ERotate
RScale
DeleteRemove object

The Joystick panel (right side) shows the selected object's properties — position, rotation, scale, and behaviors.

4. Change the Sky​

Open the Settings or use an agent to change the sky. 24 environments available:

  • 4 procedural night skies (4K)
  • 8 Poly Haven HDRIs (alps, sunset, grotto, etc.)
  • 10 drei presets
  • 1 procedural star generator

5. Paint the Ground​

Switch to Paint mode (brush icon in the toolbar). Choose a texture preset:

  • Grass, stone, sand, lava, snow, water, and more
  • Click and drag to paint tiles
  • Each tile is stored as a sparse map — only painted tiles use memory

6. Conjure from Text (requires API key)​

Open the Conjure tab, type a prompt like "medieval treasure chest", select a provider (Meshy or Tripo), and hit generate. The model appears in your library when ready — click to place it.

7. Craft Geometry (requires API key)​

Open the Craft tab and describe what you want: "a cyberpunk cityscape with neon towers". Claude generates Three.js primitives (boxes, spheres, cylinders) arranged into your scene.

What's Saved​

Everything is autosaved. The Oasis uses debounced writes (100ms + 1000ms) so your world persists after every change. World state includes:

  • All placed objects and their transforms
  • Terrain and ground tiles
  • Lights and sky
  • Agent windows
  • Conjured and crafted assets
  • Object behaviors and animations

Your world lives in data/worlds/{id}.json — you can back it up, share it, or move it to another machine.