Retour au dashboard
Documentation EH Manager · 42 guides

Wiki EH Manager
Les guides du bot et du dashboard.

De votre premier panneau à la gestion avancée du staff : des procédures détaillées, des exemples et les explications de chaque réglage.

Référence du 29 octobre 2026, établie à partir du code du bot et du contrat du dashboard. Les exemples sont fictifs ; les droits, les ressources et les états affichés par votre bot restent déterminants.

01 / Premiers pas

Installer EH Manager et préparer son serveur

Un parcours complet, de l’ajout du bot à votre premier panneau utilisable.

Préparer votre organisation

EH Manager relie plusieurs usages d’un serveur Emergency Hamburg : rapports de modération, identités RP, annonces de session, avis, absences et suivi du service. Chaque module possède ses rôles et ses salons. Définissez d’abord qui utilise le module, qui consulte ses résultats et qui administre ses réglages.

Un panneau est le message interactif sur lequel les membres cliquent dans Discord. Un salon de logs reçoit les événements produits par ces interactions. Ces deux destinations peuvent être différentes : le panneau d’avis peut être public tandis que les avis reçus restent dans un salon du staff.

Exemple concret

Catégorie COMMUNAUTÉ : #verification, #carte-identite, #donner-un-avis et #session-rp. Catégorie STAFF privée : #rapports-staff, #logs-sanctions, #absences, #prise-de-service et #supervision.

Ordre d’installation conseillé

  1. Ajoutez le bot depuis le lien officiel du site et vérifiez qu’il apparaît sur votre serveur Discord.
  2. Connectez-vous au dashboard avec le compte Discord qui possède la permission Administrateur sur ce serveur.
  3. Sélectionnez le serveur souhaité. Vérifiez toujours son nom avant d’enregistrer ou de publier.
  4. Configurez la Supervision pour disposer d’un salon de suivi des événements et des erreurs.
  5. Configurez les rôles et les salons de chaque module, puis enregistrez les formulaires.
  6. Dans la rubrique du module, ouvrez « Publier un panneau », choisissez le salon et vérifiez la destination avant de publier.
  7. Testez chaque parcours avec un membre de l’équipe et un membre ordinaire. Un administrateur peut disposer de droits supplémentaires et ne représente pas tous les utilisateurs.

Faire une recette utile

Pour les identités, testez la vérification Roblox puis la création d’une carte locale. Pour les sanctions, créez un rapport fictif clairement identifié et retrouvez-le avec /casier. Pour le staff, démarrez et terminez un service, puis déclarez une absence de test et un retour.

Contrôlez les messages réellement visibles dans Discord, les rôles attribués, les salons de réception et les refus d’accès attendus. Une configuration enregistrée dans le dashboard ne confirme pas à elle seule que le bot dispose de toutes les permissions nécessaires pour appliquer ses effets.

02 / Premiers pas

Comprendre le tableau de bord

Connexion, serveur actif, enregistrement des réglages et actualisation des données.

Un serveur à la fois

Le serveur actif apparaît dans la navigation du dashboard. Les réglages et les publications concernent ce serveur. Utilisez « Changer de serveur » pour revenir au sélecteur. Un rôle appelé Modérateur sur un serveur n’est pas le même rôle que son homonyme sur un autre serveur.

La vue d’ensemble sert à rejoindre les rubriques. Chaque module regroupe sa configuration, ses publications Discord et ses options Premium lorsqu’elles existent. Le catalogue des panneaux offre aussi une vue de tous les déploiements, classés par module.

Enregistrer et appliquer

Un champ modifié n’est pas enregistré tant que vous n’avez pas utilisé le bouton de sauvegarde du formulaire concerné. Les réglages ordinaires et les options Premium possèdent des sauvegardes distinctes. Enregistrez les changements utiles au panneau avant de le publier.

Lisez les avertissements même après une réussite. Le bot peut enregistrer le réglage tout en rencontrant un refus Discord lors de l’application d’un rôle, d’un pseudo, d’un avatar ou d’un message. Corrigez la cause indiquée plutôt que de multiplier les sauvegardes.

Si une donnée semble ancienne

Le site conserve les lectures en mémoire pendant la navigation afin d’éviter des appels inutiles. Une mutation, une actualisation explicite, une déconnexion ou un rechargement permet de renouveler les données concernées. Si vous venez de créer un rôle ou un salon dans Discord, actualisez les listes avant de conclure qu’il manque.

Les couleurs peuvent nécessiter un suivi temporaire pendant une synchronisation. La progression du seul serveur concerné permet de distinguer une attente normale d’un échec. Les autres modules ne doivent pas être republiés pour forcer une actualisation visuelle.

03 / Premiers pas

Accès au dashboard et espace OWNER

Comprendre la permission Administrateur, le verrouillage du site et la différence entre propriétaire du serveur et OWNER du bot.

Qui peut administrer un serveur ?

Les routes de configuration du serveur vérifient la permission Discord Administrator et la présence du bot. Posséder un rôle staff autorisant les rapports ou les services ne donne pas automatiquement accès à la configuration web. Les permissions d’usage dans Discord et les permissions d’administration du dashboard répondent à des besoins différents.

Connectez-vous avec le bon compte Discord. Si un serveur manque, vérifiez que le bot y est présent et que votre compte possède réellement Administrateur. Après une modification de droits, actualisez votre session et la liste des serveurs.

Verrouillage et autorisations du site

L’accès au dashboard dépend aussi de la politique globale du site. Le propriétaire du bot peut verrouiller le dashboard, autoriser certains comptes, en bloquer et activer une exception Premium. Une connexion Discord réussie ne garantit donc pas un accès autorisé au site.

La priorité est : OWNER du bot, blocage explicite, autorisation explicite, exception Premium si activée, puis état général du verrouillage. Un blocage explicite reste prioritaire sur les accès ordinaires. Consultez le message affiché et le support si votre accès est refusé.

OWNER n’est pas le propriétaire de votre serveur

L’espace OWNER est réservé à l’identité fixe du propriétaire du bot, vérifiée côté serveur. Il permet l’administration globale des licences, des thèmes, des partenaires et des accès. Être propriétaire d’un serveur Discord ou avoir Administrateur n’ouvre pas cet espace.

Une erreur d’authentification demande généralement une reconnexion. Un refus d’autorisation exige de vérifier les droits ou la politique d’accès. Ne communiquez jamais vos cookies de session, vos jetons ou vos codes de connexion pour obtenir de l’aide.

04 / Premiers pas

Permissions du bot et hiérarchie des rôles

Les autorisations qui conditionnent l’envoi des panneaux et l’application des rôles ou des pseudos.

Publier dans un salon

Vérifiez les permissions effectives dans le salon, pas seulement celles du rôle principal du bot. Une dérogation au niveau du salon ou de sa catégorie peut bloquer l’envoi. Pour publier un panneau depuis le site, choisissez un salon textuel ou d’annonces : une catégorie, un forum ou un salon vocal n’est pas une destination acceptée.

PermissionUtilité
Voir le salonLe bot doit accéder à la destination, y compris dans une catégorie privée.
Envoyer des messagesAutorise la publication du panneau et des notifications.
Intégrer des liensAutorise les embeds utilisés par les panneaux.
Lire l’historique des messagesUtile pour retrouver les panneaux existants et explorer les messages récents lors d’une recherche manuelle.

Attribuer un rôle

  1. Activez la permission Gérer les rôles pour le bot si le module attribue un rôle vérifié, d’absence ou de service.
  2. Placez le rôle du bot au-dessus des rôles qu’il doit attribuer ou retirer.
  3. Choisissez un rôle ordinaire que le bot peut gérer. Un rôle géré par une autre intégration peut être inutilisable.
  4. Testez avec un membre dont les droits sont représentatifs du staff ou de la communauté.

Exemple concret

Ordre du haut vers le bas : Direction → EH Manager → En service → Absent → Citoyen vérifié. Le bot peut alors gérer les rôles situés sous le sien, sous réserve de ses permissions.

Modifier un pseudo

Les préfixes d’absence et de service nécessitent la permission Gérer les pseudonymes. La hiérarchie Discord peut empêcher de modifier certains membres, notamment ceux dont le rôle est trop élevé. L’ajout de permissions n’annule pas toutes les restrictions de hiérarchie.

Si la déclaration ou la prise de service est enregistrée mais que l’apparence du membre n’a pas changé, consultez les avertissements et la supervision. Corrigez le rôle cible ou les permissions plutôt que de créer un second service ou une seconde absence.

05 / Premiers pas

