Installation

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

Installationsschritte

Um FiveNet mit Ihrem FiveM-Gameserver zu integrieren:

Plugin herunterladen
- Laden Sie den FiveM-Plugin-Code von GitHub herunter.
- Verwenden Sie die neueste Version, um Kompatibilitätsprobleme mit neueren FiveNet-Releases zu vermeiden.
Plugin installieren
- Legen Sie die Plugin-Dateien im resources-Verzeichnis Ihres FiveM-Servers ab.
- Stellen Sie sicher, dass der Ressourcenordner fivenet heißt, sofern Sie Ihre Serverkonfiguration nicht bewusst auf einen anderen Namen anpassen.

Hinweis: Aktuell müssen Sie die yarn-Builder-Systemressource patchen, damit das FiveNet-Plugin funktioniert. Dies ist eine temporäre Übergangslösung, bis FiveM offiziell auf eine neuere Node.js-Version umstellt.Aktualisieren Sie in yarn/yarn_builder.js die an yarn install übergebenen Argumente, sodass das Flag --ignore-engines enthalten ist. Dadurch kann der Plugin-Build Engine-Prüfungen umgehen, die nicht zu Ihrer FiveM-Umgebung passen.

#diff a/[builders]/yarn/yarn_builder.js b/[builders]/yarn/yarn_builder.js
@@ -43,7 +43,7 @@
            currentBuildingModule = resourceName;
            const proc = child_process.fork(
                require.resolve('./yarn_cli.js'),
-               ['install', '--ignore-scripts', '--cache-folder', path.join(initCwd, 'cache', 'yarn-cache'), '--mutex', 'file:' + path.join(initCwd, 'cache', 'yarn-mutex')],
+               ['install', '--ignore-scripts', '--ignore-engines', '--cache-folder', path.join(initCwd, 'cache', 'yarn-cache'), '--mutex', 'file:' + path.join(initCwd, 'cache', 'yarn-mutex')],
                {
                    cwd: path.resolve(GetResourcePath(resourceName)),
                    stdio: 'pipe',

Plugin konfigurieren
- Öffnen Sie config/client.lua und config/server.lua.
- Passen Sie die Werte so an, dass sie zu Ihrer FiveNet-Instanz, Ihrem Framework und Ihren Serveranforderungen passen.
- Folgen Sie der Plugin-Konfigurationsseite für die wichtigsten Optionen.
Event-Trigger hinzufügen
- Prüfen Sie Ihre vorhandenen Framework- und jobbezogenen Plugins und fügen Sie die notwendigen Event-Trigger hinzu, damit FiveNet die erforderlichen Aktivitätsdaten erfassen kann.
- Nicht alle benötigten Events sind in Standard-ESX-basierten Ressourcen vorhanden, daher können Anpassungen nötig sein.
Plugin starten
- Fügen Sie das Plugin Ihrer server.cfg hinzu:
```
ensure fivenet
```
- Starten Sie Ihren Server neu, damit die Ressource geladen wird.

Nach der Installation

Sobald das Plugin installiert ist:

prüfen Sie, ob das Plugin Ihre FiveNet-Instanz erreichen kann
verifizieren Sie, dass API-Host und Token korrekt konfiguriert sind
testen Sie das Tablet im Spiel und prüfen Sie, ob die erwarteten Sync- und Event-Funktionen funktionieren

Wichtig:

Lesen Sie immer die Datei README.md, die mit dem Plugin bereitgestellt wird, für detaillierte Setup-Anweisungen und Tipps zur Fehlerbehebung.
Stellen Sie sicher, dass Ihr Server eine kompatible Version von FiveM und dem gewählten Framework ausführt, um Konflikte zu vermeiden.

DBSync: Installieren und konfigurieren

Verwenden Sie diese Anleitung, wenn FiveNet Charaktere, Fahrzeuge und andere Daten aus Ihrer Gameserver-Datenbank übernehmen soll, ohne dass der FiveNet-Server direkten Datenbankzugriff benötigt.

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.