FrozBot Guide des fonctionnalités

Accueil des membres

Bienvenue publique : lorsqu’un membre reçoit le rôle de famille, le bot publie un message français/anglais dans le salon d’accueil. Une protection évite deux accueils du même membre en moins de 30 secondes.

Message privé : 10 secondes après l’arrivée sur le serveur, le bot envoie les informations d’accueil, de recrutement et la consigne d’utiliser /rename. Si les MP sont fermés, l’erreur est signalée dans les logs du programme.

Demandes de pseudo Discord

La commande /rename et le bouton public ouvrent un formulaire de nouveau pseudo. La demande est envoyée au salon de modération avec le membre, son ancien pseudo et le pseudo demandé.

Les boutons Accepter et Refuser traitent la demande. En cas d’acceptation, le bot modifie le pseudo Discord si ses permissions et sa position dans les rôles le permettent. Le message de modération est ensuite actualisé.

Le script n’impose pas de capture d’écran : cette demande peut rester une consigne manuelle de la famille. Le formulaire et les réponses personnelles sont localisés. Le message public est bilingue français/anglais ; la partie modération reste en français.

Nettoyage automatique des salons

Dans les salons configurés, les messages de plus de 12 heures sont supprimés au démarrage puis toutes les 15 minutes. Le bot inspecte au maximum 500 messages par salon à chaque passage et espace les suppressions d’une seconde.

Les messages du bot explicitement ignoré sont conservés. Le salon des catacombes et son salon de logs sont exclus de la purge. Les suppressions sont comptabilisées dans le salon de logs général.

Catacombes : le suivi mensuel

Personnages et mise à jour des étages

Les personnages sont liés à leur propriétaire Discord et possèdent un identifiant permanent. Les menus affichent les icônes du serveur escri, archer, mage, artistemartial si elles sont disponibles. Les listes de plus de 25 personnages disposent de pages.

Exemple : Frozen passe de 19 à 20 en sélectionnant son personnage et en saisissant 20. Sa ligne est mise à jour sans doublon. Un pseudo déjà enregistré ne peut pas être revendiqué par un autre membre.

Ajouter à nouveau un pseudo déjà présent dans sa liste ne le renomme pas et ne change pas sa classe. Le propriétaire du bot dispose d’une commande de renommage dédiée.

Un classement lisible

# | Character | Class     | Floor
--+-----------+-----------+------
1 | Frozen    | Archer    |    20
2 | Glad      | Mage      |    20
3 | Bouyo     | Swordsman |    19

Les étages les plus élevés sont en haut. À étage égal, l’ordre de première inscription dans le classement du mois est conservé. Les rangs suivent cet ordre, même lorsque le tableau occupe plusieurs messages.

Les étages sont déclaratifs, sans vérification dans NosTale. Le tableau public est en anglais, en texte aligné, sans mentions ni émojis. Le classement personnel est traduit et affiche — pour les personnages sans étage déclaré ce mois-ci.

Réinitialisation et archives

Le 1er de chaque mois à 05 h 00, heure de Paris, l’ancien classement devient une archive sans boutons ; un nouveau tableau est publié avec ses trois boutons. Le contrôle s’effectue chaque minute, ou au redémarrage si le bot était arrêté.

Les personnages et leurs classes restent enregistrés. Seuls les étages sont à déclarer à nouveau. Les archives restent visibles en remontant le salon et consultables par commande.

Commandes pour les membres

Options de /catacombes

Exemples dans Discord en français

/catacombes etage:20
/catacombes etage:20 minimum:True
/catacombes membre:@Frozen mois:2026-10
/catacombes membre:@Frozen historique:Personnel
/catacombes historique:Tous les joueurs

Personnel : historique du membre sélectionné, ou le tien si aucun membre n’est précisé. Tous les joueurs : historique global, regroupé par mois. Dans ce mode, le filtre de membre est ignoré ; les filtres de mois et d’étage restent utilisables.

L’historique contient uniquement les mois et les étages effectivement enregistrés. Il ne reconstitue pas la progression en jeu ni chaque tentative intermédiaire.

Langues et accès

Français, anglais, allemand et espagnol sont intégrés au script. Les autres langues utilisent l’anglais. Les commandes gardent leur nom ; leurs options, descriptions et les choix d’historique sont localisés. La note de progression et de réinitialisation est traduite, sur deux lignes. Les boutons publics sont en anglais.

Retirer un étage n’efface pas le personnage enregistré. Il reste disponible dans le menu pour les prochaines déclarations.

Administration et journaux

Les autres membres peuvent voir ces commandes dans Discord, mais le contrôle de l’ID leur interdit de les utiliser. Les réponses administratives sont éphémères.

Renommer ou supprimer

Renommage : le registre et le classement courant sont actualisés. L’identifiant, le propriétaire et les étages sont conservés. Un pseudo déjà utilisé par un autre personnage est refusé. Les archives gardent le nom utilisé à l’époque.

Suppression administrative : rien ne disparaît à l’ouverture de la liste ou à la sélection. Après confirmation, le personnage est retiré du registre et de tous les mois, archives comprises. Les anciens messages de logs restent présents.

Logs des catacombes

Les ajouts, modifications, retraits, renommages et suppressions administratives sont journalisés. Les logs non envoyés sont sauvegardés et réessayés si Discord est indisponible. Les blocs utilisent le format diff.

+ Catacombes Octobre 2026 (10/10/2026 à 01:09 CEST)
Ajout de la validation de l’étage 2 pour test [Mage].

- Catacombes Octobre 2026 (10/10/2026 à 01:09 CEST)
Retrait de la validation de l’étage 2 pour test [Mage].

+ Catacombes Octobre 2026 (10/10/2026 à 01:09 CEST)
Modification de la validation de l’étage 5 pour test [Mage].
[Avant: étage 7, Archer]

Dans Discord, le titre précédé de + est généralement vert et celui précédé de - rouge. Les logs ne contiennent pas de mention de l’auteur. Le rendu des couleurs dépend du client Discord.

Exploitation du Raspberry Pi

Les trois fichiers essentiels

Une variable d’environnement FROZBOT_TOKEN, si renseignée, prend priorité sur le fichier du token. Ne partage pas ce token. Le fichier de données est chargé en mémoire : privilégie les commandes du bot pour modifier les personnages.

Salons configurés

Service utilisateur

Le service est situé dans ~/.config/systemd/user/frozbot.service. Utilise systemctl avec --user. Le script empêche un second lancement simultané via un verrou Linux.

systemctl --user restart frozbot.service
systemctl --user status frozbot.service --no-pager
journalctl --user -u frozbot.service -n 40 --no-pager

Comportement au démarrage et points à connaître

Le bot synchronise les commandes, lance la purge initiale et les tâches périodiques, réactive les boutons persistants et publie un log de démarrage. Le bouton public de rename est réédité toutes les 14 minutes. Le message est retrouvé ou recréé au démarrage ; sa suppression en cours de fonctionnement n’entraîne pas une recréation immédiate.

Le script exige la présence de DISPLAY ; le service actuel fournit DISPLAY=:0. /reboot nécessite que sudo autorise effectivement le redémarrage sans saisie de mot de passe.

Les boutons de modération rename ne vérifient pas explicitement le rôle du cliqueur dans le script actuel : l’accès au salon doit être réservé aux personnes habilitées. Après un redémarrage, les anciennes demandes de modération peuvent nécessiter une nouvelle demande.