Entwicklung

Es gibt bewusst keine CI: die Workflows aus dem Original liefen gegen Qbox' Discord und GitHub-Releases. Gelintet wird lokal vor dem Commit.

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.

Wiki: Übersicht · Installation · Items · Bedienung · Konfiguration · Tiefe und Atemgas · Lampe · Exports · Entwicklung