Bot Discord

Le bot Discord d'Astral Realms gère le support par tickets sur le serveur Discord, avec une archive web consultable par le staff, ainsi que quelques commandes d'information (/ip, /wiki, /map, /site). Il ne communique pas avec les serveurs Minecraft : c'est un outil purement Discord.


Panneau web	`https://tickets.astralrealms.gg` (connexion avec votre compte Discord)
Où l'utiliser	Dans le salon d'un ticket (commandes `/ticket`) ou n'importe où (`/ip`, `/wiki`…)

Qui est staff ?

Le bot considère un membre comme staff dans les cas suivants :

il possède la permission Discord Gérer le serveur (Manage Server) — toujours staff ;
il possède le rôle staff par défaut configuré dans le panneau (Paramètres) ;
il possède le rôle staff spécifique d'une catégorie de tickets (un type de ticket peut avoir son propre rôle, par exemple un rôle « Build » pour les tickets de construction).

Dans un ticket donné, seuls le rôle staff par défaut et le rôle du type de ce ticket comptent. Aucun identifiant de rôle n'est codé en dur : tout est réglé par serveur dans le panneau.

Cycle de vie d'un ticket

Ouverture — le membre choisit une catégorie dans le menu déroulant du panneau « 🎫 Support AstralRealms », puis remplit un formulaire : Pseudo Minecraft, Version du jeu (préremplis depuis son ticket précédent) et jusqu'à 3 champs propres à la catégorie.
Salon privé — un salon 0042-pseudo est créé, visible du membre, du rôle staff par défaut et du rôle staff du type. Un embed récapitulatif épinglé propose les boutons Prendre en charge, Fermer et Suspendre / Reprendre.
Prise en charge — via le bouton, /ticket claim, ou automatiquement au premier message d'un staff. Si une catégorie « pris en charge » est configurée, le salon y est déplacé (et revient à sa place au unclaim).
Suivi — synthèse pour les responsables (/ticket synthese), fermeture différée, suspension, ajout de membres…
Fermeture — bouton ou /ticket close. Le bot génère une transcription HTML, la poste dans le salon de logs avec un lien « Voir l'archive », l'envoie en MP au membre, puis supprime le salon.

Limites et anti-spam

Règle	Valeur par défaut	Où la régler
Tickets ouverts simultanés par membre	1	Panneau → Paramètres (1 à 10)
Tickets créés par membre sur une fenêtre glissante	3 par 24 h	Administrateurs du bot
Rappel au membre avant une fermeture programmée	24 h avant	Administrateurs du bot
Alerte « en attente du staff »	après 24 h	Administrateurs du bot

Un ticket suspendu ne compte pas dans la limite de tickets ouverts.

Commandes `/ticket`

Toutes les sous-commandes s'utilisent dans le salon du ticket, sauf ban et unban qui fonctionnent partout. Les mentions « staff » désignent les membres définis ci-dessus; les autres sous-commandes sont accessibles au staff ou à l'auteur du ticket.

Fermeture

Commande	Accès	Description
`/ticket close [raison]`	staff ou auteur	Ferme le ticket : transcription, log, MP à l'auteur, suppression du salon. `raison`: 200 caractères max.
`/ticket close-in <jours>`	staff	Programme la fermeture si le membre ne répond pas d'ici là. `jours`: `1`, `2`, `3`, `7` ou `14`. Un bouton « Annuler la fermeture programmée » est posté.
`/ticket cancel-close`	staff	Annule la fermeture programmée. Elle est aussi annulée automatiquement si l'auteur écrit dans le ticket.

Prise en charge et visibilité

Commande	Accès	Description
`/ticket claim`	staff	Prend en charge le ticket (et le déplace dans la catégorie « pris en charge » si configurée).
`/ticket unclaim`	staff	Libère le ticket et le remet dans sa catégorie d'origine.
`/ticket suspend`	staff	Suspend le ticket : caché à l'auteur, visible du staff, non fermé, ne compte plus dans sa limite. Annule toute fermeture programmée.
`/ticket resume`	staff	Reprend un ticket suspendu et rend l'accès à l'auteur.
`/ticket add <membre>`	staff	Donne l'accès au salon à un autre membre (lecture, écriture, pièces jointes).
`/ticket remove <membre>`	staff	Retire cet accès.
`/ticket rename <nom>`	staff	Renomme le salon (90 caractères max).
`/ticket info`	staff ou auteur	Affiche la fiche du ticket (réponse visible de vous seul).
`/ticket transcript`	staff	Génère la transcription HTML à l'instant T, sans fermer le ticket (fichier visible de vous seul).

Synthèse pour les responsables

