Skip to content
/ Bord-Pi Public template

Un robot Discord gérant et aidant les utilisateurs pour votre propre serveur.

License

Notifications You must be signed in to change notification settings

thomasbnt/Bord-Pi

Repository files navigation

Discord Voir les Releases GitHub last commit Depfu


Introduction

Logo Bord Pi

Note

Vérifiez que votre Version NodeJS est supérieure à 16.6.0.

Propre, rapide, beau, simple d'utilisation et de modification.

Bord Pi est un robot Discord qui fonctionne avec l'API Discord et le package Discord.js, paramétré en fonction du serveur Discord du Coin du Cappu'. Il est néanmoins accessible et facilement possible à le paramétrer à votre façon pour votre propre serveur.

Important

Toutes les configurations sont spécialement pour le serveur où se trouve ce robot. Si vous le testez, vous aurez sûrement des erreurs si vous n'avez pas modifié les ID des salons.

Merci aux Sponsors pour votre soutien ! Si vous aussi, vous voulez aider au développement de plusieurs projets comme celui-ci, n'hésitez pas à faire une donation.

GitHub Sponsors

Nouveautés

La version 3 de Bord Pi ajoute la dernière fonctionnalité de Discord : les Slash Commands. Plus aucun préfixe n'est nécessaire pour les commandes.

  • Slash Commands
  • Logs

Les intégrations

  • Un module permettant de changer la bannière du serveur tous les jours avec une image Unsplash
  • Un filtre contre les liens Discord, vous pouvez bien évidemment lui ajouter l'ID du channel de publicité dans IDAdsChannel. Le robot ne fera rien dans ce channel en question.
  • Un système de logs interne via Webhooks.
  • Un message de bienvenue personnalisé.

Pas mal de changements sur le code, notamment le rangement des fichiers, des logs plus propre et un code plus net. Quant au niveau de la sécurité du robot, il vérifie la plupart du temps s'il peut faire les actions qui voudrait faire, s'il ne peut pas, il passe sans râler.

¹. Si le serveur a la fonctionnalité de bannière, et que le module est activé et correctement configurée, le robot changera la bannière tous les jours à 2h du matin.

Les permissions

Le robot doit avoir les Intents privilégié suivant :

  • Server members
  • Message content

Important

Sans ces intents, le robot ne fonctionnera pas. Quand vous l'ajouterez sur votre propre serveur, n'oubliez pas de le mettre en privé et de lui donner les permissions suivantes :

Scopes :

  • bot
  • applications.commands

Permissions bot :

  • Manage server
  • Manage Roles
  • Kick members
  • Ban members
  • Read Messages/View Channels
  • Moderate Members
  • Send Messages
  • Manage Messages
  • Embed links
  • Attach files
  • Read message history
  • Add reactions

Comment le faire fonctionner

  1. Assurez-vous d'avoir la version de NodeJS supérieure à 16.9.0.
  2. Installez les dépendences avec un coup de npm install ou yarn add.
  3. Copiez le fichier config.exemple.json en config.json.
  4. Remplissez les configurations dans config.json.
  5. Vous pouvez désormais allumer votre robot avec npm run start.

Les modules complémentaires

Module Unsplash

Vous avez la possibilité d'activer le module Unsplash pour avoir une bannière de serveur qui change tous les jours suivant le thème que vous avez choisi.

Pour cela, il vous suffit de mettre true dans optionalModules.unsplash.activate dans le fichier config.json.

Obtenir ma Access Key de Unsplash (UnsplashAccessKey)

Afin de communiquer avec l'API Unsplash, vous devez créer un compte sur Unsplash.

  1. Rendez-vous sur votre dashboard et créez une nouvelle application.
  2. Remplissez les informations demandées.
  3. Une fois l'application créée, vous aurez accès à votre Access Key.
  4. Copiez-la et collez-la dans config.json dans optionalModules.unsplash.unsplashAccessKey.
  5. Vous pouvez désormais allumer votre robot, il changera la bannière tous les jours à 2h du matin comme indiqué dans ready.js.

Les paramètres

Tous les paramètres sont respectivement dans config.json dans optionalModules.unsplash.

value default type Exemple description
activate true boolean Activer ou désactiver le module de changement de bannière Unsplash
unsplashAccessKey null string La clé d'accès à l'API Unsplash
optionalQuery "nature clouds" string "rustic gaming" Le thème de recherche pour les images Unsplash
optionalUsername null string "thomasbnt" Permet de récupérer les images seulement à partir d'un profil Unsplash
optionalCollectionsID null Array ["520359", "10437765"] Permet de récupérer les images seulement à partir d'une ou plusieurs collection(s) Unsplash (cela désactive le filtre optionalQuery et optionalUsername)

Contributions

Les contributions sont toujours les bienvenues ! Lisez les règles pour les contributions avant de pouvoir y participer.

Veuillez vous assurer que votre demande de pull request respecte les lignes directrices suivantes :

  • Rechercher des suggestions précédentes avant d'en faire une nouvelle, afin d'éviter les doublons.
  • Les fichiers README suggérés devraient être beau ou se démarquer d'une manière ou d'une autre.
  • Faire une demande de pull request individuelle pour chaque suggestion.
  • De nouvelles catégories ou des améliorations à la catégorisation existante sont les bienvenues.
  • Gardez de courtes descriptions simples, mais descriptives.
  • Commencez la description avec une capitale et terminez par un arrêt/période complet.
  • Vérifiez votre orthographe et votre grammaire.
  • Assurez-vous que votre éditeur de texte est configuré pour supprimer les espaces de fin.

Merci pour vos suggestions !

Les codes couleurs

Principaux PrimaryColor DangerColor InfoColor SuccessColor BlackColor
Code Hexadécimal #E74C3C #B20000 #6897BB #47b60f #36393F

Pour les utiliser : config.colors.PrimaryColor, récupère la couleur primaire.

Besoin de se faire héberger son propre robot ?

Si vous le souhaitez, vous pouvez avoir votre propre robot hébergé pour votre serveur Discord. Il serait basé sur ce code, et aura un nom et une image différente que vous choisirez ! ✨

Ayez votre robot à votre effigie

Licence

Bord Pi est sous licence GNU GPL 3. Veuillez la respecter. Si vous reprenez le code, merci de me créditer dans la bio du robot avec le lien de ce dépôt public. Merci à ceux qui le feront. ❤️

Informations complémentaires

L'image a été modifiée par Thomas Bnt, veuillez donc à ne pas l'utiliser publiquement et/ou commercialement. Initialement, l'image appartient à Raspberry Pi.

Faire une donation

GitHub Sponsors Support me on Buy Me a Coffee