Make your own Room.

Basic

Build the smallest working Room

The public minimal Room builder starts from an empty Blender scene. It creates one desk, one calibrated seat, two walls, a roof, a controlled pendant light, a thumbnail, and seated review images.

1. Run the minimal Room builder. Choose a new output folder. The builder refuses to overwrite an existing one.
2. Inspect every image in review/. Check the desk height, eye position, clearance, direction, materials, and light from the actual seat.
3. Pack and validate the Room. The public tools create one flat ZIP and check its files, metadata, model, and limits.
4. Import the exact ZIP. In Locus, choose Library → Import Your Own → Import a Room → Files.
5. Try the seat on Apple Vision Pro. Pair the Room with a View, enter Virtual Space, sit at Reading Desk, and test Room Lights.

blender --background --factory-startup --python-exit-code 1 \
  --python tools/build_minimal_room.py -- \
  --output /absolute/path/to/minimal-reading-room

python3 tools/pack_locus_asset.py \
  /absolute/path/to/minimal-reading-room/room \
  /absolute/path/to/minimal-reading-room.zip

python3 tools/validate_locus_asset.py \
  /absolute/path/to/minimal-reading-room.zip

Use the absolute path to Blender if the blender command is not available in Terminal.

The contract

Understand the five files

my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg

• scene.usdz contains the self-contained, meter-scale, +Y-up Room.
• space.json names the Room and connects optional openings, surfaces, lights, rendering roles, and animations.
• teleport-points.json gives Locus at least one usable eye position and facing direction.
• provenance.json records creator, rights, requested credit, changes, and AI use truthfully.
• thumbnail.jpg shows the Room in Places. Locus does not create it for you.

Advanced

Turn your architecture into a production Room

1. Design around use. Give every official seat a usable table or counter surface, comfortable clearance, and a deliberate sightline.
2. Work in meters and export +Y up. Locus uses world -Z as forward. Keep every metadata-referenced entity name stable and unique.
3. Declare openings and seats. Model windows and openings in the geometry; metadata describes how the finished Room connects to the selected View.
4. Add only the controls the Room needs. Optional metadata can map tabletops, visitor-controlled lights, softened View reflections, UI fade permissions, and experimental ambient animations.
5. Fix source problems in the source. Correct geometry, UVs, materials, textures, scale, and light direction in the editable asset, then export again.
6. Validate and test every declared seat. A valid ZIP can still feel too large, cramped, blocked, or uncomfortable. Final placement and comfort checks require Apple Vision Pro.