scopedvr-operator ab173ac8aa T2 Ueberall installierbar (Operator-Push): Modelle aus mitgeliefertem models/-Ordner

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.

2026-10-20 09:43:05 +00:00

3.5 KiB

Raw Blame History

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

App starten.
Map öffnen: Datei → Map öffnen, dann die gewünschte .svmap-Datei wählen.
Zum Testen: Taste F5 drücken. Du läufst dann selbst durch die Map (WASD = gehen, Maus = umsehen, Shift = rennen, Leertaste = springen).
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.

3.5 KiB Raw Blame History