SHADOWS STUDIOS
Shadows Studios Bot · Documentation

Tout ce que fait le bot, expliqué.

De l'invitation au dernier module : comment le configurer, quelles permissions il lui faut, ce que fait chaque fonction et toutes les commandes avec leurs options.
01

Premiers pas

Cinq minutes entre l'invitation et un bot qui fonctionne.

  1. 1Ajoute le bot à ton serveur avec le bouton « Ajouter à Discord ». Il te faut la permission Gérer le serveur sur ce serveur.
  2. 2Ouvre le tableau de bord sur bot.shadowsstudios.com et connecte-toi avec Discord : tu vois tous les serveurs que tu gères.
  3. 3Choisis la langue que le bot utilise avec tes membres : la première fois que tu ouvres un serveur, le tableau de bord te la demande, puis tu la changes dans Paramètres → Langue. Il y a dix langues et le changement est immédiat.
  4. 4Active les modules dont tu as besoin, un par un. Tout le reste reste éteint et ne gêne pas.
  5. 5Lance /admin diagnostic : il vérifie les permissions du bot sur chaque salon configuré et te dit exactement ce qui manque.

Fais glisser le rôle du bot au-dessus des rôles qu'il doit attribuer ou modérer (Paramètres du serveur → Rôles). Discord ne laisse jamais un bot gérer des rôles plus hauts que le sien.

02

Tableau de bord et /admin paramètres

Le bot se configure de deux façons, avec les mêmes réglages.

  • Tableau de bord (bot.shadowsstudios.com) : le plus complet. Aperçus en direct, envoi d'images, carte de rang, automatisations et commandes personnalisées n'existent qu'ici.
  • /admin paramètres sur Discord : un panneau privé avec les mêmes modules, classés par catégorie. Pratique depuis ton téléphone.
  • Dans le tableau de bord, le serveur est visible par ceux qui ont Administrateur ou Gérer le serveur et par les rôles ajoutés comme Maîtres du bot dans Paramètres. Les permissions sont vérifiées en direct sur Discord à chaque requête.
  • Les panneaux qui vivent dans un salon (vérification, rôles au choix, tickets) se publient depuis Discord ; le tableau de bord modifie leurs réglages.
  • Game Hub : Roleplay, FiveM, Diablo IV et les jeux à venir sont dans un seul menu dépliable, pour garder la barre latérale propre.
  • Mon compte : Premium et paiements (avec Gérer ou résilier pour ton abonnement), tes demandes d'assistance, tes données et la vérification en deux étapes avec Google Authenticator, qui protège la connexion et les actions importantes.
  • Guides et recherche : chaque module a un court guide, aussi sur Discord avec /info guide, et la barre de recherche en haut trouve n'importe quel réglage, même avec une faute de frappe.
03

Comment les commandes sont organisées

Discord autorise 100 commandes par serveur. Le bot regroupe toutes les siennes en 9 catégories : le reste est à toi.

  • /mod modération · /rp jeu de rôle · /ticket support · /community tout pour les membres · /crypto cryptomonnaies · /admin gestion du serveur · /custom commandes personnalisées · /info informations · /demandes demandes et absences.
  • Les noms et descriptions des commandes suivent la langue du serveur, choisie dans le tableau de bord : en italien tout le monde voit /mod avvisa, en allemand /mod verwarnen. Changer de langue réenregistre les commandes.
  • Discord applique les permissions à la catégorie ; le bot vérifie ensuite celles de chaque commande à chaque utilisation.
  • Pour choisir qui voit une catégorie : Paramètres du serveur → Intégrations → Shadows Studios Bot.
04

Permissions