Rôles autorisés, staff et gestionnaires

Choisir les bonnes listes de rôles sans confondre les droits d’un module avec ceux d’un autre.

Chaque liste a un objectif

RéglagePersonnes concernées
Rôles de modérationMembres autorisés à utiliser les outils de rapports et casiers selon les contrôles du bot.
Rôles de recherche de carteServices RP autorisés à consulter les cartes d’autres membres.
Rôles du staff pour les avisMembres qui peuvent être sélectionnés comme personnes évaluées.
Rôles du staff pour les absencesMembres autorisés à déclarer leur absence.
Rôles du staff pour le serviceMembres autorisés à prendre leur service.
Gestionnaires du serviceMembres autorisés à utiliser les outils de gestion du service.

Choisir et vérifier les rôles

Les listes de modération, de recherche d’identité et de gestionnaires acceptent jusqu’à cinq rôles. Les listes de staff des avis, absences et services acceptent jusqu’à cent rôles dans le contrat de l’API. Évitez les doublons et attribuez réellement les rôles aux personnes concernées.

Un rôle qui autorise à utiliser un module ne reçoit pas automatiquement Administrateur sur Discord. Inversement, certains outils du bot prévoient une exception pour les administrateurs. Testez les restrictions avec un compte staff ordinaire pour vérifier que votre liste fonctionne.

Exemple concret

@Police RP peut rechercher une carte locale sans faire partie du @Staff qui prend son service. @Responsable staff peut gérer les compteurs, tandis que @Modérateur utilise seulement le panneau de service.

06 / Premiers pas

Identifiants Discord et salons introuvables

Copier un identifiant, reconnaître un rôle supprimé et comprendre les destinations proposées.

Copier un identifiant Discord

Un identifiant Discord, aussi appelé Snowflake, est une suite de chiffres. Les champs du site acceptent généralement 17 à 20 chiffres. Gardez-le sous forme de texte : il ne sert pas à effectuer un calcul. N’utilisez ni le nom visible, ni une mention comme @Modérateur à la place des chiffres dans une saisie manuelle.

  1. Dans Discord, ouvrez les paramètres utilisateur, puis Avancés et activez le Mode développeur.
  2. Faites un clic droit sur le serveur, le salon, le rôle ou le membre concerné.
  3. Utilisez « Copier l’identifiant » et collez uniquement les chiffres dans le champ prévu.
  4. Vérifiez qu’il s’agit du bon type d’objet et du serveur actif. Un identifiant de membre n’est pas un identifiant de rôle.

Pourquoi un salon ou un rôle manque ?

Le sélecteur de salons de publication ne propose que les salons textuels et d’annonces. Les catégories servent au classement des salons. Les forums et les salons vocaux ne sont pas acceptés pour cette publication. Vérifiez également que le bot voit le salon.

Un salon ou un rôle peut avoir été supprimé depuis son enregistrement. Recréer un objet avec le même nom lui donne un nouvel identifiant : choisissez-le à nouveau et enregistrez le module. Si l’objet vient d’être créé, actualisez les listes du dashboard.

07 / Panneaux Discord

Tous les panneaux, classés par module

Les huit publications disponibles et la différence entre panneau, résultat et notification.

Catalogue complet des publications

RubriquePanneauInteraction principale
Casiers & sanctionsRapports de sanctionsFaire un rapport
Identité RobloxLiaison du compte RobloxLier mon compte
Identité RobloxCréation / modification de carte IDConfigurer ma carte locale
Identité RobloxRecherche de carte IDRecherche carte ID
Sessions RPÉtat de la sessionRejoindre le serveur si la session est ouverte
Avis staffDépôt d’un avisDonner un avis
Absences & congésAbsence / retourDéclarer une absence ou un retour
Prises de servicePrise / fin de servicePrendre ou terminer son service

Les autres embeds sont produits par le bot

Les rapports envoyés après un formulaire, les avis reçus, les logs, les résultats de recherche, les statistiques et les confirmations sont générés au cours de l’utilisation du bot. Ils ne correspondent pas à des panneaux supplémentaires à publier depuis le catalogue.

Un panneau de recherche de carte ne recherche pas les casiers, les plaques ou les sanctions. Le salon Find ID Roblox est un réglage distinct et ne représente pas un neuvième panneau. Pour consulter les casiers, utilisez /casier ; pour obtenir un profil Roblox public par pseudo, utilisez /roblox-id.

Où publier ?

Utilisez la rubrique du module pour garder configuration et publication au même endroit. Le catalogue global rassemble les mêmes huit actions, classées dans les mêmes rubriques. Les deux chemins appellent les mêmes fonctions du bot et appliquent le thème courant du serveur.

Les noms de salons proposés dans ce guide sont des exemples. Choisissez des destinations adaptées à vos règles : un panneau réservé au staff gagne à être dans un salon privé. Un panneau destiné aux citoyens doit rester visible par les personnes qui en ont besoin.

08 / Panneaux Discord

Publier un panneau sans créer de doublon

Préparer le module, confirmer la destination et comprendre les résultats de publication.

Parcours de publication

  1. Ouvrez la rubrique du module et enregistrez ses rôles, salons et autres réglages nécessaires.
  2. Dans la section de publication, choisissez le panneau voulu. Pour les identités, vérifiez que vous choisissez la liaison Roblox, la création de carte ou la recherche de carte.
  3. Sélectionnez un salon textuel ou d’annonces. Relisez le nom du serveur et celui du salon affichés avant l’envoi.
  4. Vérifiez que le bot peut voir le salon, y envoyer des messages et intégrer des liens.
  5. Cliquez une seule fois sur « Publier dans Discord » et attendez la réponse.
  6. Si un lien vers le message est proposé, ouvrez-le et contrôlez les boutons avec un compte qui utilisera le module.

Exemple concret

Vous configurez le module Avis : les rôles évaluables sont @Modérateur et @Administrateur, les logs vont dans #avis-staff, et le panneau « Donner un avis » est publié dans #donner-un-avis, accessible à la communauté.

En cas de réponse incertaine

Publier n’est pas une opération idempotente : répéter l’action peut envoyer un autre message. Si la requête expire ou si la connexion est coupée après l’envoi, le bot peut déjà avoir publié le panneau. Vérifiez Discord avant toute nouvelle tentative. Le site ne doit pas relancer une publication automatiquement.

Une réponse de réussite sans identifiant de message peut arriver pour le panneau de session. Elle ne permet pas de fournir un lien ni de confirmer un message précis. Vérifiez le salon de session et la configuration du module ; ne concluez pas qu’un panneau visible a été identifié.

Après la publication

Le bot construit les embeds et les boutons, applique le thème courant et conserve la référence du message pour les opérations qu’il prend en charge. Le site ne demande pas de token Discord et ne permet pas d’inventer un contenu d’embed ou de bouton.

Publier un panneau de session ne démarre pas la session de jeu. Publier un panneau de service ne met aucun membre en service. Publier un panneau d’absence ne déclare aucune absence : les membres doivent ensuite utiliser les boutons.

09 / Panneaux Discord

Déplacer, remplacer ou retrouver un panneau

Redéployer crée un nouveau message ; les anciens messages restent dans Discord.

Remplacer un panneau proprement

  1. Repérez le panneau existant et choisissez le nouveau salon de destination.
  2. Enregistrez la configuration du module si nécessaire, puis publiez le nouveau panneau.
  3. Testez le nouveau message et vérifiez qu’il reçoit les actualisations attendues.
  4. Retirez manuellement l’ancien message Discord si vous avez les droits nécessaires et si votre équipe a validé le remplacement.
  5. Informez votre équipe du nouvel emplacement pour éviter l’utilisation d’un ancien panneau.

Un panneau très ancien n’est plus recoloré

Les nouveaux panneaux sont enregistrés par le bot. Des panneaux plus anciens peuvent ne pas être suivis. La rubrique Couleurs propose une recherche manuelle limitée aux messages récents ; elle ne garantit pas de retrouver l’ensemble de l’historique.

Si la recherche ne retrouve pas votre message, un redéploiement ciblé dans le bon salon peut être préférable. Vérifiez les doublons et les références du module avant de retirer un ancien exemplaire. Les anciens rapports et avis ne deviennent pas des panneaux à recolorer.

10 / Modération

Supervision et suivi des événements

Un salon administratif pour retrouver les modifications et les erreurs utiles.

Configurer le point de suivi

La supervision facilite le diagnostic des actions importantes : changements de configuration, déploiements et erreurs d’application. Elle complète les salons spécialisés de sanctions, d’avis, d’absence ou de service. Chaque salon spécialisé garde son propre réglage.

