70 lines
3.6 KiB
Markdown
70 lines
3.6 KiB
Markdown
# Bauen — eigene Häuser aus Modulteilen
|
||
|
||
Stand 25.10.2026 (Umbau). Vorlage: **Modular Builder 0.2.0** von Michel Savadim,
|
||
Godot-Erweiterung, Lizenz **CC0 1.0** (Code, Icons, Doku — siehe
|
||
`addons/modular_builder/LICENSE`). Die Demo-Szene/Demo-Texturen der Vorlage sind
|
||
nicht CC0 und liegen bewusst nicht im Repo (`ADDON_LIZENZ.txt`).
|
||
|
||
## Prinzip
|
||
|
||
Ein Bauteil ist ein **ganz normales Bibliotheks-Objekt** (`bau_*`, Kategorie
|
||
„bauteile“). Gesetzte Teile stehen in `objects`, ein Gebäude ist eine **Gruppe**
|
||
(`group` + `group_names`). Dadurch gelten ohne Sonderfälle:
|
||
|
||
* Undo/Redo, Auswahl, Verschieben, Drehen, Duplizieren, Löschen, Symmetrie
|
||
* Speichern in der `.svmap` (kein eigener Block mehr, Server-Validierung V1–V17)
|
||
* **Kollision serverkonsistent**: jedes Teil hat eine Trimesh-Datei
|
||
(`library/kollisions/bau_*.json`) — Türen, Fenster, Schießscharten sind echte
|
||
Löcher, die Treppe ist eine Stufenfläche (Stufen 20 cm). Editor-Playtest, Client
|
||
und Server lesen dieselbe Datei.
|
||
* Poly-Budget zählt wie bei jedem Objekt (`poly` = Dreiecke des Teils).
|
||
|
||
## Teile (Katalog: `src/editor/bau_katalog.gd`)
|
||
|
||
| Gruppe | Teile |
|
||
| --- | --- |
|
||
| Fundament & Boden | Fundament, Boden/Decke (2 × 2 m, 20 cm) |
|
||
| Wände (2 m breit, 3 m hoch) | Wand, Wand mit Tür (1,2 × 2,2 m), Wand mit Fenster, Wand mit Schießscharte, Brüstung (1,1 m), Eckpfeiler |
|
||
| Dach & Giebel (klein 2 m) | Giebelwand, Satteldach, Pyramidendach |
|
||
| Dach & Giebel (mittel 4 m) | Giebelwand 4 m, Satteldach 4×4, Pyramidendach 4×4 (Spitze 2 m) |
|
||
| Dach & Giebel (groß 6 m) | Giebelwand 6 m, Satteldach 6×6, Pyramidendach 6×6 (Spitze 3 m) |
|
||
| Treppe | Treppe 4 × 2 m, 3 m hoch (15 Stufen) |
|
||
|
||
Fertige Pack-Objekte (Container, Hangar-Tore, Betonsperren) stehen NICHT im Bauen-Tab,
|
||
sondern wie alle Objekte in der Objekt-Bibliothek unten.
|
||
|
||
## Snap (`src/editor/build_snap.gd`)
|
||
|
||
* **XZ:** Wände auf die nächste Zellkante — und zwar GANZ in die Zelle, in der die
|
||
Maus ist (Außenseite bündig mit der Kante, kein Überhang, Ecken schließen ohne
|
||
Lücke). Klick auf eine vorhandene Wand (Seite oder Oberkante) übernimmt deren Lage
|
||
exakt (ersetzen bzw. stapeln). Böden/Dächer/Fundamente in die Zellmitte, große
|
||
Dächer (4 m / 6 m) je nach Zellzahl auf Zellecke bzw. Zellmitte, Pfeiler auf die
|
||
Zellecke, Treppen auf eine 4 × 2-m-Fläche. `R` dreht die Wand um. Zellen sind
|
||
2 × 2 m, global ab (0, 0).
|
||
* **Y:** nie die Klickhöhe, sondern eine **Ebene** — Gelände (höchster Punkt unter
|
||
der Grundfläche) oder Oberkante eines tragenden Teils darunter. **Wände und
|
||
Pfeiler zählen von der Unterkante einer Decke/eines Fundaments**, die Decke selbst
|
||
liegt auf der Wandoberkante: jedes Geschoss liegt auf Vielfachen von 3 m, mit oder
|
||
ohne Decke darunter stehen die oberen Wände gleich hoch.
|
||
* **Ersetzen:** gleiche Art auf demselben Platz wird ersetzt (Tür in vorhandene
|
||
Wand). Dasselbe Teil nochmal wird mit Erklärung abgelehnt.
|
||
|
||
## Dateien erzeugen
|
||
|
||
Meshes, GLBs, Kollision und Registry-Fragment kommen aus dem Katalog:
|
||
|
||
```bash
|
||
godot --headless --path . --script res://tools/gen_bauteile.gd -- \
|
||
--client ../scopedvr-client --server ../scopedvr-match-server
|
||
(cd ../scopedvr-match-server && python3 tools/merge_object_library.py)
|
||
```
|
||
|
||
Danach `library/objects.json` in Client und Editor angleichen (`tools/sync_objects.sh`).
|
||
`tests/test_bauen.gd` prüft, dass die Registry zum Katalog passt.
|
||
|
||
## Alte Maps
|
||
|
||
Die frühere Sektion `gebaeude` (Bauen-Modus vom 20.10.) wird beim Öffnen in
|
||
`bau_*`-Objekte einer Gruppe übernommen (`BauOps.migriere_gebaeude`). Wandhöhe ist
|
||
jetzt 3 m statt 2 m — alte Häuser bitte kurz prüfen und neu speichern.
|