Files
D4rkst3randClaude Opus 5 1ed6a924f8 chore: aufgeraeumt nach der Abnahme
Lampen-Prop entfernt. Seit der Umstellung auf die spieleigene Scuba-Lampe war es
funktionslos: standardmaessig aus, nie verifiziert, und eine Polizei-Taschenlampe
am Kopf haette neben dem nativen Licht nur Deko gespielt. Damit fallen auch die
Debug-Befehle /divelamp und /divelampcheck weg, samt config.debug und vier
Config-Werten.

Zwoelf Upstream-Locales geloescht. Sie hatten 8 von 26 Keys - im Spiel waeren
dort rohe Key-Namen erschienen. Gepflegt werden DE und EN.

PLAN.md war ein Vorab-Plan mit Phasen und Aufwandsschaetzungen und damit
erledigt. Ersetzt durch ENTSCHEIDUNGEN.md: warum die Dinge so gebaut sind und
welche Fallstricke dahinterstecken - onCache-Timing, consume, decay,
SetMetadata, die Atemgas-Grenze, das transform-origin am Zeiger. Also das, was
beim naechsten Anfassen wirklich hilft.

README von den Abschnitten befreit, die es nicht mehr gibt. Bilder und Icons neu
erzeugt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 10:16:04 +02:00

149 lines
6.6 KiB
Lua