L'invitation demande Administrateur, pour que chaque module fonctionne tout de suite. Si tu préfères accorder moins, le bot a besoin d'une base et chaque module n'ajoute que ce qu'il lui faut.

  • Toujours : Voir les salons, Envoyer des messages (aussi dans les fils), Intégrer des liens, Joindre des fichiers, Voir les anciens messages, Ajouter des réactions, Utiliser les commandes de l'application.
  • Modération, Automod, Sécurité : Gérer les messages, Expulser, Bannir, Exclure temporairement des membres, Voir les logs du serveur.
  • Tickets : Gérer les salons, Créer des fils privés, Gérer les fils.
  • Rôles (autorôle, vérification, rôles au choix, niveaux, factions, Tebex) : Gérer les rôles.
  • Salons vocaux temporaires et AFK : Se connecter, Parler, Déplacer des membres, Gérer les salons.
  • Suivi des invitations : Gérer le serveur, Créer une invitation. Journal du serveur : Voir les logs du serveur.

La plupart des problèmes ne sont pas des bugs mais une permission qui manque sur un salon précis. /admin diagnostic la trouve pour toi, avec le nom exact de la permission.

05

Tickets

Des salons de support privés avec formulaire d'ouverture, prise en charge et transcriptions.

  1. 1Définis la catégorie par défaut avec /ticket configurer paramètres et crée au moins un type de ticket : chaque type a sa catégorie, ses rôles du staff, son salon de logs, ses questions et ses messages.
  2. 2Publie le panneau avec le bouton d'ouverture : /ticket configurer panneau.
  3. 3Un membre clique, remplit le formulaire et obtient un salon privé ticket-0001 que seuls lui et le staff voient.
  4. 4Dans le ticket : prendre en charge, fermer, fermer avec un motif, ajouter ou retirer des personnes.
  5. 5À la fermeture, le bot enregistre la transcription complète, une page web façon Discord envoyée dans le salon de logs et, si tu veux, en message privé. Le salon devient closed-… : le staff peut le rouvrir jusqu'à sa suppression, après le nombre d'heures choisi.
  • Jusqu'à 5 questions dans le formulaire d'ouverture (texte court, texte long ou liste déroulante), par type de ticket.
  • Plusieurs types de tickets et panneaux (Premium) : chaque type a sa catégorie, son staff, qui peut le fermer, sa couleur et son formulaire ; jusqu'à 25 depuis le tableau de bord.
  • Fermeture automatique après inactivité, limite de tickets ouverts par membre, liste noire, note de 1 à 5 étoiles.
  • Tickets réservés aux acheteurs : le formulaire demande l'ID de transaction Tebex et le vérifie avant d'ouvrir.
06

Modération et Automod

Les commandes classiques avec contrôle de la hiérarchie des rôles, plus des filtres automatiques.

  • /mod ban (aussi temporaire, ex. 3d), /mod expulser, /mod exclure, /mod avertir, /mod nettoyer, /mod mode-lent, /mod verrouiller.
  • Les avertissements peuvent expirer après un nombre de jours : ils ne comptent plus mais restent dans l'historique (/mod journal).
  • Automod : mots interdits, spam/flood, invitations Discord, mentions de masse, majuscules. Tout est éteint par défaut, seuils réglables. Les mots interdits, les invitations et les mentions sont bloqués par l'AutoMod de Discord avant que quiconque les voie, et seul l'auteur voit pourquoi ; pour le reste, le bot supprime le message et prévient l'auteur en privé.
  • /admin mots-interdits importe une liste publique de mots interdits (10 langues) sans toucher à ceux que tu as ajoutés à la main.
  • Le staff qui a Gérer les messages est exclu, sauf si tu actives « Appliquer aussi au staff » pour faire des tests.
07

Anti-raid, anti-nuke et confinement

Trois protections indépendantes, toutes éteintes jusqu'à ce que tu les actives.

  • Anti-raid : expulse (ou se contente de journaliser) les comptes plus récents qu'un seuil et repère les vagues d'arrivées, avec confinement automatique en option.
  • Anti-nuke : choisis les actions à surveiller (suppression ou création de salons et de rôles, changements de permissions, bannissements, expulsions, webhooks, emojis, bots ajoutés, paramètres du serveur), chacune avec sa limite, et ce qui arrive à qui la dépasse : alerte seule, retrait des rôles, retrait des rôles et exclusion temporaire, expulsion ou bannissement. Les rôles et utilisateurs de confiance ne sont jamais contrôlés.
  • Confinement : /mod confinement activer empêche tout le monde d'écrire dans les salons textuels ; /mod confinement désactiver remet exactement ce qu'il y avait avant.

