Ein Discord-Bot für FiveM-Server mit ESX, QBCore, Qbox, ox_core und vRP

FiveBot ist ein Discord-Bot für Tickets, Moderation und KI-Antworten aus Ihren eigenen Regeln. Dazu gehört eine FiveM-Ressource, fivebot_bridge, die Ihren Gameserver mit demselben Dashboard verbindet. Die Discord-Seite funktioniert auch ohne sie. Mit ihr wissen Tickets, Meldungen und Banne, wer der Spieler in der Stadt ist.

Was ohne den Gameserver funktioniert

Alles auf Discord läuft auf jedem Server, ob FiveM oder nicht. In jedem Plan bekommen Sie Ticket-Panels mit freier Übernahme und dauerhaften Protokollen, Anti-Spam, Anti-Raid und Anti-Nuke, Bewerbungen über Web-Formulare, Reaction Roles und eigene Befehle. Ab Starter bekommen Tickets außerdem KI-Antworten mit Quellen aus Ihren Regeln, Übersetzung in beide Richtungen und Hollo, eine Chat-Blase für Ihre Website.

Viele FiveM-Communitys fangen dort an und installieren die Bridge, sobald die Discord-Seite steht.

Was die Bridge ergänzt

Die Bridge läuft in jedem Plan. Sie ist eine einzige Ressource ohne Pflicht-Abhängigkeiten und ergänzt die Teile, für die es das Spiel braucht. Die Spielerkarte braucht Starter, der KI-Entwickler und KI-NPCs brauchen Pro.

  • Eine Live-Spielerzahl in einem Discord-Kanal, alle zwei Minuten aktualisiert.
  • Banne, Verwarnungen, Kicks und aufgehobene Banne aus txAdmin, jeweils mit dem Admin, der sie ausgesprochen hat, und dem Grund. Neun Anticheats, darunter WaveShield, Fiveguard und ElectronAC, melden ihre Banne ebenfalls, jeden mit dem, was der Server den Spieler davor tun sah. Jedes andere Admin-Menü und jeder andere Anticheat kann über einen Export melden. Wie txAdmin-Aktionen bei FiveBot ankommen.
  • Meldungen im Spiel. Ein Spieler tippt /report 12 shot me at the bank, und Ihr Team bekommt dieselbe Meldungskarte wie bei einer Meldung aus Discord, mit beiden Charakteren und dem Abstand zwischen ihnen. Mehr zu Meldungen im Spiel.
  • Store-Zahlungen. Sagt ein Spieler, dass ein Kauf nie angekommen ist, fragt FiveBot die Bridge, und die Bridge fragt den Store. Tebex funktioniert von selbst, Skalp bindet sich selbst an, und jeder andere Store lässt sich mit einem Export anbinden. Umgang mit „Ich habe bezahlt und nichts bekommen“.
  • Skriptfehler aus der Serverkonsole, gesammelt im Dashboard, ohne Passwörter, Tokens, IP-Adressen und E-Mail-Adressen. Sie bekommen eine E-Mail, wenn sie sich plötzlich häufen, und einmal am Tag eine kurze Zusammenfassung. Alarme bei Skriptfehlern.
  • Eine Spielerkarte im Dashboard mit Geld, Items, Job und Autos, dazu Änderungen wie Geld geben oder einen Job setzen mit einem Button. Einen Spieler prüfen.
  • Änderungen an Configs und Skripten aus einer einfachen Anfrage, angezeigt, bevor sie gespeichert werden, und zurückgesetzt, wenn das Skript fehlschlägt. Der KI-Entwickler.
  • Jeder Befehl, den Ihr Team auf dem Gameserver ausführt, pro Admin. Das Befehlslog der Admins.
  • KI-NPCs, die in Ihrer Stadt stehen und mit Spielern sprechen. So funktionieren sie.

Welche Frameworks sie liest

Beim Start sucht die Bridge nach einem Framework und liest Name, Job, Rang und Gang eines Charakters. So begrüßt ein NPC einen Polizisten mit seinem Rang, und so nennt eine Meldungskarte die beteiligten Charaktere.

FrameworkRessourceWas sie liest
ESX Legacy und älteres ESXes_extendedName, Job, Rangbezeichnung und auf Forks, die einen haben, den versteckten Job als Gang
ESX-Forks mit GetPlayerFromIdClasses_extendedVor- und Nachname, Job, Rangbezeichnung, versteckter Job
Qboxqbx_coreCharakterdaten, Job, Rang, Gang
QBCoreqb-coreCharakterdaten, Job, Rang, Gang
ox_coreox_coreCharaktername, aktive Gruppe und ihr Rang
vRP (vRPex-Builds)vrpIdentität und die Gruppe vom Typ job

