FiveM

Affiche sur Discord l'état de ton serveur GTA RP/PVP, ses classements et les stats de tes joueurs, et réserve l'accès au jeu à des rôles Discord. Réservé au plan Gold.

Tu n'as aucune base de données à exposer. Une petite resource tourne sur ton serveur de jeu : c'est elle qui envoie ses données à Octavius toutes les 3 minutes.

Installer en 2 minutes

Il te faut oxmysql sur ton serveur FiveM.

1. Sur Discord, lance /fivem link. Octavius t'envoie octavius_fivem.zip, déjà réglé pour ton serveur. Tu peux aussi le télécharger depuis le tableau de bord, dans Configuration › Serveur FiveM.
2. Décompresse-le dans le dossier resources/ de ton serveur FiveM.
3. Ajoute cette ligne dans ton server.cfg :

   ensure octavius_fivem
   

4. Redémarre ton serveur, ou tape ensure octavius_fivem dans sa console.
5. Lance /fivem status : tu dois voir 🟢 En ligne en moins d'une minute.

Ce fichier contient ton token

Le token prouve que le serveur de jeu t'appartient. Ne partage pas le zip. En cas de fuite, lance /fivem unlink, puis /fivem link, et remplace le dossier.

Commandes

Commande	À quoi elle sert	Qui
/fivem link	Envoie la resource prête à installer	Admin
/fivem status	Dit si ton serveur envoie bien ses données, et sinon quoi vérifier	Admin
/fivem unlink	Révoque le token : l'ancien fichier cesse de marcher	Admin
/fivem leaderboard	Affiche un classement dans le salon	Tout le monde
/fivem joueur	Affiche les stats d'un joueur : toi, un membre, ou un nom en jeu	Tout le monde
/fivem delier	Retire le lien entre ton compte Discord et ton compte de jeu	Tout le monde
/fivem livboard	Installe un classement qui se met à jour tout seul (5 au maximum)	Admin
/fivem livboard_stop	Retire les classements live du salon	Admin
/fivem whitelist enable	Réserve le serveur de jeu aux membres de 1 à 3 rôles	Admin
/fivem whitelist disable	Coupe la whitelist : tout le monde peut de nouveau entrer	Admin

Sur le serveur de jeu, dans le tchat :

Commande	À quoi elle sert
/octavius lier	Relie ton compte de jeu au compte Discord ouvert sur ton PC
/octavius delier	Retire ce lien et efface tes stats d'Octavius

Le tableau de bord fait la même chose, dans Configuration › Serveur FiveM : téléchargement de la resource, révocation du token, whitelist, aperçu des classements et liste des joueurs liés.

Stats d'un joueur

Un joueur tape /octavius lier dans le tchat du jeu. Discord doit être ouvert sur son PC : c'est FiveM qui donne son compte Discord au serveur, il n'y a aucun code à recopier. Ses stats apparaissent en quelques minutes avec /fivem joueur, et sont mises à jour tant qu'il joue.

Sans lien, /fivem joueur nom:Pseudo retrouve quand même un joueur s'il figure dans un classement.

Le lien est toujours un choix du joueur

Aucune commande ne permet de lier le compte d'un joueur à sa place. Pour les stats d'un autre script PVP, ajoute ta requête dans Config.PlayerStats (config.lua).

Whitelist

La whitelist réserve ton serveur de jeu aux membres de ton Discord qui ont un rôle choisi. Elle s'active depuis Discord ou le tableau de bord : rien à toucher sur le serveur, à condition d'avoir la resource en version 1.2.0 ou plus récente.

1. Lance /fivem whitelist enable et choisis jusqu'à 3 rôles.
2. Facultatif : écris le message montré aux joueurs refusés, avec ton invitation Discord par exemple.

Ce qui se passe ensuite :

• À chaque connexion, le serveur de jeu demande à Octavius si le joueur a le bon rôle.
• Un joueur connecté qui perd son rôle est éjecté en moins de 3 minutes.
• Le propriétaire et les administrateurs du Discord passent toujours : une mauvaise configuration ne peut pas t'enfermer dehors.
• Le joueur doit avoir Discord ouvert sur son PC quand il lance FiveM, sinon le serveur ne peut pas savoir qui il est.
• Si Octavius est injoignable, les joueurs admis depuis moins de 72 heures entrent quand même et les inconnus sont refusés. Ton serveur ne se vide pas à cause d'une panne, et il ne s'ouvre pas non plus à tout le monde.
• Si le plan Gold prend fin, la whitelist se coupe : le serveur ne reste pas verrouillé.

Pour laisser entrer un compte sans contrôle (un compte de test, par exemple), ajoute dans ton server.cfg :

add_ace identifier.license:TA_LICENCE octavius.whitelist.bypass allow

Ce qui s'affiche

• État du serveur : nom, joueurs connectés, heure du dernier envoi.
• Ranked et Ranked Hardcore : ELO, victoires, défaites, kills.
• Gungame : par mode (1v1, 2v2…).
• Primes : cibles et montants.

Sans nouvel envoi pendant 15 minutes, le serveur passe en 🔴 Hors ligne et les classements gardent leurs dernières données, avec un avertissement.

Mon script PVP est-il pris en charge ?

La resource regarde quelles tables existent sur ton serveur :

Script PVP	Tables lues
huncho_games	huncho_ranked, gungame_leaderboard, huncho_bounty_contracts
huncho_arena	arena_stats, arena_training_stats

Autre script ? L'état du serveur fonctionne quand même. Pour les classements, ajoute ta requête dans Config.Boards, dans le fichier config.lua de la resource : les colonnes à renvoyer y sont indiquées.

Ce qui quitte ton serveur

La resource ne fait que lire ta base, elle n'écrit jamais dedans. Partent toujours le nom du serveur, le nombre de joueurs connectés et, pour chaque classement, les noms affichés et les scores. S'y ajoutent :

• pour un joueur qui a tapé /octavius lier : son identifiant Discord, son nom et ses scores ;
• si la whitelist est active : l'identifiant Discord des joueurs qui se connectent ou sont connectés, pour le contrôle. Octavius ne le conserve pas.

La licence FiveM et le mot de passe de ta base ne partent jamais. Le lien entre une licence et un compte Discord reste sur ton serveur, dans le stockage de la resource.

Préviens tes joueurs

Tu es responsable de ce que ton serveur transmet : indique-le à tes joueurs, dans ton règlement par exemple. Détails dans la politique de confidentialité.

Dépannage

Commence par /fivem status, puis regarde la console de ton serveur FiveM :

• octavius_status affiche la version, l'adresse utilisée et le dernier résultat.
• octavius_push lance un envoi tout de suite.

Ce que tu vois	Quoi faire
HTTP 401 token refusé	Relance /fivem link et remplace le dossier
HTTP 403 plan Gold	Active le plan Gold sur ce serveur Discord
HTTP 429	Laisse Config.PushIntervalMs à 3 minutes
HTTP 0	Ton serveur n'arrive pas à joindre internet (pare-feu ?)
La base de données ne répond pas	Vérifie set mysql_connection_string dans server.cfg
Un classement reste vide	Sa table n'existe pas sur ton serveur, ou elle est vide
Impossible de lier ton compte	Ouvre Discord sur ce PC, puis relance FiveM
/fivem joueur dit que tu n'es pas lié	Tape /octavius lier en jeu, puis attends le prochain envoi (3 minutes)
Whitelist active mais tout le monde entre	Ta resource est trop ancienne : /fivem status le signale, remplace le dossier
Le contrôle d'accès est indisponible	Octavius n'a pas pu répondre : réessaie dans quelques minutes