scopedvr-map-editor/docs/tasten.md
Hermes (godot-vr) 7521db7f8d Map-Editor: RMB = Flug mit absolutem Vorrang (t_2470de89) — Terrain-Senken auf Strg+LMB, Hand-Objekt-Abwurf auf Esc.
- Terrain-Pinsel: Rechtsklick startet keinen Strich mehr; Strg+LMB invertiert
  (Heben↔Senken, Blender/Photoshop-Konvention; Malen: Strg+Klick = Gras zurück).
- Platzieren: RMB bricht nicht mehr ab — Objekt bleibt in der Hand, Abwurf nur
  über Esc. build_tool/spawn_tool: RMB-Deselect/Werkzeugwechsel entfernt
  (Auswahl-Deselect = Esc / LMB auf Leere).
- orbit_camera: rmb_filter entfernt — Flug startet in JEDEM Werkzeugzustand.
- docs/tasten.md + H-Overlay + Status-/Paneltexte aktualisiert.
- Neuer Test tests/test_rmb_vorrang.gd (32 Checks, echte Main-UI headless);
  in tools/run_tests.sh aufgenommen. Suite grün (test_glb_view: 12/22 FAIL auch
  auf origin/main — fehlende GLB-Quellen im Scratch-Workspace, umgebungsbedingt).
2026-10-17 17:37:09 +00:00

7.5 KiB
Raw Blame History

Tastatur & Maus — Map-Editor

Deutsche Tastenbelegung des ScopedVR Map-Editors. Diese Datei ist die Source of truth für alle Shortcut-Karten — FINALE Version nach allen drei Karten: Karte 1/3 (t_c46d31c2): Navigation, Auswahl, Löschen · Karte 2/3 (t_55257792): Objektmanipulation + Terrain · Karte 3/3 (t_11b5c25b): Datei & Undo, Werkzeugwechsel, Hilfe, Test. Das Kurzhilfe-Overlay im Editor (Taste H) zeigt dieselbe Tabelle (Quelle: src/ui/help_text.gd).

Konventionen (alle Karten):

  • Tastaturcode-basiert: InputMap-Actions mit physischen KEY_*-Konstanten (src/editor/shortcut_keys.gd). Die physische Taste liegt unabhängig vom Tastaturlayout gleich — deutsches (QWERTZ) und Windows-Layout verhalten sich identisch, keine OS-Hardcodes (PLAN.md Plattform-Regel).
  • Jede Objekt-Operation = EIN ActionHistory-Eintrag (Strg+Z nimmt die ganze Operation zurück). Ausnahme: reine Kamera-Aktionen (Orbit/Flug/Zoom) betreffen die Map nicht und sind nicht in der Historie.
  • Strg halten = temporärer Snap-Zwang (Karte 2/3): egal was der Raster-Snap-Schalter sagt — solange Strg unten ist, rastet Bewegen (Ziehen/Greifen) und Platzieren auf ganze Meter.

Navigation (Kamera)

Eingabe Wirkung
Mittlere Maustaste ziehen Orbit: Um die Karte drehen
Mittlere Maustaste + Umschalt ziehen Pan: Karte verschieben
Mausrad Zoom (aus, wenn Mausrad gerade ein Objekt dreht)
Rechte Maustaste GEDACHT halten Freelook-Flug: Umsehen + W vor / S zurück / A links / D rechts; E hoch / Q runter. Funktioniert in JEDEM Werkzeug (Terrain, Bauen, Spawn-Zonen, Platzieren) — die rechte Maustaste hat ABSOLUTEN Vorrang, kein Werkzeug belegt sie (Karte t_2470de89)
Umschalt (im Flug) schneller fliegen (×3)
Alt (im Flug) langsamer fliegen (×0,3)
Mausrad (im Flug) Grundgeschwindigkeit dauerhaft ändern (2–300 m/s)
Umschalt+F Freelook-Flug dauerhaft an/aus (Flug bleibt ohne gedrückte rechte Maustaste aktiv)
F Auswahl ins Bild zentrieren (Focus Selection)

Der Orbit-Modus ist der Default: Beim Verlassen des Flugs springt die Kamera nicht — Ziel/Winkel/Abstand werden aus der Flugposition zurückgerechnet.

Auswahl

Eingabe Wirkung
Linksklick Objekt auswählen (ersetzt die Auswahl)
Strg+Klick (Viewport und Objektbaum) Objekt zur Auswahl hinzufügen/entfernen (Mehrfachauswahl)
Umschalt+Klick wie Strg+Klick (Mehrfachauswahl umschalten)
Ziehen über leeren Boden Rahmen-Aufziehen: alle Objekte im Rahmen wählen
Umschalt + Rahmen Rahmen-Auswahl zur bestehenden Auswahl hinzufügen
Esc Werkzeug abbrechen → Greifen zurückrollen → Ghost-Preview abbrechen → Auswahl aufheben (Prioritätskette)

Alle Bestandsaktionen wirken auf die GANZE Mehrfachauswahl: Entf löscht alle, Strg+D dupliziert alle, Ziehen verschiebt gemeinsam, Anheben/Absenken hebt alle, Strg+G gruppieren / Strg+Umschalt+G lösen.

Objekt-Manipulation (Karte 2/3)

