Un bot Discord pour les serveurs FiveM sur ESX, QBCore, Qbox, ox_core et vRP

FiveBot est un bot Discord pour les tickets, la modération et les réponses IA tirées de vos propres règles. Il est aussi livré avec une ressource FiveM, fivebot_bridge, qui relie votre serveur de jeu au même tableau de bord. Le côté Discord fonctionne sans elle. Avec elle, les tickets, les signalements et les bans savent qui est le joueur dans la ville.

Ce qui fonctionne sans le serveur de jeu

Tout ce qui se passe sur Discord tourne sur n'importe quel serveur, FiveM ou non. Chaque plan comprend des panneaux de tickets avec prise en charge libre et transcriptions permanentes, l'anti-spam, l'anti-raid et l'anti-nuke, les candidatures sur formulaires web, les rôles par réaction et les commandes personnalisées. Dès Starter, les tickets reçoivent aussi des réponses IA qui citent vos règles, une traduction dans les deux sens et Hollo, une bulle de chat pour votre site.

Beaucoup de communautés FiveM commencent par là et installent le bridge une fois le côté Discord en place.

Ce que le bridge ajoute

Le bridge fonctionne sur tous les plans. C'est une seule ressource sans dépendance obligatoire, et elle ajoute ce qui a besoin du jeu. La carte joueur demande Starter, le développeur IA et les PNJ IA demandent Pro.

  • Un nombre de joueurs en direct sur un salon Discord, envoyé toutes les deux minutes.
  • Les bans, avertissements, kicks et bans levés de txAdmin, chacun avec l'admin qui l'a donné et la raison. Neuf anticheats, dont WaveShield, Fiveguard et ElectronAC, signalent aussi les leurs, chaque ban accompagné de ce que le serveur a vu le joueur faire avant. Tout autre menu admin ou anticheat peut signaler via un export. Comment les actions txAdmin arrivent dans FiveBot.
  • Les signalements en jeu. Un joueur tape /report 12 shot me at the bank et votre staff reçoit la même carte de signalement qu'un signalement Discord, avec les deux personnages et la distance entre eux. En savoir plus sur les signalements en jeu.
  • Les paiements de la boutique. Quand un joueur dit qu'un achat n'est jamais arrivé, FiveBot interroge le bridge, et le bridge interroge la boutique. Tebex fonctionne tout seul, Skalp se branche de lui-même, et toute autre boutique peut se brancher avec un seul export. Gérer « j'ai payé et je n'ai rien reçu ».
  • Les erreurs de scripts de la console du serveur, réunies dans le tableau de bord sans mots de passe, tokens, adresses IP ni e-mails. Vous recevez un e-mail quand elles s'emballent et un court résumé une fois par jour. Alertes d'erreurs de scripts.
  • Une carte joueur dans le tableau de bord avec l'argent, les objets, le métier et les voitures, et des changements comme donner de l'argent ou changer de métier d'un seul bouton. Consulter un joueur.
  • Des modifications de configs et de scripts à partir d'une simple demande, montrées avant d'être enregistrées et annulées si le script plante. Le développeur IA.
  • Chaque commande lancée par votre staff sur le serveur de jeu, par admin. Le journal des commandes d'admin.
  • Des PNJ IA qui se tiennent dans votre ville et parlent aux joueurs. Comment ils fonctionnent.

Les frameworks qu'il lit

Au démarrage, le bridge cherche un framework et lit le nom, le métier, le grade et le gang d'un personnage. C'est ce qui permet à un PNJ de saluer un policier selon son grade et à une carte de signalement de nommer les personnages concernés.

FrameworkRessourceCe qu'il lit
ESX Legacy et anciens ESXes_extendedNom, métier, libellé du grade, et le métier caché comme gang sur les forks qui en ont un
Forks ESX avec GetPlayerFromIdClasses_extendedPrénom et nom, métier, libellé du grade, métier caché
Qboxqbx_coreInfos du personnage, métier, grade, gang
QBCoreqb-coreInfos du personnage, métier, grade, gang
ox_coreox_coreNom du personnage, groupe actif et son grade
vRP (builds vRPex)vrpIdentité et groupe de type job

