🧩 Installation & Prérequis

Cette page explique **comment installer, configurer et lancer** le bot Discord GuerreRP (Admin / Lootbox / Season Pass).

✅ Prérequis

Avant de commencer, assure-toi d’avoir :

• Un serveur Discord où tu as les droits Administrateur

• Un bot Discord créé sur le Portal de Discord Developer

• Un token de bot valide

• Un accès à une base de données MySQL / MariaDB

• Node.js *18 ou plus récent

Tu peux vérifier avec :

node -v
npm -v

📦 Récupération du projet

1. Télécharge le bot via: https://dlguerrerp.ducratif.com/

2. Place les fichiers dans un dossier, par exemple :

/guerrerp-discord-bot-admin/
  ├─ index.js
  ├─ package.json
  ├─ config.json
  ├─ db.js
  ├─ .env.example (optionnel)
  ├─ commands/
  ├─ events/
  ├─ componentHandler.js
  ├─ interactionHandler.js
  └─ ...

1. Installe les dépendances :

npm install

Cela installe notamment : discord.js, mysql2, dotenv et les autres modules utilisés par le bot.

---

🔐 Configuration du fichier .env

Modifie le fichier .env qui ce trouve a la racine du dossier.

Exemple :

DISCORD_TOKEN=TON_TOKEN_DE_BOT_DISCORD

DB_HOST=localhost
DB_USER=ton_utilisateur
DB_PASSWORD=ton_mot_de_passe
DB_NAME=nom_de_ta_base

Détails :

• DISCORD_TOKEN → Le token de ton bot, récupérable dans l’onglet Bot de ton application Discord.

• DB_HOST → En local : localhost ou 127.0.0.1 → Sur un hébergeur : l’IP ou le hostname du serveur SQL.

• DB_USER / DB_PASSWORD → Identifiants de ton utilisateur MySQL / MariaDB.

• DB_NAME → Nom de la base de données où se trouvent les tables lootbox / Saison Passe (GuerreRP).

ℹ️ Le fichier db.js utilise ces variables pour créer un pool MySQL via mysql2/promise. Si .env est mal rempli, le bot ne pourra pas communiquer avec la DB.

Si vous avez un port de db autre que 3306, alors ajouter le port.

---

⚙️ Configuration de config.json

Le fichier config.json permet de configurer le comportement du bot.

Exemple simplifié :

{
  "ducratif": "Developped By Ducratif",

  "guildId": "id_serveur_discord",
  "clientId": "id_client_bot",

  "perm": [
    "1245393309778841702",
    "ID_DISCORD_DU_FONDATEUR"
  ],

  "welcomeChannelId": "id_channel_bienvenue",

  "roleId": "id_role_a_ajouter",
  "roleButtonLabel": "Obtenir le rôle",
  "roleEmbedColor": "#2f3136",

  "dmWelcomeMessage": "Bienvenue sur GuerreRP ! Merci de nous avoir rejoint.",
  "welcomeChannelMessage": "🎉 Bienvenue {user} sur **GuerreRP** !",

  "presence": {
    "status": "dnd",
    "activityName": "GuerreRP.ovh | Ducratif.com",
    "activityType": "PLAYING"
  }
}

Champs importants

• guildId → ID du serveur Discord où tu veux utiliser le bot.

• clientId → ID de l’application Discord (le bot).

• perm → Liste des ID Discord qui ont accès aux commandes admin (lootbox, Season Pass, etc.). Mets ici ton ID + celui de tes admins.

• welcomeChannelId → Salon où le bot enverra un message de bienvenue public.

• roleId, roleButtonLabel, roleEmbedColor → Valeurs par défaut pour la commande /rolebutton. → Le rôle peut être redéfini directement dans la commande, mais les valeurs ici servent de fallback.

• dmWelcomeMessage → Message envoyé en DM à chaque nouveau membre.

• welcomeChannelMessage → Message envoyé dans le salon de bienvenue. → {user} est remplacé automatiquement par la mention du nouveau membre.

• presence

  • status : online, idle, dnd, invisible

  • activityName : texte affiché dans l’activité du bot

  • activityType : PLAYING, WATCHING, LISTENING, COMPETING, STREAMING

---

🧱 Préparation de la base de données

Le bot s’appuie sur les tables de la base GuerreRP et du système lootbox / Saison Passe.

Au minimum, il s’attend à trouver (nom des tables donné à titre indicatif de la base par défaut):

• lootboxes

• lootbox_contents

• lootbox_payments

• lootbox_rewards

• lootbox_saisonpasse

• lootbox_saisonpass_challenges

• lootbox_saisonpass_rewards

• lootbox_saisonpass_logs

• discord_users

• users (pour les personnages / identifiants CFX)

⚠️ Si ces tables n’existent pas ou sont vides, certaines commandes ne fonctionneront pas (ex: création de caisse ok, mais givebox impossible si discord_users n’est pas rempli).

---

🛰️ Déploiement des commandes slash

Une fois .env et config.json configurés, tu dois déclarer les commandes slash sur ton serveur Discord.

Lance :

npm run deploy
# ou
node deploy-commands.js

Ce script :

• Charge tous les fichiers du dossier commands/.

• Enregistre les commandes en GUILD sur l’ID config.guildId.

Si tu modifies les commandes (nouvelle commande, changement de description, options, etc.), pense à relancer ce script.

---

▶️ Lancer le bot

Quand tout est prêt :

npm start
# ou
node index.js

Si tout est bon, tu devrais voir dans la console :

✅ Connecté en tant que NOM_DU_BOT#1234
ℹ️  Version actuelle du bot : v1.0.0
✅ Bot GuerreRP à jour ✅
   Version installée : v1.0.0

Ou, si une mise à jour est disponible :

⚠️  Une mise à jour du Bot GuerreRP est disponible !
   Version actuelle   : v1.0.0
   Version disponible : v1.0.1
   🔗 Lien de mise à jour : https://...

---

🧪 Vérification rapide

Pour vérifier que tout fonctionne :

1. Vérifie que le bot est en ligne sur ton serveur.

2. Teste la commande :

/ping

1. Si tu as accès (ton ID est dans config.perm), tu dois recevoir une réponse du style :

Pong! Bot GuerreRP développé par Ducratif.

Si ça fonctionne : ✅ Ton installation est terminée, tu peux passer à la page suivante : “Configuration détaillée & Commandes du bot”.