Si aucun salon n’est configuré, ou si le salon enregistré n’est plus détecté, le dashboard affiche une alerte rouge et un accès à la configuration. La carte Supervision de la vue d’ensemble passe aussi en rouge. Le bouton Revérifier recharge la configuration et les salons. Une panne de lecture est présentée comme une vérification impossible, sans affirmer que le salon a disparu. Un salon détecté doit encore posséder les permissions nécessaires à l’envoi.

  1. Créez un salon textuel privé, par exemple #supervision, visible par votre administration et le bot.
  2. Dans Supervision, choisissez ce salon et enregistrez.
  3. Vérifiez Voir le salon, Envoyer des messages et Intégrer des liens.
  4. Effectuez une modification de test et consultez les événements reçus.

Lire une erreur utilement

Relevez le module, l’action, la date et la destination concernée. Un enregistrement peut réussir alors qu’un effet Discord échoue : attribution de rôle interdite, salon inaccessible, message supprimé ou module temporairement indisponible.

Si vous demandez de l’aide, fournissez le message d’erreur, l’heure, le serveur et le parcours suivi. Un identifiant de corrélation affiché peut aider le support. Retirez les informations privées et ne publiez ni cookie, ni token, ni URL de webhook.

Exemple concret

La liaison Roblox est réussie mais le rôle vérifié est absent : cherchez un événement d’attribution de rôle, contrôlez Gérer les rôles et placez le rôle vérifié sous EH Manager. Il n’est pas nécessaire de refaire une liaison qui a déjà été enregistrée.

11 / Modération

Casiers et rapports de sanctions

Configurer les modérateurs, enregistrer un rapport et consulter l’historique d’un joueur.

Préparer le module

Le panneau publié sert à ouvrir le formulaire « Faire un rapport ». Les outils de consultation et de gestion sont proposés par /casier dans Discord. Le panneau n’ajoute pas une interface générale de consultation de toutes les sanctions.

  1. Choisissez les rôles autorisés à utiliser les rapports de modération, jusqu’à cinq rôles.
  2. Choisissez un salon privé pour les logs de sanctions.
  3. Enregistrez les réglages avant de publier le panneau de rapports.
  4. Publiez le panneau dans le salon de travail des modérateurs et vérifiez les droits avec un staff ordinaire.

Rédiger un rapport exploitable

Renseignez le pseudo Roblox exact de la personne, la sanction et des détails qui permettent à un autre modérateur de comprendre le contexte. Le bot tente de résoudre le compte Roblox. S’il ne le trouve pas, il peut proposer de corriger le pseudo ou d’envoyer tout de même : relisez attentivement avant de poursuivre.

Chaque rapport possède un identifiant propre. Cet identifiant distingue deux événements concernant le même joueur et facilite une suppression ciblée. Un rapport documente une décision ; son enregistrement ne constitue pas une preuve que le jeu ou Discord a exécuté une sanction externe.

Exemple concret

Pseudo : Exemple_Joueur. Sanction : Avertissement RP. Détails : Refus d’obtempérer constaté pendant la session du 29/10 ; contexte et référence interne ajoutés par le modérateur. Utilisez des informations factuelles, sans données personnelles inutiles.

Consulter et corriger

Ouvrez /casier pour rechercher par membre Discord ou pseudo Roblox et accéder aux outils de gestion autorisés. Identifiez le bon joueur, puis le bon rapport avant d’utiliser une suppression. Un identifiant de rapport n’est ni l’identifiant Discord du membre ni l’identifiant du message de log.

Une suppression dans les outils du bot et la suppression d’un message visible dans Discord sont deux opérations différentes. Ne considérez pas un simple retrait du message comme une purge de la donnée enregistrée. Consultez aussi la durée de conservation si un rapport ancien disparaît des résultats.

12 / Modération

Conservation des sanctions et des avis

Comprendre la durée de rétention, la suppression automatique et l’option sans limite.

Le fonctionnement de la rétention

La rétention est le nombre de jours pendant lesquels les données sont conservées par le module avant leur suppression automatique. Les rapports de sanctions et les avis disposent chacun de leur propre durée. Dans la version du bot consultée, la durée ordinaire est de 60 jours ; les serveurs Premium peuvent définir une durée différente.

Laissez le champ Premium vide pour désactiver la suppression automatique de ce module. Une valeur vide ne signifie pas zéro jour. Les durées numériques configurables vont de 1 à 3 650 jours dans le contrat du dashboard.

Exemple concret

90 jours pour les rapports et 30 jours pour les avis : un ancien avis peut être supprimé alors qu’un rapport de la même date reste encore consultable. Laisser la durée des rapports vide conserve ces rapports sans purge automatique tant que cette politique est applicable.

Changer la durée sans mauvaise surprise

  1. Décidez avec votre équipe de la durée utile pour les rapports et pour les avis.
  2. Vérifiez les données que vous devez conserver avant de réduire la durée.
  3. Enregistrez le formulaire Premium du module concerné.
  4. Prévoyez que les données déjà plus anciennes que la nouvelle limite deviennent éligibles à la purge.
  5. Si Premium expire, vérifiez la politique effectivement appliquée avant de supposer que la conservation personnalisée continue.

13 / Identités & Roblox

Comprendre les trois parcours d’identité

La liaison Roblox, la carte RP et la recherche de carte sont des fonctions distinctes.

Le bon outil pour chaque besoin

BesoinOutilRésultat
Prouver que je possède un compte RobloxPanneau Liaison RobloxAssociation du compte Discord au compte Roblox et rôle vérifié si configuré.
Créer mon personnage pour ce serveurPanneau Création / modification de carte IDCarte RP locale au serveur après vérification Roblox.
Consulter la carte RP d’un citoyenPanneau Recherche de carte IDRecherche soumise aux rôles autorisés.
Trouver l’identifiant public d’un pseudo Roblox/roblox-id ou salon Find ID selon le parcoursProfil public Roblox ; cela ne prouve pas la propriété du compte.

Préparer le parcours des citoyens

Publiez d’abord un panneau de liaison accessible aux nouveaux membres. Ajoutez ensuite le panneau de création de carte locale, avec une explication sur les informations RP attendues. Réservez le panneau de recherche aux services RP qui en ont besoin.

Ne promettez pas une recherche de plaque, de casier ou de matricule avec le panneau de carte ID. Les recherches de carte utilisent les comptes et identifiants Discord ou Roblox. Les sanctions restent dans le module Casiers.

Exemple concret

Un citoyen rejoint #verification, lie son compte Roblox, puis ouvre #carte-identite pour créer son personnage. Un membre de @Police RP consulte sa carte depuis #recherche-identites. Le citoyen n’a pas besoin d’accéder à ce salon de recherche réservé.

14 / Identités & Roblox

Lier et vérifier un compte Roblox

La preuve de propriété passe par un code temporaire dans la bio du compte Roblox.

Parcours du membre

  1. Cliquez sur « Lier mon compte » dans le panneau Roblox.
  2. Saisissez le pseudo Roblox réel du compte, en évitant de confondre le pseudo et le nom d’affichage.
  3. Lisez la réponse privée du bot : elle contient un code temporaire commençant par EH- et un lien vers le profil concerné.
  4. Ouvrez votre propre compte Roblox, placez exactement ce code dans sa description publique et enregistrez.
  5. Revenez dans Discord et cliquez sur « Vérifier » pendant que l’interface temporaire est encore active.
  6. Attendez le résultat. Si le code est trouvé, la liaison est enregistrée et le rôle vérifié configuré est tenté.

Exemple concret

Code fictif : EH-ABC123. Copiez le code réellement fourni par votre interaction ; un exemple du wiki ne permet aucune vérification.

Si le code n’est pas trouvé

Vérifiez que vous modifiez la bio du bon compte, que la modification est enregistrée et que le code correspond à l’interaction en cours. Le bot lit la description publique du profil : envoyer le code dans un message Discord ne suffit pas.

La vue de vérification est temporaire ; dans le code consulté, elle dure cinq minutes. Si l’interaction n’est plus active, recommencez depuis le panneau pour obtenir un nouveau code. La lecture du profil peut également échouer si Roblox est temporairement inaccessible.

Liaison réussie, rôle absent

Le résultat peut indiquer que le compte est lié mais que le rôle vérifié n’a pas pu être attribué. La liaison et l’attribution du rôle sont des étapes distinctes. L’administrateur doit vérifier le rôle sélectionné, Gérer les rôles et la hiérarchie Discord.

