Wiki aufgebaut

Bedienung.md

@@ -0,0 +1,59 @@
+# Bedienung
+
+Die Flasche wird **nicht** separat angezogen. Sie muss nur im Inventar liegen —
+beim Anlegen der Ausrüstung fragt das Script, welche angeschlossen werden soll.
+
+| Aktion | Wie |
+|---|---|
+| Ausrüstung an-/ausziehen | `diving_gear` benutzen |
+| Flasche wählen | Menü beim Anlegen (entfällt bei nur einer Flasche) |
+| Flasche auffüllen | `diving_fill` benutzen — nicht unter Wasser, nicht bei voller Flasche |
+| Lampe an/aus | `L` |
+| HUD ein-/ausblenden | Eigene Taste, standardmäßig unbelegt |
+
+Beide Tasten sind in den FiveM-Einstellungen unter *Tastenbelegung → FiveM*
+umlegbar.
+
+## Das HUD
+
+Eine Dreier-Konsole wie am echten Tauchgerät: **Finimeter** links, Restluft als
+Ring in der Mitte, **Tiefenmesser** rechts, die Werte darunter auf einer Linie.
+
+Es erscheint, sobald die Ausrüstung angelegt ist — also auch an Land, damit sich
+der Flaschendruck ablesen lässt, ohne das Inventar zu öffnen. Wer es nur unter
+Wasser will: `hudOnlyUnderwater = true`.
+
+**Normal** — Druck im grünen Bereich, flach getaucht, Lampe an
+
+![HUD, normaler Zustand](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/raw/branch/main/docs/hud-normal.svg)
+
+**Warnung** — Zeiger in der Reserve, Restluft unter der ersten Schwelle, Tiefe
+über `deepWarningDepth`
+
+![HUD, Warnstufe](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/raw/branch/main/docs/hud-warnung.svg)
+
+**Kritisch** — unter der Tiefengrenze des Atemgases: der Zeiger steht im roten
+Bereich des Tiefenmessers, die Uhr pulsiert, Tiefenrausch läuft
+
+![HUD, kritisch](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/raw/branch/main/docs/hud-kritisch.svg)
+
+> Die Bilder sind maßstabsgetreue Renderings des Overlays aus denselben Werten
+> wie `nui/style.css`, keine In-Game-Aufnahmen.
+
+## Was passiert wann
+
+| Situation | Folge |
+|---|---|
+| Luft geht zur Neige | Warnungen bei 60, 30 und 10 Sekunden |
+| Flasche leer unter Wasser | Scuba aus, Ertrinken setzt ein |
+| Tod | Ausrüstung kommt ab, die Flasche bleibt mit ihrer Restluft im Inventar |
+| Ausrüstung oder Flasche weggegeben | Ausrüstung kommt sofort ab |
+| Flasche im Inventar verschoben | nichts, der Tauchgang läuft weiter |
+| Unter der Tiefengrenze des Gases | [Tiefenrausch](Tiefe-und-Atemgas) |
+
+---
+
+**Wiki:** [Übersicht](Home) · [Installation](Installation) · [Items](Items) ·
+[Bedienung](Bedienung) · [Konfiguration](Konfiguration) ·
+[Tiefe und Atemgas](Tiefe-und-Atemgas) · [Lampe](Lampe) · [Exports](Exports) ·
+[Entwicklung](Entwicklung)