ab173ac8aa
Worker hatte die Arbeit fertig, aber NICHT committet/gepusht (3. Fall heute) — aus dem Karten-Arbeitsordner gerettet und hier gepusht. - GlbMeshStore.quellen(): Reihenfolge EINE Stelle — Setting -> Sibling-Repos -> mitgelieferter Ordner models/ direkt neben der App (dedupliziert, typisiert) - Klartext-Meldung FEHLT_TEXT statt stillem Platzhalter; Notfall-Modus: Terrain und Bauteile laufen ohne GLBs - neu: tools/sync_models.sh (fuellt models/, --check), utils/modelle_status.gd (Autoload ModelleStatus), tools/probe_gen_map.gd - neu: README_INSTALL.md (85 Zeilen, Schritt fuer Schritt + §5 Lizenzhinweis: ITHappy-Rohdaten NICHT weitergeben, App fuer Slys eigene Rechner) - export_presets.cfg (eigenstaendiger Linux-/Windows-Export), .gitignore: models/ + export/ bleiben draussen (Lizenz + Groesse) - Tests: test_model_sources (26/27; die rote ist umgebungsabhaengig: 'lager_ist_leer' erwartet fehlende Sibling-Repos) Belegt: Import 0 Fehler, gui_smoke 92, ui_layout 71, playtest_spawn 56.
85 lines
3.5 KiB
Markdown
85 lines
3.5 KiB
Markdown
# ScopedVR Map Builder auf einem anderen PC installieren
|
|
|
|
Diese Anleitung erklärt Schritt für Schritt, wie du den Map Builder auf einem
|
|
beliebigen PC zum Laufen bringst und dort eine Map testen kannst — **ohne**
|
|
Godot-Installation, **ohne** ScopedVR-Client, **ohne** Programmierkenntnisse.
|
|
|
|
---
|
|
|
|
## 1. Voraussetzungen
|
|
|
|
- Ein normaler PC (Linux oder Windows). Kein Godot, keine Kommandozeile nötig,
|
|
wenn die App einmal exportiert wurde.
|
|
- Die exportierte App (Ein Ordner oder eine EXE, siehe Schritt 2).
|
|
- Den Ordner `models/` mit den 3D-Modellen (siehe Schritt 3).
|
|
|
|
## 2. Die App bekommen
|
|
|
|
Die App ist eine eigenständige Datei (z. B. `MapEditor` unter Linux,
|
|
`MapEditor.exe` unter Windows). Sie wurde aus dem Map-Editor-Repo exportiert
|
|
(`export_presets.cfg`, Preset „Linux“). Auf dem Ziel-PC brauchst du sie nur
|
|
in einen beliebigen Ordner zu kopieren, z. B.:
|
|
|
|
~/MapBuilder/ (Linux)
|
|
C:\MapBuilder\ (Windows)
|
|
|
|
Doppelklick drauf — die App startet. Das war's. Keine Installation.
|
|
|
|
## 3. Die Modelle danebenlegen (WICHTIG)
|
|
|
|
Ohne Modelle zeigt die App nur einfache Platzhalter-Kisten. Damit die echten
|
|
3D-Modelle erscheinen, muss der Ordner `models/` **direkt neben** der App
|
|
liegen (genau so wie hier):
|
|
|
|
~/MapBuilder/MapEditor ← die App
|
|
~/MapBuilder/models/ ← die Modelle
|
|
|
|
Wie der `models/`-Ordner gefüllt wird: Auf einem PC, auf dem der
|
|
Client-Klon liegt, im Map-Editor-Repo laufen lassen:
|
|
|
|
tools/sync_models.sh
|
|
|
|
Das Script kopiert alle Objekte (GLB) und die benötigten Texturen in den
|
|
`models/`-Ordner — idempotent, du kannst es also gefahrlos mehrmals laufen
|
|
lassen. Mit `--check` prüft es nur (Exit 0 = alles aktuell, Exit 1 = es fehlt
|
|
etwas). Die Größe wird am Ende angezeigt.
|
|
|
|
Falls die Modelle fehlen, sagt die App beim Start deutlich:
|
|
> „Für die Anzeige fehlen die Modelle. So bekommst du sie: …“
|
|
|
|
Terrain und Bauteile (Wände, Dächer usw.) funktionieren **immer** — auch ganz
|
|
ohne Modelle (Notfall-Modus).
|
|
|
|
## 4. Eine Map testen
|
|
|
|
1. App starten.
|
|
2. Map öffnen: Datei → Map öffnen, dann die gewünschte `.svmap`-Datei wählen.
|
|
3. Zum Testen: Taste **F5** drücken. Du läufst dann selbst durch die Map
|
|
(WASD = gehen, Maus = umsehen, Shift = rennen, Leertaste = springen).
|
|
4. **ESC** zurück in den Editor.
|
|
|
|
## 5. Lizenz-Hinweis (bitte wirklich lesen)
|
|
|
|
Die 3D-Modelle und Texturen im `models/`-Ordner stammen aus dem
|
|
**ITHappy-Pack**. Die Lizenz dieses Packs erlaubt es **nicht**, die
|
|
Roh-Modelle und Texturen weiterzugeben. Das heißt konkret:
|
|
|
|
- Die App mit `models/`-Ordner ist für **Slys eigene Rechner** gedacht.
|
|
- Der Ordner **darf nicht** an andere Leute geschickt oder hochgeladen werden.
|
|
- Die App selbst (ohne `models/`-Ordner) darf geteilt werden — sie zeigt dann
|
|
eben nur Platzhalter, bis der Ordner dazukommt.
|
|
|
|
## 6. Wenn etwas nicht geht
|
|
|
|
| Problem | Lösung |
|
|
| --- | --- |
|
|
| Nur Kisten statt echter Modelle | `models/`-Ordner direkt neben die App legen (Schritt 3) |
|
|
| Meldung „Modelle fehlen“ | `tools/sync_models.sh` ausführen (Schritt 3) |
|
|
| App startet gar nicht | Auf Linux: Datei per Rechtsklick → „Ausführen“ erlauben, oder im Terminal `chmod +x MapEditor` |
|
|
| Map lässt sich nicht öffnen | Ist es wirklich eine `.svmap`-Datei? |
|
|
|
|
---
|
|
*Technischer Hintergrund: die Modelle werden zur Laufzeit per GLTFDocument
|
|
aus dem `models/`-Ordner geladen (siehe `src/viewport/glb_mesh_store.gd`,
|
|
Quellen-Reihenfolge: Einstellungen → Nachbar-Ordner `../scopedvr-client` →
|
|
`models/`). Erster Treffer gewinnt.*
|