Ne fournissez jamais de mot de passe Roblox au bot ou au support. Le parcours de liaison utilise le profil public et un code temporaire, sans vous demander vos identifiants de connexion Roblox.

15 / Identités & Roblox

Le rôle vérifié après liaison

Configurer un rôle facultatif attribué après une vérification Roblox réussie.

Choisir le rôle

Le rôle vérifié permet de matérialiser la liaison sur votre serveur. Vous pouvez l’appeler Citoyen vérifié, Compte lié ou choisir un nom adapté à votre communauté. Son nom ne change pas la procédure de preuve Roblox.

Ce rôle est facultatif. Si vous en sélectionnez un, vérifiez qu’il existe sur le serveur actif, qu’il se trouve sous le rôle du bot et que celui-ci dispose de Gérer les rôles. L’absence de rôle attribuable n’empêche pas nécessairement l’association du compte d’être enregistrée.

Exemple concret

Vous réservez les salons RP au rôle @Citoyen vérifié. Vérifiez que #verification reste accessible aux nouveaux membres : sinon ils ne pourront pas effectuer l’action qui donne accès au reste du serveur.

Changer de rôle vérifié

Enregistrez le nouveau rôle dans Identité Roblox. Ne supposez pas que ce changement effectue automatiquement une migration de tous les anciens membres. Contrôlez les membres déjà vérifiés et préparez séparément une transition si votre organisation l’exige.

16 / Identités & Roblox

Créer ou modifier une carte d’identité RP locale

Une carte pour le personnage du serveur, enregistrée après vérification Roblox.

Créer la carte du serveur

Le panneau de création ouvre « Configurer ma carte locale ». Le bot demande une vérification Roblox avant d’enregistrer la carte. La carte locale appartient au contexte du serveur RP : elle ne remplace pas une pièce d’identité réelle et doit contenir les informations de votre personnage.

Le formulaire du bot propose notamment le nom RP, la date de naissance, la nationalité, le genre et le métier facultatif. Respectez les formats demandés par le formulaire et les règles RP de votre communauté.

Exemple concret

Personnage fictif : Alex Martin, naissance RP 14/03/1998, nationalité française, métier Civil. Utilisez une identité de personnage, sans saisir une adresse ou un document d’identité réel.

Modifier et afficher ses cartes

Utilisez à nouveau le panneau local pour modifier la carte de ce serveur. La commande /carte-id permet aussi d’afficher ou configurer les cartes proposées par le bot, dont le parcours global et le parcours local. Relisez le contexte affiché avant de modifier une carte.

Si aucune carte n’est trouvée, vérifiez le serveur actif, l’existence d’une carte enregistrée et la liaison Roblox. Un compte lié ne signifie pas automatiquement qu’un formulaire de carte RP a déjà été complété.

17 / Identités & Roblox

Rechercher la carte RP d’un membre

Limiter la consultation aux services autorisés et choisir un identifiant fiable.

Configurer les autorisations

Dans Identité Roblox, choisissez jusqu’à cinq rôles autorisés à rechercher l’identité des autres membres. Enregistrez-les, puis publiez le panneau de recherche dans le salon destiné à ces services RP.

Le bot contrôle l’autorisation lors de l’interaction. Un panneau visible n’accorde pas à lui seul le droit de consulter les cartes. Les permissions du salon complètent cette restriction et réduisent l’exposition d’une interface réservée.

Effectuer une recherche

  1. Cliquez sur « Recherche carte ID ».
  2. Saisissez une référence prise en charge : compte ou identifiant Discord, pseudo Roblox ou identifiant Roblox.
  3. Vérifiez que le résultat correspond à la bonne personne et au contexte RP recherché.
  4. Si le résultat manque, demandez au membre de vérifier sa liaison et l’enregistrement de sa carte locale.

18 / Identités & Roblox

Find ID Roblox et recherche de profil public

Le salon Find ID est un réglage distinct du panneau de recherche de carte RP.

Ce que règle le salon Find ID

Le champ Find ID choisit le salon associé au parcours de recherche d’identifiant Roblox du bot. Il ne déploie pas un panneau de carte et ne définit pas les rôles autorisés à consulter les cartes RP. Enregistrez ce champ seulement si vous utilisez ce parcours.

La commande /roblox-id recherche un compte Roblox par son pseudo et affiche les informations publiques résolues, notamment le pseudo, le nom d’affichage et l’identifiant. Le pseudo attendu suit le format Roblox vérifié par le bot : lettres, chiffres et tiret bas, de 3 à 20 caractères.

Exemple concret

/roblox-id username:Exemple_Joueur permet de chercher le profil public. Cela n’établit pas que la personne qui exécute la commande possède ce compte.

Éviter les confusions

Un identifiant Roblox représente le compte Roblox ; un identifiant Discord représente le compte Discord. Le nom d’affichage Roblox peut différer du pseudo réel et n’est pas la référence la plus fiable. Pour prouver la propriété du compte, utilisez la liaison par code, puis créez la carte RP si nécessaire.

19 / Sessions RP

Publier et gérer une session Emergency Hamburg

Le panneau affiche l’état ; les commandes Discord ouvrent et ferment la session.

Configurer puis publier

Quand la session est fermée, le panneau affiche son état fermé. Quand elle est ouverte et correctement configurée, il peut proposer le bouton pour rejoindre le serveur. Le panneau reflète le système de session du bot ; il ne constitue pas un relevé garanti du nombre de joueurs présents dans Roblox.

  1. Renseignez le code de connexion de votre serveur privé dans Sessions RP.
  2. Enregistrez le formulaire standard.
  3. Si Premium est actif, préparez éventuellement une description et un rôle à notifier dans le formulaire Premium.
  4. Publiez le panneau Session dans votre salon d’annonce.
  5. Vérifiez son état actuel : une publication ne doit pas être interprétée comme un démarrage.

Ouvrir et fermer

Utilisez /session-démarrer pour ouvrir officiellement la session, puis /shutdown pour la fermer et actualiser l’affichage. Le rôle gratuit de gestion des sessions autorise ces commandes, tout comme la permission Gérer le serveur. La configuration reste réservée aux administrateurs. Ce rôle est distinct du rôle de notification Premium.

La fermeture de session termine aussi les services actifs pris en charge par le bot et enregistre le temps associé. Prévenez les gestionnaires du staff avant une fermeture utilisée uniquement comme essai.

Exemple concret

18 h : ouverture avec /session-démarrer ; les membres voient le bouton de connexion. 22 h : fermeture avec /shutdown ; le panneau affiche l’état fermé et les services encore actifs sont clôturés.

20 / Sessions RP

Code du serveur privé et annonce Premium

Préparer la connexion, la description et la mention de rôle sans confondre sauvegarde et démarrage.

Le code de connexion

Renseignez le code ou la valeur de connexion attendue par votre serveur privé et relisez la destination produite dans Discord après un test d’ouverture. Le contrat du dashboard accepte de 2 à 4 000 caractères pour la valeur lorsqu’elle est renseignée.

Ne collez pas un mot de passe de compte Roblox ou un secret de bot dans ce champ. Si votre code change, enregistrez le nouveau réglage et vérifiez le panneau de session. Le redéploiement reste une action distincte qui peut créer un second message.

Description et rôle à notifier

Les options Premium permettent une description d’annonce personnalisée, jusqu’à 500 caractères, et un rôle à mentionner. Choisissez un rôle correspondant aux personnes qui souhaitent recevoir vos annonces et vérifiez les permissions de mention du bot.

Enregistrer une description ou choisir un rôle ne démarre pas une session. Le lancement reste piloté par /session-démarrer. Évitez de sélectionner un rôle très large sans avoir vérifié les règles de notification de votre communauté.

Exemple concret

Description : « Session RP sérieuse à partir de 18 h. Merci de lire les règles avant de rejoindre. » Rôle : @Alertes sessions, attribué aux membres intéressés.

21 / Avis staff

Recueillir et gérer les avis du staff

Sélection des personnes évaluables, note, commentaire, classement et gestion.

Préparer les avis

La liste des rôles staff définit les personnes évaluables. Elle ne sert pas à limiter le dépôt d’avis à ces seuls rôles. Choisissez les personnes à évaluer selon votre organisation, indépendamment des listes de staff des absences et du service.

  1. Sélectionnez les rôles des membres du staff qui peuvent être évalués.
  2. Choisissez le salon où seront publiés les avis reçus.
  3. Enregistrez les réglages.
  4. Publiez le panneau « Dépôt d’un avis staff » dans un salon accessible à votre communauté.
  5. Testez avec un membre non administrateur pour contrôler la sélection du staff et la destination de l’avis.