L'anti-nuke stoppe les dégâts supplémentaires, il n'annule pas ceux déjà faits. Une fois ton serveur en place, fais une sauvegarde de la structure avec /admin sauvegarde créer.

08

Bienvenue, vérification et rôles

Ce que voit un nouveau membre, et comment il obtient l'accès.

  • Bienvenue : embed dans un salon et/ou en MP, avec {user}, {server}, {membercount}, message d'au revoir facultatif et carte graphique avec l'avatar, personnalisable avec couleurs, image de fond, titre et ligne sous le nom (aperçu en direct).
  • Vérification : un bouton qui donne le rôle vérifié (et retire un éventuel rôle « non vérifié »). Panneau : /admin vérification panneau.
  • Autorôle : rôles attribués automatiquement à l'arrivée.
  • Rôles au choix : jusqu'à 20 panneaux avec menu, boutons ou réactions, un ou plusieurs rôles à la fois.
09

Niveaux, économie et communauté

Tout ce qui fait vivre un serveur.

  • Niveaux : XP par messages et vocal, rôles en récompense, carte de rang graphique avec ton propre fond (/community niveau utilisateur).
  • Économie : pièces, récompense quotidienne, travail, boutique de rôles et mini-jeux (/community pièces, /community boutique).
  • Giveaways avec conditions (rôle, niveau, ancienneté du compte, invitations), participations bonus, départ programmé et nouveau tirage.
  • Sondages natifs de Discord (2 à 10 options, jusqu'à 32 jours), suggestions votées par les membres, anniversaires, rappels, AFK.
  • Salons vocaux temporaires, compteurs, starboard, messages épinglés et le jeu du comptage.
10

Game Hub · Jeu de rôle

Pensé pour les serveurs FiveM, RedM et Minecraft. Chaque partie a son propre interrupteur.

  • Factions et service : grades avec rôles, embauche/promotion/renvoi, organigramme mis à jour tout seul, heures de service et rapport hebdomadaire.
  • Personnages : fiches avec validation optionnelle ; le personnage actif apparaît dans les dossiers et les documents.
  • Dossiers : amendes, arrestations, notes et factures avec une monnaie du jeu ; /rp dossier casier pour le casier d'un citoyen.
  • Événements avec inscriptions, places limitées et liste d'attente ; chat anonyme (anonyme pour les membres, jamais pour le staff).
  • État du serveur de jeu : joueurs en ligne, annonces de redémarrage et compteur vocal, avec /rp serveur.
11

Game Hub · FiveM

Connecte ton serveur FiveM (ou RedM) au bot et lance ses commandes depuis Discord. Fait partie du Premium.

  • Connexion : dans tableau de bord → Game Hub → FiveM, tu génères une clé et télécharges la ressource shadows-bridge, déjà prête pour ton bot. Elle fonctionne avec ESX, QBCore, Qbox et les serveurs standalone, sans ouvrir de ports.
  • Commandes du serveur : le bridge lit tout seul les commandes enregistrées (console, framework, txAdmin et scripts personnalisés) avec leurs paramètres. Tu les actives une par une et tu choisis quels rôles peuvent les utiliser.
  • Depuis Discord : /rp fivem exécuter propose les commandes actives ; sans arguments, il ouvre un formulaire avec un champ par paramètre (pour setjob : ID, métier, grade). /rp fivem statut indique si le serveur est connecté.
  • Logs : chaque commande arrive dans le salon choisi avec qui l’a utilisée, paramètres, serveur, date et résultat.

Les commandes s’exécutent avec les permissions de la console du serveur : active seulement celles dont tu as besoin. Dans server.cfg, il faut ajouter la ligne add_ace resource.shadows-bridge command allow, que le panneau te donne à copier avec la clé.

12

Game Hub · Diablo IV

Événements du jeu, alertes du serveur et recherches par commande. Inclus dans le Premium.

  • Événements en direct : pour le Boss mondial, la Marée infernale et la Légion, l'état actuel, le temps restant avant la fin ou le début, la prochaine apparition, la réapparition, la zone et le nom du boss quand il est connu, avec /community diablo evenements.
  • Alertes : pour chaque événement, choisis le salon, le rôle à mentionner et combien de temps avant prévenir (tableau de bord → Game Hub → Diablo IV). Chaque membre active ou désactive le rôle pour lui avec /community diablo suivre.
  • Builds : les builds les plus jouées en haut de la Fosse de la saison en cours, filtrables par classe, avec niveau, temps et lien vers la run, plus le lien vers Mobalytics (/community diablo builds).

Les horaires des événements, la saison en cours et les builds se mettent à jour seuls depuis Helltides.com ; entre deux mises à jour, le bot calcule seul le début, la fin et la réapparition.

13

Streamers, jeux gratuits et actualités

Des annonces automatiques dans le salon de ton choix.

  • Streamers et réseaux : Twitch, Kick, YouTube, Bluesky, Mastodon, Tumblr et flux RSS/podcast. Jusqu'à 15 sources par serveur.
  • Jeux gratuits : Epic, Steam, GOG et d'autres sources, chacun annoncé une seule fois. /community jeux-gratuits affiche les offres du moment.
  • Actualités de jeux : un rôle et un salon par jeu, les membres choisissent ce qu'ils suivent ; publication automatique depuis un RSS, les actus Steam ou les releases GitHub.
  • Messages récurrents et programmés : des embeds construits avec aperçu en direct et publiés quand tu veux.
14

Cryptomonnaies

Les cours et les alertes sans quitter Discord, gratuits sur chaque serveur.

  • /crypto prix, /crypto graphique (de 24 heures à un an), /crypto classement (les plus fortes hausses et baisses du jour parmi les 100 premières) et /crypto convertir entre cryptos et devises.
  • Alertes de prix en message privé (/crypto alerte) : au-dessus ou en dessous d'un prix, ou une variation en pourcentage sur 24 heures. Chaque alerte se déclenche une fois, puis se met en pause jusqu'à ce que tu la réactives.
  • Liste de suivi (/crypto suivi) et préférences : ta devise, alertes activées ou non et un résumé quotidien en message privé à l'heure choisie. Ils t'appartiennent et valent sur tous les serveurs.
  • Les administrateurs choisissent la devise par défaut du serveur et publient un panneau des cours avec jusqu'à 10 cryptos, mis à jour toutes les 5 minutes.

Les cours viennent des données de marché publiques de Binance. Ils sont donnés à titre indicatif et ne sont pas des conseils financiers.

15

Tebex

Vérification des achats avec un rôle automatique par package.

  1. 1Sur Tebex, ouvre Servers (Game Server Integration) et copie la Secret Key du serveur.
  2. 2Colle-la dans /admin paramètres → Tebex (ou dans le tableau de bord). Chaque serveur Discord a sa propre clé.
  3. 3Associe chaque ID de package au rôle Discord qu'il doit donner.
  4. 4L'acheteur lance /ticket vérifier-achat avec son ID de transaction : si le paiement est terminé, il reçoit le rôle.

Chaque transaction ne peut être utilisée qu'une seule fois. Les paiements remboursés et les rétrofacturations sont refusés.

16

Automatisations et commandes personnalisées

Des règles et des commandes à toi, créées depuis le tableau de bord.

  • Automatisations : « si X arrive, fais Y ». Déclencheurs : mot-clé, réaction, horaire, seuil du membre (niveau, invitations, jours sur le serveur).
  • Chaque automatisation exécute de 1 à 5 actions : envoyer un message, ajouter ou retirer un rôle, supprimer le message, avertir, exclure temporairement ou expulser.
  • Commandes personnalisées : elles s'utilisent avec /custom exécuter et leur nom, sans occuper les places de commandes du serveur ; rôles autorisés, salon de réponse et 1 à 5 actions. Jusqu'à 20 par serveur.
17

Sauvegarde du serveur

Un instantané des rôles, catégories, salons et permissions.

  • /admin sauvegarde créer enregistre la structure ; les 10 dernières sauvegardes par serveur sont conservées.
  • /admin sauvegarde restaurer recrée seulement ce qui manque (comparaison par nom) et ne duplique jamais rien.
  • Les messages ne sont pas inclus : Discord n'offre aucun moyen fiable de les sauvegarder.
  • /admin vider supprime tous les salons, catégories et rôles. Seul le propriétaire du serveur peut le lancer, après plusieurs confirmations.
18

Free et Premium

Tout l'essentiel est gratuit, pour toujours. Le Premium est par serveur, mensuel ou annuel.

  • Free : bienvenue, vérification, autorôle, modération, journal du serveur, tickets avec 1 type et transcriptions, jusqu'à 10 embeds actifs, rôles au choix, salons vocaux, compteurs, AFK, niveaux, économie, anniversaires, rappels, jeux gratuits, statistiques, cryptomonnaies.
  • Premium : identité du bot par serveur, sécurité, automod, plusieurs types de tickets, embeds illimités, demandes et formulaires, actualités de jeux, starboard, messages épinglés, comptage, tout le Game Hub (jeu de rôle, FiveM et Diablo IV), invitations, sondages, suggestions, giveaways, automatisations, commandes personnalisées, streamers et réseaux, Tebex et modèles.
  • Activation : après le paiement, le Premium arrive sur le serveur choisi, ou tu reçois une clé en message privé à utiliser dans le tableau de bord ou avec /admin premium activer.
  • Tu peux déplacer le Premium vers un autre serveur que tu gères depuis la page Premium (une fois tous les 7 jours).
  • À l'expiration, le propriétaire reçoit un message privé 7 jours avant. Ensuite les modules Premium se mettent en pause, mais rien n'est supprimé ; un serveur avec un abonnement à renouvellement automatique a 3 jours de grâce le temps que le paiement arrive.
  • Pour résilier un abonnement : Mon compte → Premium et paiements → Gérer ou résilier. Le Premium reste jusqu'à la fin de la période déjà payée ; les paiements PayPal sont uniques et ne se renouvellent pas.
19

Tes données

Ce que garde le bot, et comment tu le vois.

  • Réglages, niveaux, pièces, tickets et historique sont conservés dans la base de données du bot, avec des sauvegardes automatiques.
  • Sur la page Mon compte du tableau de bord, chaque utilisateur voit ce que le bot garde sur lui, serveur par serveur, et le télécharge en JSON.
  • Depuis la même page, tu peux supprimer toi-même ton anniversaire, tes rappels, ton statut AFK, tes fiches de personnage ainsi que tes alertes de prix, ta liste de suivi et tes préférences crypto. Les avertissements, sanctions et dossiers RP restent au staff.
  • Les paiements passent par Stripe (carte, Apple Pay, Google Pay) ou PayPal : les données de carte ne nous parviennent jamais.
  • Le bot ne conserve aucune donnée de facturation : adresse, numéro de TVA, reçus et factures sont gérés par Stripe (et par PayPal pour ses paiements). Le bot retient seulement qui a payé, quel plan et pour quel serveur.
  • La validation en deux étapes garde une clé chiffrée et les codes de récupération seulement sous forme d’empreinte : ils ne peuvent pas être relus.
  • Les propriétaires de serveurs reçoivent un message privé à chaque mise à jour du bot ; le bouton sous le message les désactive.
20

Toutes les commandes

Généré à partir du code du bot, donc toujours à jour. Les noms sont dans la langue de cette page ; sur Discord, ils suivent la langue de ton serveur. Le nom anglais est indiqué sous chacun.

/modModération : bans, expulsions, exclusions, avertissements, nettoyage, verrouillage des salons

/mod ban

Bannir un membre, définitivement ou pour une durée

Syntaxe
/mod ban <utilisateur> [raison] [jours_messages] [durée]
Options
utilisateurobligatoire
Utilisateur à bannir
raisonfacultatif
Raison du ban
jours_messagesfacultatif
Jours de messages à supprimer (0-7)
duréefacultatif
Ban temporaire, ex. 12h, 3d, 1d12h (vide = définitif)
1 / 14

Toujours bloqué ?

Écris-nous depuis la page contact en choisissant « Support du bot » : nous lisons chaque message.