Grundlegend

Baue den kleinsten funktionierenden Raum

Der öffentliche minimale Raumbaumeister startet mit einer leeren Blender-Szene. Er erstellt einen Schreibtisch, einen kalibrierten Sitz, zwei Wände, ein Dach, eine gesteuerte Pendelleuchte, ein Thumbnail und sitzende Review-Bilder.

Sie benötigen: macOS, Blender 5.2, Python 3 und eine lokale Kopie des öffentlichen Locus Support-Repository. Der Builder führt Blender im Hintergrund aus; keine Blender MCP-Verbindung ist erforderlich.
  1. Führen Sie den minimalen Raumbaumealer aus. Wählen Sie einen neuen Ausgabordner aus. Der Builder weigert sich, einen bestehenden zu überschreiben.
  2. Überprüfen Sie jedes Bild in der Überprüfung/. Prüfen Sie die Schreibtischhöhe, die Augenposition, den Freiraum, die Ausrichtung, die Materialien und das Licht vom tatsächlichen Sitzplatz.
  3. Packen und validieren Sie das Zimmer. Die aktuellen öffentlichen Tools erstellen einen Legacy/einfachen flachen Kompatibilitäts-ZIP und überprüfen seine Dateien, Metadaten, das Modell und die Grenzen.
  4. Importieren Sie das genaue ZIP. Wählen Sie in Locus Orte → Importieren → Einen Raum importieren → Dateien.
  5. Probieren Sie den Sitz auf Apple Vision Pro aus. Paare den Raum mit einem Ausblick, betrete den virtuellen Raum, setze dich an den Leseschreibtisch und teste die Raumbeleuchtung in den Schnellsteuerung.
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

Verwenden Sie den absoluten Pfad zu Blender, wenn die blender Befehl ist im Terminal nicht verfügbar.

Kompatibilitätsvertrag

Die fünf Dateien verstehen

my-room.zip
├── space.json
├── provenance.json
├── teleport-points.json
├── scene.usdz
└── thumbnail.jpg
Dies ist das Legacy/einfache Kompatibilitätslayout. Legen Sie alle fünf Dateien am Wurzelort ab. Fügen Sie kein übergeordnetes Verzeichnis, die Datei Blender, Quelltexturen, GLB, Caches oder Überprüfungsbilder hinzu. Jede Importdatei erhält einen neuen UUID.
Kanonische Lieferung in Locus 1.2.1 und später: Verwenden Sie das vollständige Package v2, wenn Sie stabile IDs, vor Ort-Updates, Sound, Animationen, Videooberflächen, Sitzgruppen, Herkunft oder gebündelte Erlebnisse benötigen. Sein ZIP-Wurzel enthält direkt locusplace.json Und catalog/. Siehe die Kompletter Package v2-Guide.

Fortgeschritten

Verwandeln Sie Ihre Architektur in einen Produktionsraum

  1. Design nach Gebrauch. Bieten Sie jedem offiziellen Sitzplatz einen nutzbaren Tisch oder Arbeitsflächen, ausreichend Platz zum Entspannen und eine gezielte Sichtlinie.
  2. Arbeiten in Metern und Export +Y hoch. Locus verwendet world -Z als Vordername. Halten Sie jeden metadatenreferenzierten Entitätsnamen stabil und einzigartig.
  3. Öffnungszeiten und Plätze angeben. Modellfenster und Öffnungen in der Geometrie; die Metadaten beschreiben, wie der fertige Raum mit der ausgewählten Ansicht verbunden ist.
  4. Fügen Sie nur die Steuerelemente hinzu, die der Raum benötigt. Optionales Metadaten kann Tablet-Oberflächen, besuchergesteuerte Lichter, weiche View-Reflektionen, UI-Fade-Berechtigungen und experimentelle Ambient-Animationen abbilden.
  5. Quellenprobleme in der Quelle beheben. Korrekte Geometrie, UVs, Materialien, Texturen, Skalierung und Lichtrichtung im bearbeitbaren Asset, dann erneut exportieren.
  6. Jeden deklarierten Sitzplatz validieren und testen. Ein gültiges ZIP kann sich immer noch zu groß, beengt, blockiert oder unangenehm anfühlen. Die endgültige Platzierung und Komfortprüfungen erfordern Apple Vision Pro.