Parcours du membre

Le membre clique sur « Donner un avis », sélectionne un staff, saisit une note de 0 à 5 et un commentaire. Le formulaire accepte notamment une note décimale ; le commentaire comporte de 10 à 1 000 caractères dans le code consulté.

Le bot limite les avis répétés d’un même auteur sur un même staff : le délai est de 24 heures dans cette version. Si un avis est refusé pour cette raison, attendez le délai affiché au lieu de multiplier les essais.

Exemple concret

Note : 4.5. Commentaire : « Intervention claire et respectueuse ; les explications m’ont permis de comprendre la règle. » Décrivez une expérience précise sans publier de données privées.

Gestion dans Discord

La commande /avis-admin ouvre les outils de moyennes, classement et suppression prévus pour la gestion autorisée. Relisez la cible avant de supprimer un avis, de vider les avis d’une personne ou d’utiliser une action plus globale.

La durée de conservation s’applique aussi aux avis. Si un avis ancien manque, vérifiez la rétention avant de supposer une erreur de recherche. Retirer un message du salon de logs ne constitue pas nécessairement une suppression dans les données du bot.

22 / Avis staff

Avis anonymes et confidentialité

L’anonymat Premium masque l’auteur dans les affichages prévus ; il ne faut pas promettre une absence de conservation.

Activer l’option

Un serveur Premium peut autoriser les avis anonymes. Activez l’option dans les réglages Premium du module et enregistrez. Lors du dépôt, le formulaire peut alors proposer le choix entre un avis normal et un avis anonyme.

Le texte du bot indique que le nom est masqué dans les affichages et les logs prévus pour l’avis anonyme. Cela ne signifie pas que le système cesse de traiter l’identité de l’auteur : les contrôles de délai et les opérations de gestion peuvent en avoir besoin.

Présenter la règle à votre communauté

Expliquez où les avis sont visibles et qui peut les consulter ou les gérer. Un commentaire peut révéler indirectement son auteur, même si le nom est masqué. Demandez aux membres de ne pas inclure de données personnelles et définissez une règle de modération des avis.

Si vous désactivez l’option, vérifiez le formulaire d’un nouvel avis. Ne promettez pas que ce réglage réécrit automatiquement tous les avis et messages historiques.

23 / Organisation du staff

Déclarer une absence et signaler son retour

Rôles autorisés, échéance, motif et suivi du retour.

Configurer le module

Le panneau contient les actions « Déclarer une absence » et « Déclarer un retour ». Il affiche aussi les absences suivies. Placez-le dans un salon approprié : le motif est enregistré et peut apparaître dans les logs, il ne faut donc pas le présenter comme un message privé confidentiel.

  1. Choisissez les rôles staff autorisés à déclarer une absence.
  2. Sélectionnez le salon de logs et notifications d’absence.
  3. Décidez si les absences échues doivent être retirées automatiquement.
  4. Enregistrez, puis publiez le panneau dans un salon du staff.
  5. Si Premium est actif, configurez séparément le rôle temporaire et le préfixe de pseudo souhaités.

Parcours du staff

  1. Cliquez sur « Déclarer une absence ».
  2. Saisissez une date de retour au format JJ/MM/AAAA et une heure au format HH:MM, dans le futur.
  3. Rédigez un motif de 5 à 500 caractères, limité aux informations utiles à l’organisation.
  4. Validez et vérifiez la confirmation ainsi que le retour prévu affiché.
  5. Si vous revenez plus tôt ou si le retrait automatique est désactivé, utilisez « Déclarer un retour ».

Exemple concret

Retour : 15/11/2026 à 18:00. Motif : « Indisponibilité personnelle, retour prévu dimanche. » Il n’est pas nécessaire de détailler des informations médicales ou familiales.

24 / Organisation du staff

Retrait automatique des absences

Choisir si une absence doit prendre fin automatiquement à l’échéance.

Option activée ou désactivée

Quand le retrait automatique est actif, le bot traite les absences dont la date de retour est atteinte et met à jour leur suivi. Le traitement dépend du fonctionnement du bot ; il ne faut pas promettre une suppression à la seconde exacte.

Quand il est désactivé, demandez au staff de signaler explicitement son retour depuis le panneau. Une date passée n’est pas à elle seule une preuve que le membre a repris ses fonctions. Choisissez l’option selon votre manière de gérer les retours.

Exemple concret

Votre équipe préfère confirmer chaque reprise : désactivez le retrait automatique et demandez l’utilisation de « Déclarer un retour ». Si vous préférez un suivi fondé sur l’échéance annoncée, activez-le et vérifiez les rôles temporaires Premium.

Une absence reste affichée

Vérifiez d’abord que l’option est enregistrée, que la date attendue est réellement passée dans le fuseau utilisé par le bot et que le bot est en ligne. Consultez ensuite la supervision pour repérer une erreur de retrait du rôle, de pseudo ou d’actualisation du panneau.

Ne publiez pas plusieurs panneaux pour supprimer une absence. Le panneau est une interface ; le retour ou le traitement de l’échéance est l’action qui termine l’absence enregistrée.

25 / Organisation du staff

Rôles et préfixes temporaires Premium

Automatiser l’apparence des membres pendant une absence ou un service.

Deux réglages séparés

Les Absences et les Prises de service possèdent chacun un rôle temporaire et un préfixe de pseudo Premium. Le rôle d’absence s’applique au parcours d’absence ; le rôle de service s’applique au parcours de prise et de fin de service. Ces rôles ne remplacent pas les listes qui autorisent l’utilisation des modules.

Le préfixe accepte jusqu’à 24 caractères dans le contrat du dashboard. Choisissez une valeur courte qui laisse le nom du membre lisible et vérifiez le résultat dans Discord. Les changements de pseudo restent soumis aux limites et à la hiérarchie Discord.

Exemple concret

Absence : rôle @Absent et préfixe [ABS]. Service : rôle @En service et préfixe [SERVICE]. Le rôle @Modérateur autorise les interactions ; les deux rôles temporaires servent à afficher l’état.

Permissions et contrôle

  1. Placez les rôles temporaires sous celui du bot.
  2. Autorisez Gérer les rôles et, si vous utilisez les préfixes, Gérer les pseudonymes.
  3. Enregistrez le formulaire Premium du module concerné.
  4. Testez une entrée puis une sortie avec un membre ordinaire du staff.
  5. Si un effet échoue, vérifiez la supervision : le service ou l’absence peut avoir été enregistré malgré l’échec visuel.

26 / Organisation du staff

Prendre et terminer son service

Suivre l’activité du staff et comprendre le rôle du panneau, des logs et des gestionnaires.

Configurer le suivi

Le panneau comporte « Prendre son service » et « Terminer son service ». Il affiche les membres actuellement en service. Il ne comporte pas de bouton de pause dans la version consultée. Pour interrompre un service, terminez-le ; vous pourrez démarrer un nouveau service lorsque vous reprenez.

  1. Choisissez les rôles autorisés à prendre leur service.
  2. Choisissez jusqu’à cinq rôles de gestionnaires pour les outils d’administration du service.
  3. Sélectionnez le salon de logs de prise et de fin de service.
  4. Enregistrez, puis publiez le panneau dans un salon du staff.
  5. Testez un début et une fin de service, puis consultez les compteurs avec /service-admin.

Temps actif et temps crédité

La prise de service ouvre une période active. La fin de service clôture cette période et enregistre sa durée, en tenant compte du multiplicateur Premium applicable. Ne confondez pas un membre affiché comme actif avec un total déjà finalisé.

Un oubli de fin de service peut produire une durée inadaptée à votre activité réelle. Les gestionnaires disposent d’outils de contrôle dans Discord. La commande /shutdown du module Sessions clôture aussi les services actifs : utilisez-la en tenant compte de ce comportement.

Exemple concret

Un modérateur prend son service à 18:00 et le termine à 19:30 : sa période dure 1 h 30 avant éventuel multiplicateur. Il vérifie ensuite son total dans les outils de suivi plutôt que de relancer le bouton de fin de service.

27 / Organisation du staff

Gestionnaires, compteurs et statistiques du staff

Consulter les classements, contrôler un service actif et distinguer les actions destructives.

Le centre /service-admin

La commande /service-admin ouvre le centre de gestion avec les informations de service, le classement et les fiches des membres selon les droits reconnus par le bot. Les gestionnaires configurés doivent posséder leur rôle sur le serveur.

