FJX Studios Dokumentation
Shop Discord

Konfiguration

Alle Werte der config.lua — Erkennung, Benachrichtigungen, Effekte und Performance.

Zuletzt aktualisiert: 21. August 2026

FLIPREACTION Auto-Detect ist über die Datei config.lua umfassend anpassbar. Diese Seite erklärt alle Konfigurationsoptionen und wie sie verwendet werden.

Framework-spezifische Einstellungen überschreiben immer die allgemeinen. Setzt du Config.NotificationMessage und Config.ESX.NotificationMessage, gilt unter ESX die ESX-Variante.

Erkennung

config.lua
lua
FlipAngleThreshold = 75.0        -- Winkel in Grad, ab dem ein Überschlag zählt
MinSpeedForTrigger = 20.0        -- Mindestgeschwindigkeit (km/h) für die Erkennung
DetectionCooldown = 3000         -- Abklingzeit in ms zwischen zwei Erkennungen
FlipAngleThresholdnumberStandard: 75.0

Wie weit das Fahrzeug gekippt sein muss (in Grad), um als überschlagen zu gelten. Niedrigere Werte machen die Erkennung empfindlicher.

MinSpeedForTriggernumberStandard: 20.0

Das Fahrzeug muss mindestens so schnell fahren (km/h), damit die Überschlagserkennung aktiviert wird. Verhindert, dass stehende oder langsame Fahrzeugüberschläge das System auslösen.

DetectionCooldownnumberStandard: 3000

Mindestzeit in Millisekunden zwischen zwei Erkennungen. Verhindert mehrfache Auslösungen während eines einzelnen Überschlagsereignisses.

Benachrichtigungen (allgemein)

Diese Einstellungen gelten unabhängig davon, welches Framework erkannt wird.

config.lua
lua
EnableNotification = true         -- Benachrichtigungen bei Überschlägen aktivieren
CustomNotificationEvent = ""      -- Eigener Event-Name (leer lassen für Standard)
NotificationTitle = "Warnung"     -- Allgemeiner Titel
NotificationMessage = "Dein Fahrzeug hat sich überschlagen!"
EnableNotificationbooleanStandard: true

Auf true setzen, um Benachrichtigungen bei Fahrzeugüberschlägen anzuzeigen, false um sie zu deaktivieren.

CustomNotificationEventstringStandard: ""

Verwendet dein Server ein eigenes Benachrichtigungssystem, trägst du hier dessen Event-Namen ein.

NotificationTitlestringStandard: "Warnung"

Der Titel, der in Benachrichtigungen angezeigt wird — von beiden Frameworks verwendet.

NotificationMessagestring

Der Nachrichtentext, der in Benachrichtigungen angezeigt wird — von beiden Frameworks verwendet.

Benachrichtigungen je Framework

Diese Einstellungen gelten nur, wenn ESX erkannt wird.

config.lua
lua
ESX = {
    NotificationTitle = "Warnung",
    NotificationSubtitle = "Fahrzeugüberschlag",
    NotificationMessage = "Dein Fahrzeug hat sich überschlagen!",
    NotificationIcon = "CHAR_CARSITE",
    NotificationIconType = 1
}
Wert Bedeutung
NotificationTitle Überschreibt den allgemeinen Titel für ESX
NotificationSubtitle Untertitel der ESX-Benachrichtigung
NotificationMessage Überschreibt die allgemeine Nachricht für ESX
NotificationIcon Name des GTA-V-Texturdictionary für das Symbol
NotificationIconType Typ des Benachrichtigungssymbols

Diese Einstellungen gelten nur, wenn QBCore erkannt wird.

config.lua
lua
QBCore = {
    NotificationType = "error",
    NotificationMessage = "Dein Fahrzeug hat sich überschlagen!",
    NotificationDuration = 5000
}
Wert Bedeutung
NotificationType Stil der Benachrichtigung: success, error, info, primary
NotificationMessage Überschreibt die allgemeine Nachricht für QBCore
NotificationDuration Anzeigedauer in Millisekunden

Spielereffekte

config.lua
lua
EjectPlayerOnFlip = false         -- Spieler bei Überschlag aus dem Fahrzeug werfen
DamageOnFlip = true               -- Spieler bekommt Schaden beim Überschlag
DamageAmount = 25                 -- Schadensmenge (Gesundheitspunkte)
EjectPlayerOnFlipbooleanStandard: false

Wenn true, wird der Spieler beim Überschlag aus dem Fahrzeug geworfen.

DamageOnFlipbooleanStandard: true

