39 lines
2 KiB
Markdown
39 lines
2 KiB
Markdown
|
# 3D-Modelle
|
|||
|
|
|
|||
|
|
> **Git:** `.glb`/Textures unter `3DModelle/` sind lokal (Forgejo HTTP 413). Mit Git-LFS nachziehen, sobald verfügbar.
|
|||
|
|
```
|
|||
|
|
3DModelle/
|
|||
|
|
_inbox/ # optional drop zone
|
|||
|
|
props/ # button, table, …
|
|||
|
|
houses/ # house, house_b, broken, … | massour = fest
|
|||
|
|
animals/ # cat, chimp, giraffe, …
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Auto-Sort
|
|||
|
|
|
|||
|
|
GLBs in die **Root** oder `_inbox/` legen (Umbenennen ok). Nach **~45s ohne Änderung**:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python3 scripts/tools/organize_3d_models.py --watch --import
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Sortiert nach Namen → `props/` / `houses/` / `animals/`, zieht Texturen mit, fixt `.import`.
|
|||
|
|
|
|||
|
|
Einmal sofort: `python3 scripts/tools/organize_3d_models.py --force --import`
|
|||
|
|
|
|||
|
|
**Random-Dorf:** Häuser außer `massour/`; Tiere außer `cow/` (Kuh = Masseur **im Dorf**).
|
|||
|
|
**Größen:** Spieler = **1,74 m** (`SpriteFit.WORLD_PLAYER_HEIGHT`); Häuser ~8,5 m, Kuh ~1,5 m, Tiere artgerecht (Katze ~28 cm … Giraffe ~3,4 m). Scale-Lab / `data/model_scales.json` überschreibt Fits.
|
|||
|
|
|
|||
|
|
## Editor-Vorschau (WYSIWYG)
|
|||
|
|
|
|||
|
|
Ohne Play sehen, wo Billboards und 3D-Props landen:
|
|||
|
|
|
|||
|
|
| Was | Script | Verhalten im Editor |
|
|||
|
|
|-----|--------|---------------------|
|
|||
|
|
| Billboards | `BillboardSprite` (`@tool`) | Quad + Texture; **yaw** zur **Editor-Kamera** (`get_viewport().get_camera_3d()`) |
|
|||
|
|
| NPCs / Enemies / Player | `InteractableNPC`, `HittableEntity`, `PlayerController`, … | Laden Texture/Höhe aufs Kind-Billboard (kein Kampf-/Quest-Code) |
|
|||
|
|
| ModelProps | `ModelProp` (`@tool`) | Lädt GLB, `fit_height` / Katalog; Mesh-Child **ohne** `owner` (wird nicht mitgespeichert) |
|
|||
|
|
| Dorf-Random-Spawns | `village.gd` (`@tool`) | Export **`editor_preview_spawns`** (default an): deterministische Stand-ins an `HOUSE_SLOTS` / `ANIMAL_SLOTS` + Masseur/Kuh/Progress. Prefix `_EditorPreview_*`. Runtime freut sie vor dem echten Random-Spawn. |
|
|||
|
|
|
|||
|
|
**Tipps:** Dorf-Szene öffnen → 3D-Viewport drehen → Billboards folgen der Editor-Kamera. Preview aus = nur feste Scene-Kinder (Tisch, NPCs). Speichern persistiert keine Preview-Meshes.
|