fix(light): Lampen-Sitz konfigurierbar + Debug-Befehle
Lint / Lint Resource (push) Has been cancelled

Offset und Rotation des Lampen-Props waren hart im Code, und die Rotation
(180, 90, 0) war stumpf von der Maske uebernommen - daher stand die Lampe quer
im Gesicht. d4rk_phone haengt sein Prop mit komplett null Offset und Rotation
an, das ist der bessere Ausgangspunkt.

- lampBone, lampPropOffset, lampPropRotation in die Config; Prop und Licht
  haengen jetzt am selben Bone, damit der Strahl aus der Lampe kommt
- lampProp = '' erlaubt, dann nur Licht ohne Prop
- Lichtwerte (Farbe, Reichweite, Helligkeit, Kegel) aus d4rk_phone uebernommen
  statt neu geraten; lampShadows wie dort auf false
- /divelamp und /divelight stellen beides im laufenden Spiel ein und geben die
  Config-Zeile zum Uebernehmen aus (config.debug)

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-11 08:41:22 +02:00
co-authored by Claude Opus 5
parent 043450c54c
commit 037acf1bfe
4 changed files with 132 additions and 27 deletions
+31 -5
View File
@@ -172,12 +172,14 @@ FiveM* umlegbar.
| Option | Default | Bedeutung |
|---|---|---|
| `lampKey` | `'l'` | Vorbelegung |
| `lampProp` | `'prop_cs_police_torch'` | Optik. Ungültiges Model → Warnung im Log, Licht funktioniert trotzdem |
| `lampOffset` | `vec3(0, 0.15, 0)` | Position relativ zum Kopf-Bone |
| `lampBone` | `12844` | Bone für Prop **und** Licht — derselbe, damit der Strahl aus der Lampe kommt. `28422` = Hand statt Kopf |
| `lampProp` | `'prop_cs_police_torch'` | Optik. Ungültiges Model → Warnung im Log, Licht funktioniert trotzdem. `''` = kein Prop |
| `lampPropOffset` / `lampPropRotation` | `vec3(0,0,0)` | Sitz des Props am Bone — mit `/divelamp` einstellen |
| `lampOffset` | `vec3(0,0,0)` | Ursprung des Lichtkegels, bone-relativ |
| `lampDirection` | `vec3(0, 1, 0)` | Richtung des Kegels, bone-relativ |
| `lampColour` | `{225, 245, 255}` | RGB |
| `lampDistance` / `lampBrightness` / `lampRoundness` / `lampRadius` / `lampFalloff` | `30/6/1/14/1.5` | Form des Lichtkegels |
| `lampShadows` | `true` | `false` nutzt `DrawSpotLight` statt der Schattenvariante — flacher, aber spürbar schneller |
| `lampColour` | `{255, 250, 235}` | RGB |
| `lampDistance` / `lampBrightness` / `lampRoundness` / `lampRadius` / `lampFalloff` | `28/3/0/16/2` | Form des Lichtkegels, Werte aus `d4rk_phone` übernommen |
| `lampShadows` | `false` | `true` nutzt `DrawSpotLightWithShadow` — sieht besser aus, kostet aber deutlich Performance |
| `lampDrawDistance` | `45.0` | Ab hier werden fremde Lampen nicht mehr gezeichnet |
| `lampMaxLights` | `4` | Gleichzeitige Lampen, die nächstgelegenen gewinnen |
@@ -185,6 +187,30 @@ FiveM* umlegbar.
> `maxDecayFactor` (client) liegen. Sonst hält der Server den ehrlichen Verbrauch
> in großer Tiefe für Cheat und schreibt Luft zurück.
## Lampe einstellen
Wo Prop und Lichtkegel am Kopf sitzen, hängt daran, wie das Prop-Model selbst
ausgerichtet ist — das lässt sich nicht am Schreibtisch erraten. Mit
`debug = true` in `config/client.lua` gibt es zwei Befehle, die die Werte im
laufenden Spiel ändern und die fertige Config-Zeile ins Log schreiben:
```
/divelamp <x> <y> <z> <rx> <ry> <rz> Sitz des Lampen-Props
/divelight <x> <y> <z> <dx> <dy> <dz> Ursprung und Richtung des Lichtkegels
```
Das Prop wird sofort neu angehängt, das Licht zieht ohne Verzögerung mit — kein
Resource-Restart pro Versuch. Sind die Werte gut, die ausgegebenen Zeilen in die
Config übernehmen und `debug` wieder ausschalten.
Alternativ mit einem Prop-Attach-Editor wie
[noted_propattacher](https://github.com/NotedDevelopment/noted_propattacher)
ausmessen: Prop spawnen, mit der Maus an die Stelle ziehen, Werte übernehmen.
> Im Basegame gibt es **keine** Tauchlampe. `prop_cs_police_torch` ist eine
> Polizei-Taschenlampe; Varianten davon sind `prop_police_torch` und
> `prop_scn_police_torch`. Wer eine echte Tauchlampe will, braucht ein Custom-Model.
## Exports
```lua