Konfiguration

Konfigurieren Sie das FiveNet-FiveM-Plugin so, dass es sich mit Ihrer FiveNet-Instanz verbindet und sich in Ihr Framework, Dispatch- und Tracking-Setup integriert.

Bevor Sie beginnen

Bevor Sie die Plugin-Konfiguration anpassen, stellen Sie sicher, dass:

Ihre FiveNet-Instanz vom Gameserver aus erreichbar ist
das Sync-API-Token in FiveNet konfiguriert ist
Sie wissen, welches Framework der Server verwendet, zum Beispiel esx oder qbcore

Mindestanforderungen an die Einstellungen

Prüfen Sie mindestens diese Werte, bevor Sie das Plugin starten:

Config.WebURL in config/client.lua
Config.Framework in config/server.lua
Config.API.Host in config/server.lua
Config.API.Token in config/server.lua

Wenn diese Werte falsch sind, funktioniert das Ingame-Tablet oder die Plugin-Integration nicht korrekt.

Konfigurationsreferenz

Client-Seite

Die clientseitige Konfiguration befindet sich in config/client.lua.

Option	Standardwert	Beschreibung
`Config.WebURL`	`'https://demo.fivenet.app'`	Ihre FiveNet-URL ohne abschließenden Schrägstrich.
`Config.Hotkey.Enable`	`true`	Ob die Tablet-Hotkey-Funktion registriert werden soll.
`Config.Hotkey.Key`	`'F5'`	Die Taste, die für den Tablet-Hotkey verwendet wird.
`Config.PostalCommand`	`'plz'`	Befehl, um die Postleitzahl auf der Karte des Spielers zu markieren.

Server-Seite

Die serverseitige Konfiguration befindet sich in config/server.lua.

Option	Standardwert	Beschreibung
`Config.Framework`	`'esx'`	Das verwendete Framework. Kann `esx` oder `qbcore` sein.
`Config.API.Host`	`'demo.fivenet.app:443'`	Der FiveNet-Hostname, muss den Port enthalten, wenn nicht 443, erfordert HTTPS.
`Config.API.Token`	`'YOUR_SYNC_API_TOKEN'`	Der API-Token für FiveNet.
`Config.API.Insecure`	`false`	Ob unsichere Verbindungen erlaubt sind.
`Config.TrackCharIDs`	`true`	Ob die letzte Charakter-ID aufgezeichnet werden soll.
`Config.Tracking.Enable`	`true`	Aktivieren oder Deaktivieren des Spieler-Trackings.
`Config.Tracking.Jobs`	`{ ['ambulance'] = true, ['doj'] = true, ['police'] = true }`	Jobs, die verfolgt werden.
`Config.Tracking.Item`	`'radio'`	Spieler ohne diesen Gegenstand werden als "versteckt" markiert.
`Config.Tracking.Interval`	`3000`	Intervall in Millisekunden für Positionsaktualisierungen.
`Config.TimeclockJobs`	`{ ['ambulance'] = true, ['doj'] = true, ['police'] = true }`	Jobs, die für Zeiterfassungszwecke verfolgt werden.
`Config.Events.BillingJobs`	`{ ['doj'] = true, ['police'] = true }`	Jobs, die Benutzeraktivitäten für Abrechnungszyklusereignisse auslösen.
`Config.Discord.ConnectOnJoin`	`true`	Automatisch Discord-OAuth2-Verbindungen erstellen, wenn ein Spieler mit einer Discord-ID beitritt.
`Config.Discord.OAuth2Provider`	`'discord'`	Name des Discord-OAuth2-Providers aus der FiveNet-Serverkonfiguration.
`Config.Dispatches.CivilProtectionJobs`	`{ ['police'] = true }`	Jobs, die Dispatches erhalten, die über die Funktion `createCivilProtectionJobDispatch` erstellt wurden.
`Config.Dispatches.PanicButtonTitle`	`'Panikknopf ausgelöst'`	Titel für den Panikknopf-Dispatch.
`Config.UserProps.SetBloodType`	`true`	Aktivieren der Einstellung der Blutgruppe für einen Benutzer beim "join/loaded"-Ereignis.
`Config.UserProps.BloodTypes`	`{ 'A+', 'A-', 'B+', 'B-', 'AB+', 'AB-', 'O+', 'O-' }`	Blutgruppen, die Benutzern zugewiesen werden, wenn sie noch nicht festgelegt sind.

Einige Plugin-Integrationen hängen von den Functions-Definitionen in den Konfigurationsdateien ab. Diese Funktionen dienen als Integrationspunkte für Sprachsysteme, Inventarsysteme, Duty-Prüfungen und ähnliches framework-spezifisches Verhalten.

Stellen Sie sicher, dass die erforderlichen Funktionen für die Ressourcen implementiert sind, die Ihr Server verwendet.

Nachfolgend finden Sie Beispiele für client- und serverseitige Funktionen.

Client-Seite

Wenn Sie pma-voice verwenden, implementieren Sie SetRadioFrequency in Ihrem clientseitigen Skript. Diese Funktion ist dafür verantwortlich, die Funkfrequenz des Spielers zu setzen.

-- Funkfrequenz einstellen
Functions.SetRadioFrequency = function(frequency --[[number]])
    -- Dies ist für pma-voice
    local currentChannel = exports['pma-voice']:getRadioChannel()

    if currentChannel ~= frequency then
        TriggerEvent('tgiann-radio:t', frequency)
    end
end

Server-Seite

Wenn Sie esx oder qbcore verwenden, implementieren Sie CheckIfPlayerHidden in Ihrem serverseitigen Skript. Diese Funktion prüft, ob ein Spieler basierend auf seinem Duty-Status und dem erforderlichen Tracking-Gegenstand im Inventar verborgen sein soll.

-- Spieler-Tracker - Versteckt-Funktion überprüfen
Functions.CheckIfPlayerHidden = function(xPlayer)
    if Config.Framework == 'esx' then
        -- ESX
        return not xPlayer.job.onDuty or (Config.Tracking.Item and not xPlayer.getInventoryItem(Config.Tracking.Item))
    elseif Config.Framework == 'qbcore' then
        -- QBCore
        return not xPlayer.PlayerData.job.onduty or (Config.Tracking.Item and not exports['qb-inventory']:HasItem(xPlayer.PlayerData.source, Config.Tracking.Item))
    else
        -- Fallback
        return false
    end
end

Hinweise

Behandeln Sie die Plugin-Konfiguration als umgebungsspezifisch und prüfen Sie sie erneut, wenn Sie Ihre FiveNet-URL, Ihr API-Token, Ihr Framework oder Voice-/Inventar-Ressourcen ändern.
Falls Tracking, Dispatches oder Aktivitätsereignisse nicht wie erwartet funktionieren, prüfen Sie sowohl die Konfigurationswerte als auch die erforderlichen benutzerdefinierten Functions.

Installation

Installieren Sie das FiveNet-FiveM-Plugin, um Ihren Gameserver mit Ihrer FiveNet-Instanz zu verbinden.

Referenz

Referenzmaterial für den Betrieb und die Wartung von FiveNet.