Commande	Accès	Description
`/ticket synthese` (alias `/ticket summary`)	staff	Ouvre le formulaire de synthèse : Priorité (🟢 Basse, 🟡 Normale, 🟠 Haute, 🔴 Critique), Résumé de la situation, Actions réalisées, Suite à donner (optionnel).
`/ticket synthese-ia` (alias `/ticket ai-summary`)	staff	Demande à l'IA un brouillon de synthèse à partir de la conversation. Visible de vous seul, avec Publier, Modifier (ouvre le formulaire prérempli) ou Ignorer. Rien n'est publié sans validation.

Une fois validée, la synthèse est épinglée dans le ticket, copiée dans le salon des synthèses s'il est configuré, et l'emoji de priorité est ajouté en préfixe du nom du salon.

Liste noire

Commande	Accès	Description
`/ticket ban <membre> [raison]`	staff, n'importe où	Interdit au membre d'ouvrir des tickets. Refusé si la cible est staff.
`/ticket unban <membre>`	staff, n'importe où	Retire le membre de la liste noire.

La liste noire est aussi consultable et modifiable depuis la page Liste noire du panneau, et une action « Bannir l'auteur » est disponible sur la fiche de chaque ticket (y compris fermé).

Automatismes

Le bot exécute une maintenance toutes les minutes et réagit à certains événements :

Auto-attribution: le premier message d'un staff dans un ticket non pris en charge l'attribue automatiquement (jamais à l'auteur du ticket, même s'il est staff).
Fermeture automatique: un ticket dont l'échéance close-in est passée est fermé par le bot avec la raison « Fermé automatiquement : aucune réponse du membre ».
Rappel: l'auteur est mentionné une fois, 24 h (par défaut) avant une fermeture programmée.
Alerte staff: un ticket où le membre attend une réponse depuis plus de 24 h (par défaut) déclenche un message @rôle-staff ⚠️ dans le salon de logs (une seule alerte par message du membre).
Départ du membre: si l'auteur quitte le serveur Discord, un avis est posté dans chacun de ses tickets actifs ; les tickets ne sont pas fermés.

Salons et catégories à configurer

Réglages par serveur, dans Panneau → Paramètres (permission Gérer le serveur requise) :

Réglage	Rôle
Catégorie des tickets	Où sont créés les salons de tickets.
Catégorie « pris en charge » (optionnel)	Où sont déplacés les tickets attribués.
Rôle staff	Rôle staff par défaut (voir ci-dessus).
Salon de logs	Reçoit les embeds de fermeture (avec archive HTML ≤ 8 Mo jointe) et les alertes « en attente du staff ».
Salon des synthèses (optionnel)	Reçoit une copie de chaque synthèse.
Limite de tickets ouverts	Par membre, de 1 à 10.
Catégories de tickets	Nom, catégorie Discord et rôle staff propres, jusqu'à 3 champs de formulaire (texte court, texte long ou liste déroulante de 25 options max).
Synthèse IA	Activation, consignes supplémentaires pour le modèle (vocabulaire du serveur, règles de priorité…), bouton « Tester la connexion ».
Publier le panneau	Poste le message « 🎫 Support AstralRealms » dans le salon choisi.

Panneau web

Le panneau https://tickets.astralrealms.gg s'ouvre avec une connexion Discord. Vos droits dans le panneau sont les mêmes que sur le serveur Discord : rôle staff ou Gérer le serveur.

Page	Contenu	Accès
Tableau de bord	Indicateurs, volume hebdomadaire, répartition par type et priorité, classements des staffs (fermetures, prises en charge), tickets ouverts les plus anciens.	staff
Tickets	Liste filtrable (statut, type) et recherche plein texte dans les transcriptions archivées, avec extraits surlignés.	staff (les membres ne voient que leurs propres tickets, jamais les suspendus)
Fiche ticket	Synthèse, lecteur de transcription, actions : prendre en charge, suspendre, fermer maintenant ou plus tard, annuler, bannir l'auteur.	actions réservées au staff
Liste noire	Consultation, ajout et retrait de membres bannis des tickets.	staff
Paramètres	Toute la configuration des tickets (voir tableau précédent).	Gérer le serveur

Un sélecteur en haut à gauche permet de changer de serveur : le bot est multi-serveurs, avec données, réglages et commandes séparés par serveur.

Transcriptions

Page fidèle à l'affichage Discord, consultable via le lien « Voir l'archive » du salon de logs ou depuis la fiche du ticket dans le panneau.
Les images sont conservées dans l'archive : les preuves survivent à une suppression côté Discord.
Les transcriptions très volumineuses ne sont pas jointes dans Discord et restent consultables uniquement dans l'archive web.

Commandes d'information

Commandes publiques, utilisables par tout le monde et partout, pratiques pour répondre rapidement à un joueur :

Commande	Description
`/ip`	Adresse et versions du serveur Minecraft.
`/wiki`	Lien vers le wiki.
`/map`	Lien vers les cartes en ligne.
`/site`	Lien vers le site web.

Last modified: 24 September 2026