Les outils peuvent proposer un arrêt forcé, une modification de temps, un vidage de compteur ou une réinitialisation globale avec les restrictions prévues. Vérifiez la cible et la portée de chaque action. Mettre fin à un service actif et vider son historique de temps sont des opérations différentes.

Une lecture transversale avec /staff-stats

La commande /staff-stats rassemble les statistiques enregistrées du staff, notamment ses avis, sa moyenne, les rapports rédigés et le temps de service crédité. Elle décrit les données connues du bot ; elle ne mesure pas toute l’activité réelle du membre sur Roblox ou dans Discord.

Si un total paraît incohérent, vérifiez les périodes déjà terminées, les multiplicateurs, les modifications manuelles, la politique de remise à zéro et les éventuelles purges. Notez la date et l’heure de votre observation avant de comparer deux écrans.

28 / Organisation du staff

Multiplicateurs de temps de service

Un bonus de temps crédité par rôle, avec le plus grand multiplicateur applicable.

Règle de calcul

Les multiplicateurs Premium modifient le temps crédité pour certains rôles. Le bot part de ×1 et retient le plus grand multiplicateur parmi les rôles possédés par le membre. Les multiplicateurs ne s’additionnent pas et ne se multiplient pas entre eux.

Le multiplicateur est déterminé lors de la clôture du service dans les parcours consultés. Si vous changez les rôles d’un membre ou les réglages pendant un service actif, vérifiez le résultat à la fin plutôt que de supposer une répartition automatique par tranche horaire.

Exemple concret

Un membre termine 60 minutes de service et possède des rôles à ×1,25 et ×1,5. Le plus grand s’applique : 60 × 1,5 = 90 minutes créditées. Cela ne donne ni ×2,75 ni ×1,875.

La valeur ×0,5 et le plancher actuel

Le contrat accepte aussi ×0,5, mais le moteur consulté conserve un plancher de ×1 en prenant le maximum à partir de 1. Une valeur ×0,5 ne réduit donc pas le temps crédité dans cette version. N’utilisez pas ce réglage en pensant diviser les heures par deux.

Les autres valeurs proposées sont ×1,25, ×1,5, ×1,75 et ×2. Préférez une politique facile à expliquer à votre staff. Un bonus doit être compris par les personnes qui comparent les classements.

29 / Organisation du staff

Remise à zéro automatique des compteurs

Définir un intervalle en jours et anticiper son effet sur les comparaisons de temps.

Choisir une périodicité

Le réglage Premium de remise à zéro accepte un intervalle de 1 à 3 650 jours. Laissez le champ vide pour ne pas demander de reset automatique. Sept jours exprime une période de sept jours ; cela ne garantit pas une exécution chaque lundi à minuit.

Une remise à zéro modifie les compteurs suivis pour votre période de gestion. Les classements observés avant et après ne portent plus sur la même durée. Définissez une règle commune à l’équipe avant d’activer l’automatisation.

Exemple concret

Votre quota est évalué par périodes de sept jours : configurez 7, expliquez la règle aux gestionnaires et relevez le début de période réellement appliqué par le bot. Pour un bilan mensuel civil, ne supposez pas que 30 jours correspond à tous les mois du calendrier.

Avant une remise à zéro manuelle

Vérifiez si l’action vise un membre ou le serveur entier. Consultez et conservez les éléments utiles à votre bilan avant de confirmer. Une opération de vidage n’est pas une simple actualisation de l’écran.

Si des services sont encore actifs, examinez leur état avec les gestionnaires. Ne déclenchez pas un reset uniquement parce qu’un total semble ancien : terminez d’abord le diagnostic des périodes, des bonus et des sauvegardes.

30 / Apparence & Premium

Choisir la couleur du bot

Catalogue, accès gratuit ou Premium et différence entre le choix enregistré et la couleur effective.

Le catalogue et les états

Le dashboard affiche le catalogue fourni par le bot. La disponibilité dépend de la politique d’accès et des ressources du thème. Le cyan reste la couleur gratuite par défaut et la solution de repli. Les autres couleurs peuvent être gratuites, réservées à Premium ou désactivées par OWNER.

Une couleur dont les emojis ou l’avatar nécessaires sont incomplets ne doit pas pouvoir être enregistrée comme une couleur prête. Fiez-vous aux états affichés : Disponible, Premium requis, Désactivée ou Ressources en préparation. Le catalogue et ses états peuvent évoluer.

ÉtatInterprétation
DisponibleLa couleur est autorisée pour ce serveur et ses ressources sont prêtes.
Premium requisLa politique réserve cette couleur à un Premium actif.
DésactivéeOWNER a fermé l’accès à cette couleur.
Ressources en préparationLes ressources nécessaires ne sont pas toutes prêtes.

Choix enregistré et couleur effective

Le choix enregistré est votre préférence sauvegardée. La couleur effective est celle que le bot est actuellement autorisé à utiliser après contrôle de Premium, de la politique et des ressources. Ces deux valeurs peuvent être différentes sans que votre préférence ait été effacée.

Une couleur effective n’atteste pas que tous les anciens messages et avatars visibles dans Discord ont déjà été mis à jour. Consultez la synchronisation pour connaître le résultat des opérations concrètes.

Exemple concret

Vous avez choisi Violet. Si Premium expire alors que Violet est réservé à Premium, le choix peut rester Violet et la couleur effective devenir Cyan. Lorsque l’accès redevient possible, la préférence conservée peut être réconciliée par le bot.

Quels éléments changent ?

Le système de thèmes s’applique aux nouvelles interfaces et aux panneaux connus qu’il peut synchroniser. Les anciens logs de sanctions, d’avis, d’absences et de services ne doivent pas être considérés comme un historique à recolorer intégralement.

Un avatar personnalisé Premium reste prioritaire sur l’avatar du thème. Un changement de couleur ne signifie donc pas nécessairement que votre avatar personnalisé va être remplacé.

31 / Apparence & Premium

Délai partagé entre changements de couleur

Le délai d’un serveur est commun au site, à la réapplication et à /config dans Discord.

Une limite par serveur

Le contrat du 29 octobre prévoit 60 secondes entre les changements de thème d’un même serveur. Le changement de couleur, la réapplication et le réglage depuis /config partagent ce délai. Changer d’onglet ou redémarrer le bot ne le contourne pas.

Le backend reste l’autorité. Le dashboard peut afficher un compte à rebours, mais une tentative trop rapide peut encore être refusée si une autre personne vient de modifier le thème. Une tentative refusée ne doit pas modifier la préférence ni prolonger le délai.

Exemple concret

À 18:00:00, un administrateur choisit Vert depuis le site. À 18:00:20, un autre tente Violet avec /config : le même délai du serveur s’applique. Un autre serveur conserve son propre délai indépendant.

Si un refus 429 apparaît

Un refus theme_cooldown demande d’attendre le délai fourni. Actualisez l’état si nécessaire et ne relancez pas la mutation à répétition. Ce délai n’est pas la preuve que la synchronisation des messages ou de l’avatar est déjà terminée.

32 / Apparence & Premium

Application des couleurs et avatars différés

Une préférence enregistrée peut continuer à s’appliquer en arrière-plan.

Lire la progression

Les compteurs distinguent les messages modifiés, ceux qui sont manquants et les échecs. Un message manquant peut avoir été supprimé. Un échec peut provenir des permissions ou d’un refus Discord. Une préférence sauvegardée et une application complète sont deux résultats différents.

StatutCe qu’il signifie
En attenteUne tâche est enregistrée ou attend une prochaine tentative autorisée.
En coursLe bot traite les opérations prévues.
TerminéeLa tâche a terminé son périmètre ; lisez aussi les compteurs et avertissements.
PartielleUne partie seulement des opérations a réussi ou a pu être traitée.
ÉchouéeL’opération n’a pas abouti ; consultez les avertissements.

Pourquoi un avatar attend ?

Discord peut imposer une attente avant une nouvelle modification d’avatar. Le bot peut alors afficher une source d’avatar différée et programmer une prochaine tentative. Une tâche en attente peut correspondre à une attente volontaire, pas à un blocage permanent.

Les tentatives sont limitées et réconciliées en arrière-plan. La prochaine tentative peut se produire après l’échéance affichée selon le rythme du worker. Ne promettez pas une application instantanée et n’essayez pas de forcer le résultat en choisissant plusieurs couleurs successivement.

