Comment configurer le bot Discord

Le bot Discord permet de gérer votre serveur FiveM directement depuis Discord via des commandes slash.

Prérequis

Un bot Discord créé sur le Portail Développeur Discord
Le bot doit être invité sur votre serveur Discord avec les permissions suivantes :
- Send Messages
- Embed Links
- Use Slash Commands
Les Intents suivants activés dans le portail développeur :
- Server Members Intent
- Message Content Intent

Installation

Configurez le fichier config.json (voir ci-dessous)
Assurez-vous que la resource core est démarrée avant discord dans votre server.cfg

Configuration

Éditez le fichier config.json situé dans le dossier de la resource :

{
    "token": "",
    "guild_id": "",
    "permissions": {
        "economy": {
            "addcoins": ["IDROLE"],
            "removecoins": ["IDROLE"]
        },
        "moderation": {
            "ban": ["IDROLE"],
            "unban": ["IDROLE"],
            "kick": ["IDROLE"],
            "jail": ["IDROLE"],
            "unjail": ["IDROLE"]
        },
        "inventory": {
            "inventory": ["IDROLE"],
            "giveitem": ["IDROLE"],
            "giveweapon": ["IDROLE"],
            "clearinv": ["IDROLE"],
            "clearweapons": ["IDROLE"]
        },
        "player_management": {
            "setgroup": ["IDROLE"],
            "setjob": ["IDROLE"],
            "setjob2": ["IDROLE"],
            "info": ["IDROLE"],
            "revive": ["IDROLE"],
            "tppc": ["IDROLE"],
            "wipe": ["IDROLE"]
        },
        "server": {
            "playerslist": ["IDROLE"],
            "help": ["IDROLE"]
        }
    }
}

Paramètres principaux

Paramètre	Description
`token`	Le token de votre bot Discord (récupéré depuis le portail développeur)
`guild_id`	L'ID de votre serveur Discord (clic droit sur le serveur > Copier l'identifiant)

Permissions

Chaque commande est protégée par un système de rôles. Remplacez "IDROLE" par le ou les ID de rôle Discord autorisés à utiliser la commande.

Vous pouvez autoriser plusieurs rôles par commande :

"ban": ["123456789", "987654321"]

Commandes disponibles

Économie (`economy`)

Commande	Description
`addcoins`	Ajouter des coins boutique à un joueur
`removecoins`	Retirer des coins boutique à un joueur

Modération (`moderation`)

Commande	Description
`ban`	Bannir un joueur (par UID, avec durée en heures, 0 = permanent)
`unban`	Débannir un joueur
`kick`	Expulser un joueur connecté
`jail`	Emprisonner un joueur (durée en minutes)
`unjail`	Libérer un joueur de prison

Inventaire (`inventory`)

Commande	Description
`inventory`	Voir l'inventaire d'un joueur (en ligne ou hors ligne)
`giveitem`	Donner un item à un joueur
`giveweapon`	Donner une arme à un joueur
`clearinv`	Vider l'inventaire d'un joueur
`clearweapons`	Supprimer toutes les armes d'un joueur

Gestion des joueurs (`player_management`)

Commande	Description
`info`	Afficher la fiche complète d'un joueur (identité, finances, emploi, boutique, identifiants)
`setgroup`	Changer le groupe d'un joueur (admin, user, etc.)
`setjob`	Changer le métier d'un joueur
`setjob2`	Changer le gang/organisation d'un joueur
`revive`	Réanimer un joueur
`tppc`	Téléporter un joueur au parking central
`wipe`	Réinitialiser complètement un personnage (irréversible)

Serveur (`server`)

Commande	Description
`playerslist`	Afficher la liste des joueurs connectés
`help`	Afficher l'aide des commandes