Un bot Discord pour un serveur FiveM : ce que la connexion t'apporte vraiment

Presque chaque serveur FiveM a un serveur Discord à côté. En général, les deux cohabitent sans être reliés : les rôles sont attribués dans Discord puis une seconde fois à la main en jeu, quelqu'un tient la whitelist dans un fichier texte, et lancer une commande serveur suppose d'avoir accès au panel du serveur.

Relier les deux résout exactement ces trois choses. Ce que cela ne résout pas se trouve plus bas.

Ce dont tu as besoin d'abord

La connexion passe par un script sur ton serveur FiveM et un secret que le script utilise pour s'identifier auprès de nous. Sans les deux, rien ne se passe, y compris pour les fonctionnalités où on ne s'y attendrait pas, comme les notifications en jeu.

Une chose compte vraiment au moment de générer le secret : tu ne le vois qu'une seule fois. Copie-le directement dans config.lua. Fermer la fenêtre signifie en générer un nouveau et l'indiquer à la place, ce qui est sans gravité tant que tu le sais, et agaçant si tu passes dix minutes à le chercher.

La configuration complète, étape par étape, se trouve dans la documentation FiveM.

Synchroniser les rôles

La fonctionnalité pour laquelle la plupart des gens commencent. Tu crées des correspondances, chacune associant un rôle Discord à un groupe FiveM, et à la connexion le joueur reçoit le groupe correspondant. Celui qui ne correspond à rien atterrit dans user.

Un détail fait ici la différence entre réussite et confusion : les correspondances sont vérifiées de haut en bas, et la première qui correspond l'emporte. Ton administrateur a presque certainement aussi le rôle de supporter. Si supporter se trouve plus haut, ton administrateur est supporter en jeu, et le dépannage dure exactement le temps qu'il faut à quelqu'un pour regarder l'ordre.

Donc : le rôle le plus élevé tout en haut, puis un test avec un compte qui possède plusieurs rôles. Pas le tien, le tien a tout.

Whitelist

Au lieu d'une liste d'identifiants à maintenir, c'est le rôle Discord qui décide qui peut se connecter. Pour les serveurs de roleplay avec un processus de candidature, c'est le vrai gain : celui qui est accepté reçoit un rôle, et c'était toute la procédure.

La partie que la plupart des gens bâclent, c'est le message de refus. Il apparaît dans la fenêtre de connexion, et c'est souvent la seule chose qu'un joueur refusé lira jamais de ton serveur. « Tu n'es pas sur la whitelist » est une impasse. Écris où postuler, idéalement avec un lien. Cela coûte deux minutes une fois et épargne à ton équipe la même question dans un ticket.

RCON depuis Discord

/fivemrcon permet à ton équipe de lancer des commandes serveur directement depuis Discord, sans accès au panel du serveur.

C'est la fonctionnalité pour laquelle j'encouragerais le plus à réfléchir avant de l'activer. RCON, c'est un accès complet aux commandes du serveur. Deux choses ne sont donc pas des options mais des exigences :

• N'autorise que des groupes en qui tu as vraiment confiance. Pas « toute l'équipe », mais les groupes qui auraient cet accès de toute façon.
• Définis un salon de logs. Chaque commande lancée y atterrit. Sans lui, tu as créé un moyen de contrôler ton serveur où personne ne peut reconstituer après coup qui a fait quoi.

Si tu as un doute sur l'une des deux questions, laisse RCON désactivé. Les autres fonctionnalités tournent indépendamment de lui.

Les deux petits extras

Les giveaways en jeu. Quand un giveaway démarre sur Discord, les joueurs voient une interface pour y participer pendant une minute, et les gagnants sont aussi affichés en jeu. Utile parce que cela touche exactement ceux qui jouent et qui ne regardent donc pas Discord.

La notification de support en jeu. Quand quelqu'un rejoint un salon vocal de support, les membres de l'équipe avec le rôle correspondant reçoivent un avis en jeu. Le délai de récupération n'y est pas optionnel dans l'esprit : sans lui, un joueur qui change deux fois de salon d'affilée déclenche une série de notifications.

Ce que la connexion n'est pas

Elle ne remplace ni un système d'administration, ni une gestion de l'économie, ni une base de données des joueurs. Elle relie les identités et les permissions entre deux systèmes qui devraient sinon être maintenus séparément, et rend quelques événements Discord visibles en jeu. Rien de plus, et c'est voulu.

Si tu débutes, l'ordre qui a fait ses preuves : configurer d'abord la synchronisation des rôles et la vérifier avec un compte de test, ensuite la whitelist si tu en as besoin, et RCON en dernier, si jamais.