Eingabe Wirkung
R Auswahl 90° drehen (Vierteldrehung; Umschalt+R = −90°). Szene-Objekte drehen um den Auswahl-Mittelpunkt, Bauen-Bauteile um ihren Fußpunkt. Ein Objekt aus einer Gruppe dreht die GANZE Gruppe. Dauerhaft (kein Vorschau-Zustand)
Mausrad (mit Auswahl) Feindrehen im 15°-Raster (bleibt wie bisher)
Pfeiltasten Auswahl im 2-m-Raster verschieben — EINE Zelle pro Tastendruck, Richtung = Kamera-Ausrichtung nächste Weltachse (Godot-Editor-Konvention: ↑ = von der Kamera weg). Fußpunkt bleibt am Raster, Höhe wandert mit
Bild↑ / Bild↓ Auswahl +0,25 m / −0,25 m anheben/absenken (Mehrfachdruck = EIN Undo-Schritt)
Strg+Bild↑ Auswahl direkt auf das Terrain/Boden absetzen (Godot „Snap Object to Floor“-Äquivalent fürs Fußpunkt-Modell)
G Auswahl greifen (Blender-Semantik): sie hängt an der Maus, Linksklick setzt die neue Position (mit Raster-Snap bzw. Strg-Zwang), Esc bricht ab und setzt die exakten alten Positionen zurück. Greifen der ganzen Gruppe/mehreren Objekte wandert gemeinsam
Entf (DELETE) Auswahl SOFORT löschen, ohne Rückfrage — Strg+Z holt alles zurück. Wirkt auf Szene-Auswahl UND Objektbaum-Markierung
Strg+D Auswahl duplizieren: Kopie +2 m in X versetzt (Rasterversatz), Füßpunkt unverändert; bei Mehrfachauswahl ALLE Objekte mit EINEM Undo-Schritt
Strg+G / Strg+Umschalt+G Auswahl gruppieren / Gruppe lösen

Datei & Undo (Karte 3/3)

Vor „Neue Map“ und „Öffnen“ fragt der Editor NACH, wenn die Map noch ungespeicherte Änderungen hat (deutscher Dialog „Verwerfen / Abbrechen“) — nichts geht versehentlich verloren.

Eingabe Wirkung
Strg+Z Rückgängig (EIN Eintrag pro Operation)
Strg+Y UND Strg+Umschalt+Z Wiederherstellen (Redo) — beide Wege sind belegt
Strg+S Map speichern (.svmap, bekannter Pfad; noch nie gespeichert → „Speichern unter“)
Strg+Umschalt+S Map speichern unter …
Strg+O Map öffnen
Strg+N Neue Map

Terrain-Werkzeug (Karte 2/3) — nur aktiv, wenn das Terrain-Werkzeug an ist

Eingabe Wirkung
[ Pinselgröße verkleinern — durch die 3 Presets Klein (4 m) / Mittel (12 m) / Groß (32 m) zyklisch; Preset-Buttons, Slider und Label wandern mit
] Pinselgröße vergrößern (gleicher Zyklus, andere Richtung)
1 Pinselmodus Heben
2 Pinselmodus Senken
3 Pinselmodus Glätten
4 Pinselmodus Malen (mit der zuletzt gewählten Materialfarbe)
Linksklick-Ziehen Boden formen bzw. malen (je nach Pinselmodus)
Strg + Linksklick-Ziehen Gegenteil: bei Heben senkt er, bei Senken hebt er (Invert-Konvention wie Blender/Photoshop); im Malen-Modus malt Strg+Klick Gras zurück
Rechte Maustaste Kein Terrain-Strich mehr — gehört dem Freelook-Flug (absoluter Vorrang, siehe Navigation)
Strg halten temporärer Snap-Zwang beim Objekt-Bewegen/Platzieren (gilt editorweit, nicht nur hier)

Konfliktfreiheit: Die Ziffern 1–4 sind NUR im Terrain-Werkzeug belegt — im Objekt-/Bauen-Modus sind sie unbenutzt, im Flugmodus (rechte Maustaste gehalten) bleiben E/Q die Kamera.

Werkzeuge (Karte 3/3: F-Tasten wechseln das Werkzeug)

Eingabe Wirkung
F1 Werkzeug: Terrain formen
F2 Werkzeug: Objekte platzieren/auswählen (Standard)
F3 Werkzeug: Bauen (Häuser)
F4 Werkzeug: Spawn-Zonen malen
Esc (im Terrain-/Spawn-/Bauen-Werkzeug) Werkzeug beenden — zurück zum Objekt-Werkzeug
Esc (beim Greifen) Greifen abbrechen, alte Positionen zurück
Esc (beim Platzieren) Ghost-Preview abbrechen
Esc (Kurzhilfe offen) Kurzhilfe schließen

F1–F4 und F5/H wirken NUR, wenn kein Textfeld/SpinBox fokussiert ist und kein Dialog offen ist (ShortcutPolicy) — Tippen geht immer vor.

Die Terrain-Ziffern 1–4 und [ / ] bleiben (Karte 2/3) NUR im Terrain-Werkzeug belegt — der Werkzeugwechsel läuft jetzt über die F-Tasten, nicht über Ziffern.

Hilfe & Test (Karte 3/3)

Eingabe Wirkung
H Kurzhilfe-Overlay an/aus — alle Tasten dieser Datei als Panel über der Karte; Esc schließt ebenfalls. Nicht-blockierend: der Editor bleibt bedienbar
F5 ▶ Karte testen (aktuelle Map sofort als Spiel durchlaufen; der Editor bleibt offen)

Die Statuszeile unten zeigt PERMANENT das aktive Werkzeug („Werkzeug: …“) plus den Hinweis „Umschalt+F = Flugmodus“ — man sieht immer, wo man ist.