Sans framework, le bridge tourne avec les seuls identifiants des joueurs, et c'est une configuration prise en charge. Un framework qui démarre après le bridge est repris dès son démarrage. Pour en imposer un, réglez fivebot_framework sur esx, qbcore, qbox, ox, vrp ou none. Un core renommé est trouvé grâce à ses exports, tout comme l'inventaire et le script médical. Frameworks et inventaires pris en charge.

L'installer

  1. Dans le tableau de bord, ouvrez Réglages, Game Server Bridge, téléchargez fivebot_bridge et créez un token de serveur. Le secret partagé ne s'affiche qu'une fois, copiez-le tout de suite.
  2. Déposez fivebot_bridge dans resources/.
  3. Ajoutez les lignes ci-dessous à server.cfg et redémarrez. S'il manque une ligne, la console du serveur dit laquelle.
set fivebot_api_url       "https://api.fivebot.ai"
set fivebot_server_token  "srv_..."
set fivebot_shared_secret "..."
ensure fivebot_bridge

Le token et le secret vivent dans server.cfg, hors du dossier de la ressource. Les ressources se copient, se zippent et se partagent, et un token rangé dans le dossier voyagerait avec chaque copie.

Les personnages IA sont spawnés par le serveur et ont besoin de OneSync, que txAdmin active par défaut. Tout le reste fonctionne sans. ox_lib, oxmysql et un framework sont tous facultatifs.

Ce à quoi il ne touche pas

FiveM transmet un identifiant ip: avec les autres, et le bridge le supprime avant que quoi que ce soit ne soit stocké ou envoyé. Il ne garde pas non plus de liste de bans sur votre serveur : les bans sont vérifiés auprès de FiveBot au moment où ils comptent.

Les fichiers de logique du bridge sont obfusqués. Deux fichiers restent lisibles et sont à vous : config.lua pour les délais et client/chat.lua pour la façon dont les messages de FiveBot arrivent au joueur. Une mise à jour remplace tout le reste, donc gardez vos changements dans ces deux fichiers.

Le trafic qu'il génère

Les arrivées et départs partent par lots toutes les deux secondes, jamais une requête par événement. Le nombre de joueurs part toutes les deux minutes. Le bridge vérifie les actions venues du tableau de bord toutes les trois à quatre secondes et demie. Quand l'API est injoignable, chaque route en échec est journalisée une fois, puis une fois encore quand elle revient, pour qu'un mauvais token n'inonde pas la console.

Questions fréquentes

Faut-il Pro pour le bot Discord ?

Non. Entry et Starter gèrent les tickets, la modération, la sécurité et, sur Starter, les réponses IA et Hollo. Le bridge fonctionne sur tous les plans et lit les données de personnage d'ESX, QBCore, Qbox, ox_core ou vRP. Les PNJ IA et Bodycam commencent à Pro. Les prix actuels sont sur fivebot.ai/pricing.

Fonctionne-t-il avec txAdmin dès l'installation ?

Oui. Le bridge écoute les événements de txAdmin lui-même, donc les bans, avertissements et kicks arrivent sans aucune configuration dans txAdmin.

Puis-je le faire tourner à côté de mes autres bots ?

Oui. FiveBot n'a pas besoin d'être le seul bot du serveur, vous pouvez donc garder votre ancien bot de tickets le temps de comparer.

FiveBot est-il affilié à Cfx.re ?

Non. FiveBot n'est affilié ni à Cfx.re, ni à Rockstar Games, ni à Take-Two Interactive.

À lire aussi

Votre staff a déjà répondu à celle-là quarante fois aujourd'hui.

L'installation prend environ dix minutes, et le nombre de tickets n'est pas plafonné.