Configuration

Konfiguration

Alles, was ein Serverbesitzer anpassen muss, befindet sich in der config.lua, und die Datei ist Abschnitt für Abschnitt kommentiert. Berechtigungen, Dauer und Limits werden unter Permissions & Duration behandelt; der Webhook hat eine eigene page. Diese Seite behandelt den Rest.

Allgemein

config.lua

Config.Command      = 'status'
Config.Keybind      = ''             -- 'F6', 'F7', 'INSERT'… leer deaktiviert es
Config.ClearCommand = 'statusclear'
Config.Debug        = false

Welt-Text

Was andere Spieler über dem Ped schweben sehen.

Option	Standard	Zweck
`Config.Text.ViewDistance`	`6.0`	Nichts wird jenseits dieser Distanz in Metern gerendert.
`Config.Text.ScanInterval`	`800`	Wie oft (ms) der Client nach Spielern in der Nähe sucht, die Notizen bei sich tragen. Höher ist performancefreundlicher und erscheint langsamer.
`Config.Text.Size`	`0.34`	Basisskalierung; das Script skaliert auch mit der Kameradistanz.
`Config.Text.Font`	`4`	GTA-Schriftarten-ID – 0 Chalet, 1 Sign, 2 Slab, 4 Chalet Comprime, 7 Pricedown.
`Config.Text.Outline`	`true`	Dunkle Umrandung hinter dem Text, damit er auf jeder Oberfläche lesbar bleibt.
`Config.Text.MinScale` / `MaxScale`	`0.10` / `0.58`	Begrenzung, damit Text nie unleserlich oder komisch groß wird.
`Config.Text.Alpha`	`225`	Text-Opazität, 0–255.
`Config.Text.ColorBySeverity`	`true`	Den Text mit der Schweregrad-Farbe einfärben. `false` = immer weiß.
`Config.Text.White`	`255, 255, 255`	Farbe, wenn die Schweregrad-Färbung deaktiviert oder unbekannt ist.
`Config.Text.OnlyWhileAiming`	`false`	Nur rendern, während der Beobachter die Zieltaste gedrückt hält.

Kamera

Das Panel öffnet sich über einer transparenten Benutzeroberfläche und die Spielkamera erledigt die Arbeit.

Option	Standard	Zweck
`Config.Camera.AutoFrame`	`true`	Misst den Kopf bis zu den Füßen des Peds und rahmt es automatisch ein. Empfohlen – funktioniert mit jedem Ped-Modell.
`Config.Camera.Fill`	`0.88`	Wie viel der Bildschirmhöhe der Körper einnimmt, wenn `AutoFrame` aktiv ist.
`Config.Camera.VerticalNudge`	`0.0`	Feinabstimmung in Metern. Positive Werte bewegen den Charakter nach unten auf dem Bildschirm.
`Config.Camera.Distance`	`3.35`	Abstand zum Ped – wird nur verwendet, wenn `AutoFrame` auf `false` steht.
`Config.Camera.Height`	`0.95`	Höhe, auf die die Kamera blickt – wird nur verwendet, wenn `AutoFrame` auf `false` steht.
`Config.Camera.SideOffset`	`0.45`	Schiebt das Ped nach links, damit das Panel es niemals verdeckt. `0` zentriert es.
`Config.Camera.Fov`	`34.0`	Niedriger entspricht eher einem Porträtobjektiv mit weniger Verzerrung.
`Config.Camera.ZoomMin` / `ZoomMax` / `ZoomStep`	`1.60` / `4.60` / `0.20`	Zoom-Limits und die Schrittweite pro Tastendruck.
`Config.Camera.RotateSensitivity`	`0.6`	Grad, um die sich das Ped pro Pixel Mausbewegung dreht.
`Config.Camera.FreezePlayer`	`true`	Das Ped einfrieren, während das Panel geöffnet ist.
`Config.Camera.HideRadar`	`true`	Die Minikarte ausblenden, während das Panel geöffnet ist.
`Config.Camera.HotspotRefresh`	`30`	Wie oft (ms) Knochenpositionen an die Benutzeroberfläche übermittelt werden. Auf sehr ausgelasteten Servern auf 50–60 erhöhen.

ℹ

Wenn AutoFrame aktiv ist, werden die Zoom-Limits aus dem gemessenen Bildausschnitt anstatt aus ZoomMin / ZoomMax abgeleitet, sodass die Tasten unabhängig von der Größe des Peds immer sinnvoll reagieren.

Oberfläche

config.lua

Config.UI = {
    Accent        = '#5b6cf0',  -- jede CSS-Farbe
    Watermark     = true,       -- handgezeichnetes "Status"-Wasserzeichen hinter dem Charakter
    ShowSeverity  = true,
    ShowTypes     = true,
    CloseOnEscape = true,
}

Typen und Schweregrade

Beides sind einfache Listen. Die Benutzeroberfläche passt sich an alles an, was Sie dort eintragen; Beschriftungen stammen aus den Sprachdateien.

config.lua

Config.Types = {
    { id = 'injury',  icon = 'activity' },  -- Label: type_injury
    { id = 'bandage', icon = 'plus'     },
    { id = 'note',    icon = 'message'  },
}

Config.Severities = {
    { id = 'minor',    color = { r = 143, g = 214, b = 171 } },
    { id = 'moderate', color = { r = 195, g = 201, b = 209 } },
    { id = 'severe',   color = { r = 255, g = 154, b = 157 } },
}

icon ist ein von der Benutzeroberfläche gerenderter Lucide-Icon-Name. Das Hinzufügen eines Eintrags erfordert eine passende type_<id>- oder sev_<id>-Zeile in jeder Sprachdatei.

Körperteile

Standardmäßig sind sechzehn Regionen enthalten, die jeweils an einem GTA-Ped-Knochen verankert sind.

config.lua

{ id = 'head', bone = 31086, offset = { x = 0.0, y = 0.0, z = 0.28 } },

Feld	Bedeutung
`bone`	Der Ped-Knochenindex, an dem die Notiz verankert ist.
`offset`	Verschiebt den schwebenden Welt-Text vom Knochen weg, damit er nicht im Modell versinkt. Erhöhen Sie `z`, wenn Text in Kleidung clipt. Dies bewegt nicht die anklickbare Markierung.
`marker`	Optional. Verschiebt ausschließlich die anklickbare Markierung im Panel. Wenn Sie dies weglassen, sitzt die Markierung exakt auf dem Knochen, was in fast allen Fällen korrekt ist.

Das Entfernen eines Eintrags blendet diese Region überall aus. Das Hinzufügen erfordert einen gültigen Knochenindex und eine passende bp_<id>-Zeile in jeder Sprachdatei.

Erweitert

config.lua

Config.Table = 'bupa_syncstatus'  -- wird beim ersten Start automatisch erstellt

⚠

Die Lookup-Tabellen am Ende der config.lua (Config.BodyPartMap, Config.TypeMap, Config.SeverityMap) werden beim Start aus den obigen Listen generiert. Bearbeiten Sie diese nicht manuell.

PreviousPermissions & Duration Next Discord Logging