Documentation
Guide d’utilisation de USMAN Bot
Démarrer en 4 étapes
- Ajoutez le bot à votre serveur avec le bouton « Ajouter à Discord ». Il reçoit automatiquement les permissions dont il a besoin (rôle « USMAN Bot » créé par Discord). Vous devez avoir « Gérer le serveur » sur ce serveur.
- Connectez-vous au panel avec Discord, puis choisissez votre serveur dans la liste (seuls les serveurs où le bot est présent et où vous gérez le serveur apparaissent).
- Renseignez VRChat : compte dédié du bot et identifiant du groupe (module « VRChat »).
- Choisissez vos salons et rôles dans les menus, puis cliquez sur « Enregistrer ». Le bot redémarre quelques secondes et applique tout.
Le panel
La barre latérale liste les modules. Vos changements restent en brouillon jusqu’au clic sur « Enregistrer » (barre en bas de page). Les mots de passe et secrets saisis ne sont jamais réaffichés : un badge indique seulement qu’ils sont enregistrés. Pour changer de serveur, utilisez le sélecteur en haut de la barre latérale.
Les modules
| Module | Ce qu’il fait |
|---|---|
| Liste des bans | Salon où le bot maintient un message unique avec les bannis du groupe, mis à jour automatiquement, avec pagination par réactions ⏮️ ⬅️ ➡️ ⏭️. Les bans temporaires y affichent le temps restant. Les titres et textes suivent la langue du serveur. Réglez le nombre par page et la fréquence. |
| Logs du groupe | Chaque action du groupe VRChat (bans, rôles, invitations…) est postée dans un salon. Les actions faites avec les commandes du bot y sont aussi notées, avec le membre Discord auteur. |
| Instances | Avertit dans un salon quand une instance du groupe s’ouvre ; peut aussi publier un post sur le groupe VRChat (titre et texte personnalisables, délai anti-spam). |
| Modérateurs et membres | Deux salons avec la liste des modérateurs du groupe et la liste des membres, tenues à jour. |
| Permissions | Choisissez quels rôles Discord peuvent utiliser /ban, /tempban, /unban et /modo. Les administrateurs du serveur ne sont pas automatiquement autorisés : ajoutez leur rôle si besoin. |
| VRChat | Compte dédié, identifiant du groupe (grp_…), rôle modérateur à attribuer, secret 2FA optionnel, saisie du code 2FA si VRChat le demande. |
| Données et confidentialité | Exporter toutes vos données, tout supprimer, ou faire quitter le bot. |
Commandes Discord
| Commande | Effet |
|---|---|
/ban <pseudo_vrchat> [raison] | Bannit définitivement le joueur du groupe VRChat. |
/tempban <pseudo_vrchat> <duree> [raison] | Bannit le joueur temporairement : il est débanni automatiquement à la fin de la durée. |
/unban <pseudo_vrchat> | Débannit le joueur (et annule son bannissement temporaire s’il y en avait un). |
/modo ajouter <pseudo_vrchat> | Donne le rôle modérateur du groupe au joueur VRChat. |
/modo retirer <pseudo_vrchat> | Retire ce rôle. |
/vrchat statut | Affiche l’état de la connexion au compte VRChat. |
/vrchat roles | Liste les rôles du groupe et leurs identifiants. |
/vrchat code <code> | Saisit le code 2FA demandé par VRChat. |
Durée de /tempban
La durée est un nombre suivi d’une unité : s = secondes, m = minutes, h = heures, d = jours. Exemples : 30m (30 minutes), 12h (12 heures), 7d (7 jours), 1h30m (1 h 30). Minimum 10 secondes, maximum 365 jours. Le débannissement est automatique, même si le bot a redémarré entre-temps. Un /ban sur un joueur en bannissement temporaire le rend définitif.
Langue des commandes
Les noms de commandes, les options et les réponses s’affichent dans la langue de votre application Discord (anglais, français, espagnol ou chinois, anglais par défaut). Les logs et messages du bot dans le serveur suivent la langue du serveur.
Ces commandes sont réservées aux rôles que vous avez choisis dans « Permissions ». Chaque action est inscrite dans le salon des logs.
Compte VRChat
- Créez un compte VRChat dédié au bot et ajoutez-le à votre groupe avec un rôle disposant des permissions utiles (voir les bannis, gérer les bannis, gérer les rôles, voir les journaux…). Sans cela VRChat répond « You don’t have permission ».
- L’identifiant du groupe ressemble à
grp_xxxxxxxx-xxxx-…(dans l’adresse de la page du groupe sur vrchat.com). - Si le compte utilise la double authentification par application, collez son secret TOTP dans le panel : le bot générera les codes seul. Sinon, saisissez le code reçu quand le panel le demande.
- Le service utilise l’API non officielle de VRChat : un usage excessif peut être limité par VRChat. Les intervalles minimaux sont donc bornés.
Vos données
Voir la politique de confidentialité. En résumé : seul le nécessaire est stocké, les secrets sont chiffrés, tout est supprimé quand vous retirez le bot, et le module « Données et confidentialité » permet d’exporter ou d’effacer à tout moment.
Problèmes fréquents
Mon serveur n’apparaît pas dans la liste
Le bot doit être présent sur le serveur et vous devez avoir « Gérer le serveur ». Déconnectez-vous puis reconnectez-vous pour actualiser la liste.
« You don’t have permission » dans la liste des bans
Le compte VRChat du bot n’a pas le rôle ou les permissions nécessaires dans le groupe.
Les commandes n’apparaissent pas
Réinvitez le bot avec le bouton « Ajouter à Discord » (la portée applications.commands est nécessaire), puis patientez une minute.
Le bot n’écrit pas dans un salon
Vérifiez que son rôle peut voir le salon, y envoyer des messages et des intégrations. Les salons sans cette permission sont signalés dans les menus.
Le panel demande un code 2FA
VRChat a envoyé un code par e-mail ou application : saisissez-le dans le module « VRChat ».
Besoin d’aide ? Rejoignez notre serveur Discord ou écrivez à [email protected].