Wiki aufgebaut

Entwicklung.md

@@ -0,0 +1,57 @@
+# Entwicklung
+
+Es gibt bewusst keine CI: die Workflows aus dem Original liefen gegen Qbox'
+Discord und GitHub-Releases. Gelintet wird lokal vor dem Commit.
+
+```bash
+node ../.tools/lint.mjs             # Lua-Lint, CfxLua-tauglich
+node ../.tools/nui-preview.mjs nui  # HUD im Browser anschauen
+node docs/gen-hud-svg.mjs docs      # Renderings fürs Wiki neu bauen
+
+# Item-Icons neu bauen (SVG -> PNG, braucht ImageMagick mit librsvg)
+node icons/gen-icons.mjs
+for f in icons/src/*.svg; do
+  magick -background none "$f" -resize 128x128 "icons/$(basename "$f" .svg).png"
+done
+```
+
+`gen-icons.mjs` schreibt außerdem `icons/_check.html` — alle Icons auf
+Schachbrett, in Slot-Größe und klein, zum Gegenschauen nach Änderungen.
+
+> librsvg 2.40 wirft beim Rendern der Zahlen ein
+> `Invalid UTF-8 string passed to pango_layout_set_text()`. Das ist harmlos und
+> passiert bei jedem `<text>`-Element, auch im minimalsten Testfall — die Zahlen
+> kommen korrekt raus.
+
+## Wo was liegt
+
+| Pfad | Inhalt |
+|---|---|
+| `client/main.lua` | Ausrüstung, Sauerstoff, Tiefenrausch, HUD-Anbindung |
+| `client/light.lua` | Lampe, ohne gemeinsamen Zustand mit main.lua |
+| `server/main.lua` | Useable Items, Metadata, Besitz- und Plausibilitätsprüfung |
+| `config/client.lua` | Alles rein Clientseitige |
+| `config/shared.lua` | Flaschen, Item-Namen, Sync-Werte |
+| `nui/` | Die Tauchkonsole |
+| `docs/`, `icons/` | Bilder und ihre Generatoren |
+
+## Offene Punkte
+
+- Nach einem Relog muss die Ausrüstung neu angelegt werden. Die Restluft
+  überlebt, die liegt auf der Flasche.
+- Die HUD-Position ist nur in `nui/style.css` einstellbar, nicht in der Config.
+- `IsHudHidden()` — ob die Native auf `DisplayHud(false)` anspringt, ist
+  ungeprüft. Falls nicht, greifen Taste und Export weiterhin.
+- Die `timecycle`-Namen des Tiefenrauschs sind nicht verifiziert.
+- Balancing: Laufzeiten und Narkose-Stufen sind nicht über längere Zeit am
+  Spielgefühl geprüft.
+
+Warum die Dinge so gebaut sind und welche Fallstricke dahinterstecken, steht
+code-nah im Repo: [ENTSCHEIDUNGEN.md](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/raw/branch/main/ENTSCHEIDUNGEN.md).
+
+---
+
+**Wiki:** [Übersicht](Home) · [Installation](Installation) · [Items](Items) ·
+[Bedienung](Bedienung) · [Konfiguration](Konfiguration) ·
+[Tiefe und Atemgas](Tiefe-und-Atemgas) · [Lampe](Lampe) · [Exports](Exports) ·
+[Entwicklung](Entwicklung)