return {
putOnSuitTimeMs = 5000,
takeOffSuitTimeMs = 5000,
refillTankTimeMs = 5000,
--- Sekunden Luft, die pro echter Sekunde verbraucht werden (vor dem Tiefenfaktor).
decayRate = 1.0,
--- Intervall des Watchdogs, der prüft ob die Ausrüstung noch am Ped hängt (ms).
gearWatchdogIntervalMs = 1000,
--- Sekunden, die der Spieler ohne Ausrüstung unter Wasser überlebt (Vanilla-Verhalten).
maxTimeUnderwater = 50.0,
--- Sekunden, sobald die Flasche leer ist. Bewusst kurz: leer tauchen soll wehtun.
maxTimeUnderwaterOutOfAir = 1.0,
--- Ausrüstung beim Tod abnehmen. Die Flasche bleibt mit ihrer Restluft im Inventar.
removeGearOnDeath = true,
--- Restsekunden, bei denen gewarnt wird. Jede Schwelle löst einmal pro Tauchgang aus.
warnAtSeconds = { 60, 30, 10 },
--- Verbrauch steigt mit der Tiefe: faktor = 1 + tiefe / depthDecayReference.
--- Standardmäßig aus, damit die angegebenen 5/10/15/20 Minuten exakt stimmen
--- und für Spieler berechenbar bleiben.
depthDecayEnabled = false,
depthDecayReference = 30.0,
maxDecayFactor = 4.0,
--- NUI-HUD mit Luft und Tiefe. Auf false bleibt die Ausrüstung voll nutzbar,
--- nur ohne Anzeige.
hudEnabled = true,
--- Update-Intervall des HUD (ms). 250 = 4 Updates pro Sekunde, reicht für eine
--- ruhige Anzeige ohne unnötigen NUI-Traffic.
hudUpdateIntervalMs = 250,
--- Zusätzlicher Größenfaktor für das HUD. Es skaliert schon von selbst mit
--- der Bildschirmhöhe (entworfen auf 1080p), das hier ist der Geschmacks-
--- regler obendrauf. 1.2 = 20 % größer.
hudScale = 1.0,
--- HUD nur unter Wasser zeigen. Auf false ist es sichtbar, sobald die
--- Ausrüstung angelegt ist - dann lässt sich der Flaschendruck am Finimeter
--- ablesen, ohne extra das Inventar zu öffnen.
hudOnlyUnderwater = false,
--- Tauch-HUD mit ausblenden, sobald das Spiel-HUD ausgeblendet ist.
--- Greift bei allem, was DisplayHud(false) setzt - Screenshot-Scripts,
--- HUD-Toggles, Cinematic-Modes -, ohne dass wir die Resource kennen müssen.
hudFollowGameHud = true,
--- Eigene Taste zum Aus-/Einblenden des Tauch-HUD. Leer = keine Vorbelegung,
--- der Spieler kann sie in den FiveM-Tastenbelegungen unter "FiveM" setzen.
--- Zusätzlich gibt es den Export setHudVisible(bool) für andere Resources.
hudToggleKey = '',
--- Ab dieser Tiefe wird die Tiefenanzeige eingefärbt (Meter).
deepWarningDepth = 25.0,
--- Skalenende des Tiefenmessers (Meter). Echte Tiefenmesser gehen meist bis
--- 60 m; hier lieber so weit, dass auch Trimix-Tauchgänge auf der Skala
--- bleiben. Tiefer schlägt der Zeiger an, die Zahl in der Mitte stimmt weiter.
depthDialMax = 100.0,
---------------------------------------------------------------------------
-- Tiefenrausch
---------------------------------------------------------------------------
-- Macht die Tiefengrenze mechanisch statt zur Absprache: unterhalb der
-- maxDepth der getragenen Flasche (config/shared.lua) wird es ungemütlich.
-- Mit Pressluft ab 45 m, mit Trimix erst ab 100 m - wer die tiefen Spots
-- sehen will, braucht also die richtige Flasche.
narcosis = {
enabled = true,
--- Wie viele Meter *vor* der Grenze schon gewarnt wird.
warnBeforeMeters = 5.0,
--- Tiefe, ab der das Spiel selbst den Spieler über den Wasserdruck tötet.
--- Dagegen hilft keine Flasche - das ist die Engine, nicht dieses Script.
--- Deshalb hier nur eine Warnung, kein eigener Effekt.
--- 160 m ist ingame gemessen: darunter ist Schluss.
engineDepthLimit = 160.0,
engineWarnBeforeMeters = 20.0,
--- Stufen, sobald die Grenze überschritten ist. `over` = Meter unterhalb
--- der maxDepth der Flasche. Es gilt jeweils die höchste erreichte Stufe,
--- die Reihenfolge muss also aufsteigend sein.
---
--- timecycle Bildschirmeffekt. Namen sind Timecycle-Modifier des
--- Spiels, keine Natives - falls einer nicht existiert,
--- passiert einfach nichts. Alternativen zum Ausprobieren:
--- 'drug_flying_base', 'drug_deadman', 'REDMIST',
--- 'spectator5'. Auf nil = kein Effekt.
--- strength 0.0 bis 1.0
--- shake Kamerawackeln, z.B. 'DRUNK_SHAKE', 'SKY_DIVING_SHAKE'.
--- Auf nil = kein Wackeln.
--- shakeIntensity Stärke des Wackelns
--- drainFactor Faktor auf den Luftverbrauch (Stress atmet mehr)
--- damagePerTick Schaden pro Sekunde. 0 = kein Schaden.
stages = {
{
over = 0.0,
timecycle = 'drug_wobbly', strength = 0.3,
shake = nil, shakeIntensity = 0.0,
drainFactor = 1.5, damagePerTick = 0
},
{
over = 10.0,
timecycle = 'drug_wobbly', strength = 0.7,
shake = 'DRUNK_SHAKE', shakeIntensity = 0.3,
drainFactor = 2.0, damagePerTick = 0
},
{
over = 20.0,
timecycle = 'drug_wobbly', strength = 1.0,
shake = 'DRUNK_SHAKE', shakeIntensity = 0.8,
-- Schaden bewusst auf 0: erstmal nur Effekte und höherer
-- Verbrauch. Auf z.B. 2 setzen, wenn es härter sein soll.
drainFactor = 3.0, damagePerTick = 0
},
},
},
--- Reservedruck in bar. Darunter wird die Druckanzeige eingefärbt - in der
--- Tauchpraxis die Schwelle, ab der man den Aufstieg einleitet.
reservePressure = 50,
---------------------------------------------------------------------------
-- Taschenlampe
---------------------------------------------------------------------------
--- Taste zum An- und Ausschalten. Der Spieler kann sie in den FiveM-
--- Tastenbelegungen unter "FiveM" umlegen.
lampKey = 'l',
--- Die Lampe ist die spieleigene Scuba-Lampe (SetEnableScubaGearLight, seit
--- v1493). Sie sitzt an der richtigen Stelle, leuchtet in Blickrichtung und
--- funktioniert auch ohne Scuba-Kleidung am Ped - deshalb gibt es hier weder
--- Prop noch Offsets noch Farb- und Kegelwerte.
--- Wie oft der Lampen-Zustand auf die Peds in der Nähe nachgezogen wird (ms).
--- Nötig, weil Peds beim Streaming, Respawn und Model-Wechsel neu erzeugt
--- werden und den Flag dabei verlieren.
lampReconcileIntervalMs = 500,
}