Ohne Framework läuft die Bridge nur mit den Spieler-Identifiern, und auch das ist ein unterstütztes Setup. Ein Framework, das nach der Bridge startet, wird erkannt, sobald es startet. Um eines zu erzwingen, setzen Sie fivebot_framework auf esx, qbcore, qbox, ox, vrp oder none. Einen umbenannten Core findet sie über seine Exports, ebenso das Inventar und das Medizin-Skript. Unterstützte Frameworks und Inventare.

Installation

  1. Öffnen Sie im Dashboard Einstellungen, Game Server Bridge, laden Sie fivebot_bridge herunter und erstellen Sie ein Server-Token. Das gemeinsame Geheimnis wird nur einmal angezeigt, kopieren Sie es also sofort.
  2. Legen Sie fivebot_bridge in resources/ ab.
  3. Fügen Sie die Zeilen unten in server.cfg ein und starten Sie neu. Fehlt eine Zeile, sagt Ihnen die Serverkonsole, welche.
set fivebot_api_url       "https://api.fivebot.ai"
set fivebot_server_token  "srv_..."
set fivebot_shared_secret "..."
ensure fivebot_bridge

Token und Geheimnis stehen in server.cfg, außerhalb des Ressourcenordners. Ressourcen werden kopiert, gezippt und weitergegeben, und ein Token im Ordner würde mit jeder Kopie mitwandern.

KI-Figuren werden vom Server gespawnt und brauchen OneSync, das txAdmin standardmäßig einschaltet. Alles andere funktioniert auch ohne. ox_lib, oxmysql und ein Framework sind optional.

Was sie in Ruhe lässt

FiveM liefert zusammen mit den anderen Identifiern einen ip:-Identifier, und die Bridge verwirft ihn, bevor etwas gespeichert oder gesendet wird. Sie führt auch keine Bannliste auf Ihrem Server: Banne werden bei FiveBot geprüft, wenn es darauf ankommt.

Die Logikdateien der Bridge sind verschleiert. Zwei Dateien bleiben lesbar, und die dürfen Sie bearbeiten: config.lua für Zeiten und client/chat.lua dafür, wie die Zeilen von FiveBot beim Spieler ankommen. Ein Update ersetzt alles andere, halten Sie Ihre Änderungen also in diesen beiden Dateien.

Wie viel Traffic sie erzeugt

Beitritte und Abgänge gehen alle zwei Sekunden gebündelt raus, nie als eine Anfrage pro Ereignis. Die Spielerzahl geht alle zwei Minuten raus. Nach Aktionen aus dem Dashboard fragt die Bridge alle drei bis viereinhalb Sekunden. Ist die API nicht erreichbar, wird jede fehlschlagende Route einmal protokolliert und noch einmal, wenn sie wieder funktioniert, damit ein falsches Token die Konsole nicht flutet.

Häufige Fragen

Brauche ich Pro für den Discord-Bot?

Nein. Entry und Starter bieten Tickets, Moderation, Sicherheit und, bei Starter, KI-Antworten und Hollo. Die Bridge läuft in jedem Plan und liest Charakterdaten aus ESX, QBCore, Qbox, ox_core oder vRP. KI-NPCs und Bodycam beginnen bei Pro. Die aktuellen Preise stehen auf fivebot.ai/pricing.

Funktioniert es direkt mit txAdmin?

Ja. Die Bridge hört auf die eigenen Ereignisse von txAdmin, deshalb kommen Banne, Verwarnungen und Kicks an, ohne dass Sie in txAdmin etwas einrichten müssen.

Kann ich es neben meinen anderen Bots betreiben?

Ja. FiveBot muss nicht der einzige Bot auf dem Server sein, Sie können also Ihren alten Ticket-Bot behalten, während Sie vergleichen.

Ist FiveBot mit Cfx.re verbunden?

Nein. FiveBot steht in keiner Verbindung zu Cfx.re, Rockstar Games oder Take-Two Interactive.

Weiterlesen

Ihr Team hat das heute schon vierzig Mal beantwortet.

Die Einrichtung dauert etwa zehn Minuten, und die Zahl der Tickets ist nicht begrenzt.