Wenn true, erleidet der Spieler Schaden, wenn sein Fahrzeug überschlägt.

DamageAmountnumberStandard: 25

Wie viele Gesundheitspunkte dem Spieler beim Fahrzeugüberschlag abgezogen werden.

Performance

config.lua
lua
CheckFrequencyNormal = 500        -- Prüfintervall bei normaler Fahrt (ms)
CheckFrequencyFast = 100          -- Prüfintervall bei hoher Geschwindigkeit (ms)
IdleCheckFrequency = 1000         -- Prüfintervall ausserhalb eines Fahrzeugs (ms)
CheckFrequencyNormalnumberStandard: 500

Beim Fahren unter der Mindestauslösegeschwindigkeit: wie oft auf Überschläge geprüft wird (in Millisekunden).

CheckFrequencyFastnumberStandard: 100

Beim Fahren über der Mindestauslösegeschwindigkeit: wie oft auf Überschläge geprüft wird (in Millisekunden).

IdleCheckFrequencynumberStandard: 1000

Wie oft geprüft wird, wenn der Spieler in keinem Fahrzeug sitzt (in Millisekunden).

Höhere Werte bedeuten seltenere Prüfungen. Das verbessert die Serverleistung, kann die Überschlagserkennung aber weniger reaktionsschnell machen.

Eigenes Benachrichtigungssystem

Verwendet dein Server ein eigenes Benachrichtigungssystem, lässt es sich direkt einbinden:

Benachrichtigungen aktivieren

Setze EnableNotification = true.

Event eintragen

Setze CustomNotificationEvent auf den Event-Namen deines Benachrichtigungssystems.

Fertig

Bei einem erkannten Überschlag löst das Skript deinen Event mit Titel und Nachricht aus:

lua
TriggerEvent(Config.CustomNotificationEvent, Config.NotificationTitle, Config.NotificationMessage)

Viele verbreitete Benachrichtigungs-Resourcen werden auf diese Weise unterstützt, zum Beispiel:

  • okokNotify
  • mythic_notify
  • pNotify
  • t-notify

Einstellungen mischen

Die Auto-Detect-Version erlaubt unterschiedliches Verhalten je nach erkanntem Framework:

config.lua
lua
-- Für beide Frameworks
Config.DamageOnFlip = true
Config.DamageAmount = 25

-- Einzelne Einstellungen pro Framework überschreiben
Config.ESX.NotificationIcon = "CHAR_INSURANCE"  -- betrifft nur ESX
Config.QBCore.NotificationType = "success"      -- betrifft nur QBCore

So lässt sich das Verhalten gezielt auf die Fähigkeiten des jeweiligen Frameworks zuschneiden.

Beispiel-Konfigurationen

lua
FlipAngleThreshold = 80.0        -- höherer Schwellenwert, realistischere Erkennung
MinSpeedForTrigger = 30.0        -- höhere Mindestgeschwindigkeit
DetectionCooldown = 5000         -- längere Abklingzeit
EjectPlayerOnFlip = true         -- Spieler auswerfen
DamageOnFlip = true
DamageAmount = 40                -- mehr Schaden

ESX = {
    NotificationIcon = "CHAR_CALL911",
    NotificationMessage = "Dein Fahrzeug hat sich überschlagen. Rettungsdienste wurden benachrichtigt."
}
QBCore = {
    NotificationType = "error",
    NotificationDuration = 8000
}
lua
CheckFrequencyNormal = 800        -- seltenere Prüfungen
CheckFrequencyFast = 200          -- seltenere Prüfungen bei Geschwindigkeit
IdleCheckFrequency = 2000         -- deutlich seltenere Leerlaufprüfungen
lua
FlipAngleThreshold = 60.0        -- niedrigerer Schwellenwert, häufigere Erkennung
MinSpeedForTrigger = 10.0        -- niedrigere Mindestgeschwindigkeit
DetectionCooldown = 1500         -- kürzere Abklingzeit
EjectPlayerOnFlip = false        -- kein Auswerfen
DamageOnFlip = false             -- kein Schaden

ESX = {
    NotificationMessage = "Wow! Dein Fahrzeug hat gerade einen Flip gemacht!"
}
QBCore = {
    NotificationType = "primary",
    NotificationMessage = "Wow! Dein Fahrzeug hat gerade einen Flip gemacht!"
}

Über die framework-spezifischen Abschnitte sind Benachrichtigungen und Funktionen für ESX oder QBCore optimiert, ohne dass du den Skriptcode ändern musst.