Bots Discord autohébergés

Un repère pour les joueurs, la musique et la vie du serveur.

Alpha répond aux commandes et, si tu l’actives, gère la structure et les statistiques du serveur. Bravo ajoute la musique avec Muse, dans un service séparé.

Selon les besoins de ta communauté

Le profil minimal active l’aide et Palworld. pokemon ajoute le Pokédex. Le profil full active aussi l’administration du serveur selon un plan que tu dois vérifier.

Gestion du serveur

Audit, rôles, salons et permissions. Alpha réutilise les identifiants enregistrés et signale les conflits. Aucune suppression automatique de salon ou de rôle.

Musique avec Muse

Bravo utilise ses propres identifiants et son volume de données. Le profil Compose music est facultatif et indépendant du profil d’Alpha.

Pokédex

Fiches illustrées, talents, capacités et types avec suggestions. Les recherches et les données PokéAPI utilisent les noms anglais, comme charizard.

Vie de la communauté

Des espaces pour Palworld, Pokémon GO, Minecraft et Vault Hunters. Les événements vocaux publics respectent la confidentialité des salons privés.

Palworld

Statut et récapitulatif accessibles aux membres. Les mesures absentes, anciennes ou incomplètes sont signalées. Les annonces en jeu sont réservées au staff.

Statistiques et diagnostics

Compteurs vocaux en lecture seule. Les comptes précédés de ~ indiquent un cache incomplet. Les détails techniques sont réservés aux administrateurs.

Trouver la bonne commande

Commence par /help dans Discord : l’aide tient compte du profil et de ton rôle. Les commandes sont limitées au serveur configuré.

/status

État du conteneur, du bot admin et de Muse.

Administrateurs · minimal, pokemon, full

/audit

Compare la configuration voulue à l'état actuel sans rien modifier.

Administrateurs · full

/resync

Applique la structure gérée et ses permissions strictes.

Administrateurs · full

/help

Affiche les commandes du profil accessibles avec ton rôle.

Tous les membres · minimal, pokemon, full

/welcome-preview

Prévisualise le message d'accueil sans attendre un nouveau membre.

Administrateurs · full

/stats-refresh

Force une mise à jour immédiate des salons vocaux Stats.

Administrateurs · full

/diag

Affiche un diagnostic runtime sans secrets.

Administrateurs · full

/cache-status

Affiche la taille et l’âge des caches locaux sans secrets.

Administrateurs · full

/announce-palworld

Publie une annonce Discord et la relaie dans le serveur Palworld.

Administrateurs et modérateurs · full

/pokemon

Cherche un Pokémon par nom anglais ou numéro du Pokédex.

Tous les membres · pokemon, full

/weakness

Affiche les faiblesses, résistances et immunités d’un Pokémon.

Tous les membres · pokemon, full

/move

Cherche une capacité Pokémon par son nom anglais.

Tous les membres · pokemon, full

/ability

Cherche un talent Pokémon par son nom anglais.

Tous les membres · pokemon, full

/type

Affiche les forces et faiblesses d’un type Pokémon.

Tous les membres · pokemon, full

/random-pokemon

Affiche un Pokémon au hasard.

Tous les membres · pokemon, full

/metrics-palworld

Affiche les derniers metrics du serveur Palworld.

Tous les membres · minimal, pokemon, full

/resume-hier

Renvoie le lien du résumé Gaylemon de la veille.

Tous les membres · minimal, pokemon, full

Démarrer en local

Prévois Node.js 24, npm et Docker Compose v2. Commence avec une application Discord de développement. Muse demande une seconde application seulement si tu actives la musique.

  1. Préparer la configuration.

    Récupère le dépôt, copie .env.example vers .env, puis renseigne le jeton d’Alpha et l’identifiant du serveur. Garde BOT_PROFILE=minimal pour commencer.

  2. Installer et vérifier.

    Lance npm ci, puis npm run check. Ces vérifications ne connectent pas le bot à Discord.

  3. Initialiser les dossiers et démarrer Alpha.

    Lance npm run init:local, puis docker compose up -d --wait nether-beacon. Dans Discord, essaie /help.

  4. Activer les fonctions supplémentaires.

    Pour full, vérifie le plan du serveur et les intents Discord, puis capture les identifiants des ressources existantes. Pour Muse, configure ses identifiants et initialise son volume. Le guide décrit ces deux parcours séparément.

Lire le guide d’installation