Réagir à un résultat partiel

  1. Actualisez l’état du seul serveur concerné.
  2. Lisez les avertissements, les salons ignorés et la prochaine tentative d’avatar lorsqu’ils sont disponibles.
  3. Corrigez les permissions ou la ressource signalée.
  4. Attendez le délai de modification et utilisez la réapplication manuelle si elle est nécessaire.
  5. Contrôlez ensuite un panneau récent et l’avatar réellement visibles dans Discord.

33 / Apparence & Premium

Rechercher les panneaux récents : un outil limité

Une migration manuelle des anciens panneaux, avec un périmètre plafonné.

Les limites à connaître avant le lancement

Le dashboard doit privilégier les limites renvoyées par le bot lorsqu’elles sont disponibles. Cette recherche est partielle par conception. Elle ne parcourt pas tout l’historique et peut laisser de côté un panneau ancien, un salon non exploré ou un message inaccessible.

Limite du contratValeur
Salons texte ou fils actifs connus20 maximum
Messages récents par salon200 maximum
Messages au total2 000 maximum
Budget de recherche60 secondes
Nouvelle recherche sur un serveurUne fois par heure
Fils archivésNon parcourus
Concurrence globaleUne recherche active maximum pour le bot

Quand l’utiliser ?

Utilisez-la si un ancien panneau n’a pas été enregistré par le suivi des thèmes. Elle reconnaît les panneaux persistants connus, les enregistre et programme leur recoloration. Les rapports de sanctions et les avis historiques ne sont pas des cibles de cette migration.

Un résultat « Terminée » concerne seulement le périmètre récent parcouru. Un résultat partiel peut indiquer des permissions manquantes ou un plafond atteint. Consultez les compteurs et les salons ignorés. Une recherche déjà active ne doit pas être dupliquée.

Si rien n’est trouvé

Vérifiez les permissions et l’ancienneté du message. Attendez le délai avant une nouvelle recherche. Si le panneau est trop ancien, préférez un redéploiement ciblé, après vérification du salon et des doublons.

La recherche n’est pas un prérequis à une nouvelle publication. Ne la lancez pas automatiquement au chargement du site ou après chaque changement de couleur.

34 / Apparence & Premium

Comprendre les options Premium

Les possibilités avancées dépendent du Premium actif du serveur et des politiques du bot.

Options par module

ModuleOptions avancées
CasiersDurée de conservation personnalisée ou suppression automatique désactivée.
AvisDurée personnalisée et possibilité d’avis anonymes.
SessionsDescription et rôle à notifier pour l’annonce.
AbsencesRôle temporaire et préfixe de pseudo.
ServiceRôle temporaire, préfixe, remise à zéro périodique et multiplicateurs.
Profil du botPersonnalisation du nom, de la bio et des médias selon les capacités appliquées.
CouleursAccès aux couleurs dont la politique est Premium.

Enregistrer et vérifier

Le statut Premium est lié au serveur actif. Une option déverrouillée sur un serveur ne l’est pas nécessairement sur un autre. Les formulaires Premium se sauvegardent séparément des réglages standards ; l’API contrôle aussi les droits côté serveur.

Une option enregistrée peut produire des avertissements si un effet Discord ne peut pas être appliqué. Vérifiez les permissions et l’état réel, surtout pour les rôles, les pseudos et les médias du bot. Si Premium vient d’être activé ou a expiré, actualisez la configuration avant de conclure que l’interface est incorrecte.

Lors d’une expiration

Les fonctions réservées à Premium ne doivent plus être présumées actives. Les couleurs peuvent revenir au cyan sans effacer le choix sauvegardé. Les politiques ordinaires de conservation peuvent redevenir applicables. Vérifiez les modules concernés, en particulier si vous comptiez sur une conservation sans limite.

Consultez la page Premium et le support officiels pour les modalités de licence en vigueur. Les exemples du wiki n’indiquent ni tarif ni engagement commercial.

35 / Apparence & Premium

Personnaliser le profil du bot sur un serveur

Nom, bio, avatar et bannière : distinguer le réglage sauvegardé du résultat Discord.

Préparer le profil

La personnalisation Premium du serveur propose un nom d’affichage jusqu’à 32 caractères et une bio jusqu’à 190 caractères. Utilisez des textes courts qui identifient clairement le service rendu par le bot. Évitez d’annoncer des commandes inexistantes dans la bio.

Les images sont envoyées depuis les champs de fichier du dashboard. Respectez les formats et limites affichés. Le formulaire actuel indique notamment 8 Mo pour l’avatar et 10 Mo pour la bannière ; les validations du backend et les capacités Discord restent décisives.

Exemple concret

Nom : « EH Manager · Hambourg RP ». Bio : « Outils du staff et identité RP. Utilisez les panneaux du serveur ou /carte-id pour votre personnage. »

Avatar personnalisé et thème

Un avatar personnalisé Premium actif est prioritaire sur l’avatar de la couleur. Si vous souhaitez voir l’avatar du thème, examinez d’abord la personnalisation du profil. Le changement de couleur n’efface pas automatiquement un avatar personnalisé.

Le bouton de retour à l’apparence par défaut réinitialise les réglages du profil selon le parcours prévu. Relisez les avertissements et vérifiez le résultat réel dans Discord. Certaines opérations de profil peuvent être différées ou partiellement appliquées.

36 / Administration OWNER

Politique globale des thèmes et avatars

Réglages réservés au propriétaire du bot, avec effets possibles sur plusieurs serveurs.

Accès des couleurs

OWNER peut définir une couleur comme gratuite, Premium ou désactivée. Le cyan doit rester gratuit. Fermer une couleur ou rendre ses ressources incomplètes peut faire revenir les serveurs concernés au cyan effectif tout en conservant leur choix sauvegardé.

Une modification globale déclenche une réconciliation gérée par le bot avec une concurrence limitée. Le frontend ne doit pas parcourir tous les serveurs pour déclencher leur réapplication individuellement. Attendez les résultats et consultez les avertissements.

Avatars fournis avec le bot

Les photos de profil des couleurs sont maintenant gérées avec les ressources du code du bot, notamment les fichiers du dossier pdp/. Le dashboard conserve un aperçu en lecture seule et ne propose plus d’envoi ou de suppression de ces images. Leur mise à jour se fait avec le déploiement du bot.

Le contrat recommande des PNG de 512 × 512 et de moins de 8 Mio. Le site n’envoie ni chemin système ni URL externe pour changer un avatar de couleur. L’avatar Premium personnalisé d’un serveur reste une fonction distincte et prioritaire.

Priorité et ressources existantes

Le backend choisit l’image réellement appliquée. D’après le contrat, un avatar personnalisé Premium actif est prioritaire ; un ancien upload OWNER déjà enregistré peut ensuite précéder le fichier fourni dans pdp/. Retirer les boutons du dashboard ne supprime pas ces anciennes données.

Sans ressource requise pour une couleur non cyan, celle-ci peut devenir incomplète et les serveurs concernés se replier sur le cyan. Avant une modification globale de politique, contrôlez les ressources et les statistiques des serveurs concernés.

37 / Administration OWNER

Lire les statistiques des couleurs

Le choix enregistré et la couleur autorisée ne mesurent pas les mêmes choses.

Comprendre les compteurs

Le total des serveurs correspond aux guildes présentes dans le cache du bot. Un serveur sans configuration compte comme cyan. Le nombre de choix enregistrés mesure les préférences sauvegardées, y compris lorsqu’un Premium a expiré.

Le nombre effectif applique les règles d’accès, les ressources et le statut Premium. Il représente la couleur autorisée, pas un audit de tous les messages et avatars visibles dans Discord. Les identifiants de couleur inconnus sont comptés séparément et leur couleur effective se replie sur le cyan.

Exemple concret

100 serveurs ont choisi Violet mais seulement 80 y ont encore accès. Le compteur enregistré peut rester à 100, tandis que le compteur effectif indique 80. Les autres serveurs contribuent au cyan effectif.

Pourcentages et actualisation

Le pourcentage d’une couleur se calcule sur son nombre effectif divisé par le total des serveurs. Si le total vaut zéro, le résultat affiché doit rester 0 %. La somme des effectifs doit correspondre au total ; les choix enregistrés additionnés aux identifiants inconnus doivent aussi retrouver le total.

Le bot fournit une lecture groupée depuis ses données et son cache de serveurs. Il n’est pas nécessaire de charger chaque dossier de serveur ni de scanner des messages pour construire cette vue. Une actualisation explicite suffit, sans interrogation continue de toutes les guildes.

38 / Administration OWNER

Licences, accès, partenaires et gestion ciblée

Les fonctions globales du propriétaire du bot et leur portée.

Travailler sur le bon serveur

