README.md

Ce dépôt contient les sources du bot EPLBot présent sur le discord de l'École Polytechnique de Louvain-la-Neuve (EPL).

---

Installation

Prérequis

Avant de commencer, assurez-vous d'avoir les éléments suivants :

• Java Development Kit (JDK) 23
• Docker
• Un compte Discord pour créer un bot et obtenir un jeton d'authentification
• Gradle si vous souhaitez compiler le projet localement

Procédure

1. Clonez ce dépôt sur votre machine :

   git clone https://github.com/Hokkaydo/EPLBot.git

2. Accédez au répertoire du projet :

   cd EPLbot/

3. Créez un répertoire pour la persistence:

   mkdir data/

4. Renommez le fichier variables.env.example en variables.env et renseignez-y vos variables d'environnement suivant :

   • DISCORD_BOT_TOKEN: Jeton d'identification de votre bot Discord
   • TEST_DISCORD_ID: Identifiant du discord sur lequel vous souhaitez tester le bot
   • GITHUB_APPLICATION_ID: Identifiant de l'application Github liée (permet de gérer les issues) (Optionnel)
   • GITHUB_APPLICATION_INSTALLATION_ID: Identifiant d'installation de l'application Github liée (permet de gérer les issues) (Optionnel)
   • HASTEBIN_TOKEN: Jeton d'identification auprès de l'API de Hastebin

5. Lancez le projet avec Docker :

   docker-compose up

---

Configuration du bot Discord

Le bot propose un système modulaire permettant d'activer et désactiver les modules via les commandes Discord /enable <module> et /disable <module>.

La commande /config permet de configurer les paramètres des modules.

Contribution

Les contributions à ce projet sont les bienvenues. Si vous souhaitez apporter des améliorations, veuillez créer une branche à partir de la branche master, effectuer vos modifications et soumettre une Pull Request (PR).

Pensez à consulter CONTRIBUTION.md afin de comprendre la structure du projet

Ressources

• Documentation JDA : https://github.com/DV8FromTheWorld/JDA
• Tutoriels Discord API : https://discord.com/developers/docs/intro

Licence

Ce projet est sous licence GNU GPLv3.