# 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.

## Scale Lab (Editor)

Open **`scenes/dev/scale_lab.tscn`** in Godot (File → Open, or drag into viewport). Not in the main game flow.

1. Pick a model in the list (all GLBs under `animals/`, `houses/`, `props/`).
2. Compare against the **measuring wall** (0.1 m ticks, labels every meter, red mark at **1.74 m**) and the blue **player capsule**.
3. Adjust `fit_height` / `fit_max_width` → live preview via `ModelProp`.
4. **Save** writes **`data/model_scales.json`**. Village, massage studio, and every `ModelProp` with `use_scale_catalog` read that file at runtime.
5. **Reset defaults** restores built-in SpriteFit tables (save again to persist).

Keys are `category/folder` (e.g. `animals/chimp`). Missing keys fall back to `SpriteFit` constants.

## 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.