🌸 Documentation Officielle XenBotUHC 🧊

Bienvenue, cher administrateur, dans le guide complet de votre XenBotUHC ! Ce bot est votre allié ultime pour la gestion d'une communauté UHC prospère.

Conçu pour être intuitif et puissant, il simplifie tout, de la modération à l'organisation complexe de vos parties. Pour vous aider à maîtriser rapidement le bot, nous avons divisé toutes les commandes en catégories claires :

  • ⚙️ Configuration Initiale (Setup) : Activez les systèmes de base.
  • 🛡️ Commandes de Modération : Maintenez l'ordre (Ban, Clear).
  • 👤 Commandes Communautaires : XP et statistiques.
  • ⚔️ Commandes UHC : Lancez, annoncez, tirez au sort.
  • 📧 Gestion des Tickets : Support par tickets sur mesure.
  • 🚫 Blacklist Globale : Bloquez les joueurs toxiques globalement.

⚙️ 1. Configuration Initiale du Bot

Les commandes de cette section sont la fondation de votre serveur. Activez-les dans les salons où l'action doit avoir lieu.

Astuce de Setup : Exécutez chaque commande de configuration dans le salon où la fonctionnalité doit être appliquée (ex : /setup-reglement dans #règlements).

/setup-reglement
Setup Admin

Met en place le système d'acceptation des règles avec rôle automatique.

Paramètres Essentiels :

  • Role : Rôle à donner.
  • Texte : Contenu des règles (/n pour saut de ligne).
/setup-captcha

Active la vérification par image pour une protection anti-bot et anti-raid.

Paramètres :

  • Role : Rôle attribué après validation.
/setup-bienvenue

Crée un message d'accueil chaleureux et personnalisé pour les nouveaux arrivants.

Paramètres :

  • Salon : Le canal où les messages s'afficheront.
/setup-bugs & /setup-suggestions

Transforme les messages des membres en un format spécial permettant aux joueurs de réagir (et crée un fil de discussion pour les suggestions).

Paramètres :

  • Salon : Le canal dédié.
/setup-vocal

Déploie des salons vocaux privés et temporaires.

Paramètres :

  • Salon-generateur : Vocal qui crée le salon personnel.
  • Categorie : Catégorie où les temporaires seront placés.
/setup-log (et variantes)

Configure les différents canaux de journalisation (logs) :

  • /setup-log : Activités générales du bot.
  • /setup-logparti : Logs des parties UHC.
  • /setup-logbl : Logs de la Blacklist.
  • /setup-logticket : Logs des tickets de support.

Paramètres :

  • Salon : Le canal dédié à la réception des journaux.

🛡️ 2. Commandes de Modération

Ooutils réservés à votre équipe de Staff pour assurer l'ordre et le respect des règles.

/ban & /unban
Staff Modération

Bannit ou lève le bannissement d'un utilisateur. L'action est toujours loguée pour la transparence.

Paramètres Ban :

  • Joueur : La cible.
  • Raison : Le motif officiel.
  • Duree : Durée (ex: 1 semaine, 1 mois, permanent).
/clear

Efface rapidement un nombre précis de messages dans le canal actuel.

Paramètres :

  • Nombre : Le compte exact de messages à supprimer (jusqu'à 100).
/gererprofil

Permet aux administrateurs d'ajuster manuellement les statistiques d'un joueur (XP ou parties jouées).

Paramètres :

  • Action : add-game, remove-game, add-xp, ou remove-xp.
  • Joueur : Le membre concerné.

👤 3. Commandes Communautaires

Offrez à vos membres un suivi de leur progression.

/profil
Tout le monde

Affiche le profil complet d'un joueur : expérience accumulée, parties UHC jouées et historique de bannissements.

Paramètres :

  • Joueur : (Optionnel) Laissez vide pour voir votre profil, ou mentionnez un membre.

⚔️ 4. Commandes UHC

Gérez le cycle complet de vos événements UHC, de l'annonce à la clôture, avec une efficacité maximale.

/creer-une-partie

Lance le processus d'annonce formelle (création des salons d'inscription, embed d'information).

Paramètres :

  • Mode de jeu, Type, Date, Horaire, Nombre de slots
  • Role Acces : Rôle minimum requis pour voir et s'inscrire.
/tirage-uhc

Sélectionne les participants au hasard parmi les inscrits.

Paramètres :

  • Id message : ID du message d'information de la partie.
  • Place : Nombre de joueurs à tirer.
  • Amis : (Optionnel) Nombre de joueurs à faire passer en priorité.
/lancer-uhc

Annonce le début et partage l'IP du serveur de jeu aux participants sélectionnés.

Paramètres :

  • Id message : ID du message d'information.
  • Ip : L'adresse IP du serveur UHC.
/fin-uhc

Nettoie le serveur après la partie, supprimant automatiquement salons et catégorie associés.

Paramètres :

  • Id message : ID du message d'information de la partie.

📧 5. Gestion des Tickets

/ticket add_category

Ajoute une nouvelle option au menu déroulant des motifs de tickets.

Paramètres :

  • nom : Nom de l'option (visible par l'utilisateur).
  • categorie : Catégorie Discord où le ticket sera créé.
/ticket send

Déploie l'Embed interactif dans le salon actuel, permettant l'ouverture des tickets.

🚫 6. Commandes de Blacklist

La Blacklist UHC_BOT est globale : un joueur blacklisté sur votre serveur est automatiquement bloqué de tous les événements UHC gérés par le bot sur d'autres serveurs partenaires.

/bl-addjoueur
Administrateur

Ajoute un joueur à la Blacklist globale. Réservé au Staff avec raison valide.

Paramètres :

  • Joueur-minecraft : Le pseudo Minecraft.
  • Joueur-discord : Le pseudo Discord.
  • Raison : Motif justifiant l'ajout.
/bl-searchjoueur

Vérifie si un joueur est inscrit dans la Blacklist.

/bl-addserver & /bl-accepterserver

Ajoutez un serveur à la liste de vos serveurs avec qui vous avez la Blacklist en commun, ou acceptez une demande entrante.

Besoin d'aide supplémentaire ?

Nous vous remercions d'avoir choisi UHC_BOT pour la gestion de votre communauté. Si vous rencontrez le moindre problème ou avez des questions complexes, contactez-moi directement sur Discord.

Discord : Xenolevrai