La gestion OWNER privilégie la recherche d’un serveur par identifiant ou nom, puis l’ouverture de son dossier. Vérifiez l’identifiant : deux serveurs peuvent porter le même nom. Une recherche par nom fournit une sélection limitée, tandis qu’un identifiant permet de viser directement la bonne guilde.

Les actions du dossier peuvent concerner la communication, les rôles, le salon de supervision, l’invitation ou le départ du bot selon les capacités disponibles. Relisez la cible et la portée avant toute mutation. Quitter un serveur ou supprimer des données n’est pas une simple fermeture de fiche.

Licences et politique d’accès

La gestion des licences doit être distinguée du contrôle d’accès au dashboard. Une licence Premium active peut donner accès à des options et éventuellement à une exception d’accès si la politique globale l’autorise. Elle n’annule pas automatiquement un blocage explicite.

Les listes d’autorisation et de blocage, le verrouillage global et les thèmes sont des politiques du bot. Les rôles staff d’un serveur ne permettent pas de les modifier. En cas de doute, vérifiez le statut renvoyé par le serveur plutôt que de déduire l’accès depuis un badge affiché.

Partenaires et communication

Les partenaires publics sont gérés depuis les fonctions OWNER prévues, avec un slug et un ordre d’affichage. Vérifiez les informations, les liens et le serveur ciblé avant de sauvegarder. Les modifications publiques doivent être relues comme du contenu destiné aux visiteurs.

Les outils de communication réalisent des actions réelles lorsqu’ils sont utilisés. Préparez le contenu et la destination avant d’envoyer. Le wiki décrit leur portée ; il ne transforme pas une lecture de dossier en autorisation d’envoi automatique.

39 / Référence & dépannage

Commandes Discord utiles

Les commandes vérifiées dans le code du bot et l’outil à choisir selon votre besoin.

Référence rapide

CommandeUsage
/configOuvrir la configuration du bot dans Discord, soumise aux contrôles d’administration.
/casierOuvrir la recherche et les outils de gestion des casiers.
/carte-idAfficher ou configurer ses cartes d’identité RP.
/roblox-idRechercher un profil Roblox public par pseudo.
/session-démarrerOuvrir la session de jeu ; rôle de gestion des sessions ou permission Gérer le serveur.
/shutdownFermer la session et clôturer les services actifs pris en charge.
/avis-adminConsulter et gérer les avis selon les droits du bot.
/service-adminOuvrir les outils de suivi et de gestion du service.
/staff-statsAfficher les statistiques enregistrées d’un staff.
/setup-casierParcours Discord de publication du panneau de rapport, réservé à l’administration.
/setup-robloxParcours Discord de publication du panneau de liaison, réservé à l’administration.

Une commande n’apparaît pas

Vérifiez que vous utilisez le bon serveur et le bon bot, puis que la commande est disponible avec vos permissions. Un module indisponible ou une commande non synchronisée peut demander une intervention du propriétaire du bot. Recharger le dashboard n’ajoute pas une commande Discord manquante.

Ne déduisez pas un nom de commande à partir d’un titre de rubrique. Par exemple, le suivi du service repose sur le panneau et /service-admin ; une commande inventée /pause n’est pas documentée ici. Utilisez les commandes réellement proposées par Discord.

40 / Référence & dépannage

Données enregistrées et messages Discord

Distinguer configuration, données du bot et messages visibles avant de nettoyer ou de migrer.

Trois niveaux différents

La configuration contient les rôles, salons et options. Les données du bot contiennent les éléments utilisés par les modules, comme les rapports, avis, cartes ou temps de service. Les messages Discord sont leur interface ou leur trace visible. Supprimer un niveau ne signifie pas forcément supprimer les deux autres.

Les références des panneaux permettent au bot de retrouver les messages qu’il suit. Un message peut être supprimé dans Discord tout en restant référencé jusqu’à un prochain traitement. Un nouvel objet portant le même nom aura un identifiant différent et devra être configuré à nouveau.

Avant une migration ou un nettoyage

  1. Identifiez précisément le serveur et les modules concernés.
  2. Décidez si vous voulez retirer un message, changer une configuration, supprimer une donnée ou effacer tout le serveur dans les données du bot.
  3. Faites vérifier les éléments à conserver par la personne responsable du bot et de son stockage.
  4. Utilisez les outils prévus et vérifiez le résultat sur les données et les messages concernés.
  5. Après un redéploiement du bot, contrôlez la présence des données attendues et des uploads persistants.

41 / Référence & dépannage

Zone de danger : suppression des données du serveur

Une action administrative de grande portée à préparer avec l’équipe.

Avant de confirmer

Cette zone appelle une suppression des données du serveur dans le périmètre pris en charge par le backend. Elle ne sert pas à actualiser un écran, à déplacer un panneau ou à résoudre une permission Discord. L’API applique ses propres contrôles d’autorisation et demande une confirmation explicite.

Relisez le serveur actif et le texte de confirmation affiché. La confirmation prend la forme DELETE suivi de l’identifiant du serveur. Copier le texte du mauvais serveur ne doit jamais être considéré comme une vérification suffisante.

  1. Identifiez la cause du nettoyage et vérifiez si une action plus ciblée existe dans le module.
  2. Faites préparer une sauvegarde appropriée des données nécessaires par le responsable du bot.
  3. Prévenez les responsables des modules concernés.
  4. Relisez l’identifiant du serveur et la portée affichée avant de confirmer.
  5. Après l’action, contrôlez séparément les données du bot et les messages Discord encore visibles.

42 / Référence & dépannage

Diagnostic rapide et erreurs courantes

Partir du symptôme et vérifier la bonne cause avant de répéter une action.

Le panneau ne se publie pas

Symptôme / codeVérification utile
authentication_required / 401Reconnectez le compte Discord puis vérifiez le serveur actif.
administrator_required / 403Vérifiez Administrateur sur le serveur ; un rôle staff seul ne suffit pas.
dashboard_locked ou dashboard_blacklistedLisez la politique d’accès et contactez le support si nécessaire.
text_channel_not_found / 422Sélectionnez un salon textuel ou d’annonces du bon serveur.
bot_channel_permissions_missing / 409Vérifiez Voir le salon, Envoyer des messages et Intégrer des liens.
discord_panel_send_failed / 409Discord a refusé l’envoi ; contrôlez les permissions et le salon avant une nouvelle tentative.
bot_not_ready ou required_cog_unavailable / 503Le bot ou le module est indisponible ; attendez ou signalez le problème au responsable.
Erreur réseau ou expirationVérifiez Discord avant de republier : le premier envoi peut avoir abouti.

Une option est sauvegardée mais son effet manque

Lisez les avertissements renvoyés. Pour un rôle ou un pseudo, contrôlez les permissions et la hiérarchie. Pour un thème, consultez les états enregistré/effectif et la synchronisation. Pour un avatar, vérifiez la priorité d’un profil Premium et une éventuelle attente Discord.

Pour un panneau ancien, vérifiez s’il est suivi, si son message existe toujours et si la recherche limitée peut le retrouver. Pour les statistiques, vérifiez la fin des services, les multiplicateurs et les remises à zéro. Une republication ne corrige pas automatiquement ces causes.

Session web et diagnostic technique

Les erreurs csrf_invalid ou origin_not_allowed concernent la session ou l’intégration du site. Reconnectez-vous et utilisez l’adresse officielle du dashboard. Si le problème persiste, fournissez au support l’action, l’heure et le code d’erreur, sans transmettre de secret.

Pour une couleur, theme_disabled indique une politique fermée, theme_not_ready des ressources incomplètes, premium_required un accès réservé et theme_cooldown un délai à attendre. La recherche de panneaux possède son propre délai theme_discovery_cooldown. Il est inutile de contourner ces refus en envoyant davantage de requêtes.

Préparer une demande au support

  1. Indiquez le module, le serveur et l’heure avec votre fuseau.
  2. Décrivez les étapes suivies et le résultat attendu.
  3. Copiez le code et le message d’erreur, ainsi que l’identifiant de corrélation s’il est affiché.
  4. Dites si le réglage est enregistré, si le message existe dans Discord et si l’effet manque seulement sur un membre.
  5. Masquez les données privées et ne partagez jamais token, cookie, URL de webhook ou mot de passe.

Exemple concret

« Module Service, serveur ID …, 29/10 à 18:15 heure de Paris. La prise de service est confirmée et le membre apparaît dans le panneau, mais le rôle En service n’est pas attribué. Le rôle est sous celui du bot ; voici le message de supervision. »