TopV × Discord

TopV Bot

133 512 membres Discord touchés
Avant de commencer

Ce qu'il te faut

  • Un serveur Discord où tu as la Gérer le serveur (généralement le propriétaire ou un admin).
  • Une fiche serveur TopV déjà créée — /setup-server si ce n'est pas encore fait.
  • Environ 2 minutes. La config se fait en une seule passe.
1Installation

Ajouter le bot à ton Discord

Clique sur le bouton ci-dessous. Discord ouvre une demande de permissions — accepte. Le bot arrive sur ton serveur avec le strict minimum (lire les membres et les rôles, envoyer des messages dans le salon que tu choisiras). Rien de plus.

Discord — Demande d'autorisation
Une application externe
TopV souhaite accéder à votre serveur Discord
AJOUTER À UN SERVEUR
R
Mon Serveur RP
Vérifier qu'il est bien là
Une fois la pop-up Discord fermée, tu dois voir TopV dans la liste des membres à droite. Le point est vert quand le bot est en ligne.
Discord — Liste des membres
Bienvenue dans votre serveur. Tapez / pour voir les commandes.
EN LIGNE — 12
TopVAPP
D
Damien (toi)
I
ic3d_
S
speXtrum
2Vérification

Lier le bot à ta fiche TopV

Dans n'importe quel salon texte, tape :

/topv-link
Discord — Auto-complétion
TopV8 commandes
/topv-linkLier ce Discord à ta fiche serveur ou créateur TopV
Entrée ↵
/topv-link

Discord te demande le slug de ta fiche serveur TopV — c'est ce qui suit topv.gg/servers/. Par exemple, si ta fiche est topv.gg/servers/saga-rp, tape saga-rp.

Vérification de propriété
Le bot n'accepte le lien que si ton compte Discord est celui qui a créé la fiche TopV. Anti-squat intégré — personne d'autre ne peut récupérer ta fiche.
Confirmation
Lance /topv-status à tout moment pour voir l'état du lien (lié / non lié / erreur).
Discord — Réponse (visible par toi uniquement)
TopVAPPAujourd'hui à 21:42(visible par toi uniquement)
Saga RP est maintenant lié à 🏠 Server Saga RP

https://topv.gg/servers/saga-rp

Auto-sync toutes les 6h. Lance /topv-sync pour une resync immédiate.
3Rôles

Choisir les rôles staff et roliste

C'est comme ça que le bot sait qui est dans ton équipe et qui est roliste. Ouvre ton dashboard TopV :

Ouvrir le dashboard

Va sur la page d'édition de ta fiche serveur, descend jusqu'à la section Rôles Discord et coche les rôles voulus.

  • Rôles staff — admins, mods et team. Apparaissent sur ta fiche avec avatar + badge de rôle, en sync automatique.
  • Rôles rolistes — chaque membre avec ce rôle obtient sa propre fiche TopV (perso, projets, trophées, avis). Il la garde à vie, même s'il quitte ton serveur.
TopV Dashboard — Rôles Discord
⚙️

Rôles Discord

2 sélectionnés

Sélectionne les rôles Discord qui représentent ton équipe staff et tes joueurs (rolistes). Les staff apparaîtront sur ton profil public, et les rolistes auront automatiquement une fiche joueur sur TopV.

🛡️I SAST
I LSCSO
EMS
👤I Animateur
🎮I Streamer
👥I Partenaire
Staff
Citoyen
Roliste
Staff
Roliste
Resync à la demande
Lance /topv-sync à tout moment pour forcer un refresh. Le bot re-scanne les membres concernés et met à jour ta fiche et toutes les fiches individuelles.
4Notifications

Choisir le salon des notifications

Choisis l'endroit où le bot poste : résultats de sync, nouveaux trophées, nouveaux avis sur ta fiche, reminders Weekly Spotlight. Lance :

/topv-channel #votre-salon
Discord — Slash command (autocomplétion)
/topv-channelchannel:
Salon textuel
général
staff-only
rolistes
annonces
↑↓naviguersélectionnerescannuler
+
/topv-channelchannel:|
Discord — Réponse (visible par toi uniquement)
TopVAPPAujourd'hui à 21:42(visible par toi uniquement)
✅ Les notifications TopV seront désormais envoyées dans #salon-staff

Pro tip : prends un salon privé réservé au staff — la plupart des messages te concernent toi et l'équipe, pas la communauté.

Permission requise
Assure-toi que le bot peut lire et écrire dans le salon choisi. Sinon /topv-status te le signale.
5Trophées RP

Activer le système de trophées

Cette étape est optionnelle. Si tu veux que ta communauté puisse récompenser les bons moments RP :

/topv-trophy-setup
Discord — Réponse du bot
TopVAPPAujourd'hui à 21:42
⚙️ Configuration des trophées
Choisissez le salon où les récompenses de trophées seront annoncées publiquement, puis cliquez sur Valider.\n\n*Pour gérer qui peut utiliser `/eval` et dans quels salons, utilise les permissions Discord natives (Paramètres → Intégrations → TopV).*
✅ Valider la configuration

Le bot te demande quels salons sont éligibles à /eval et quels rôles peuvent l'utiliser (typiquement staff + rolistes seniors). L'anti-abus est intégré :

  • Cooldown entre deux /eval du même auteur.
  • Plafond journalier par évaluateur (anti-flood).
  • Gating par rôle — seuls les rôles configurés peuvent lancer /eval.
  • Audit log complet : chaque point est traçable à l'évaluateur et au salon.

Une fois actif, n'importe quel membre avec le bon rôle peut taper /eval @player dans un salon éligible. Le point compte dans le classement TopV du joueur.

Discord — Auto-complétion
TopV8 commandes
/evalÉvaluer le RP de ce joueur
Entrée ↵
/evaljoueur:@Dr Stone
Discord — Réponse du bot
IppoJinEvoVerse Académie | FAa utilisé/eval
TopVAPPAujourd'hui à 21:42
TopV — Système de Trophées
🏆 Évaluation RP
Évaluez les compétences RP de @Dr Stone en cliquant sur un trophée ci-dessous.\n\nChaque point contribue à sa progression et son rang sur TopV.gg
Évaluateur : IppoJin · EvoVerse Académie | FA
🎭Fear RP
🎬Cohérence RP
🎪Théâtre
😰Pain RP
🗣️Improvisation
👑Pilier
Référence

Toutes les slash commands

/topv-link

Lie cette guilde Discord à ta fiche serveur TopV.

/topv-sync

Force une resync staff + rolistes. Utile après un changement de rôles.

/topv-status

Affiche statut de vérification, slug TopV lié, dernière sync.

/topv-channel

Choisis le salon pour sync, trophées, avis et reminders Weekly Spotlight.

/topv-trophy-setup

Configure les salons trophées et les rôles éligibles à /eval. Optionnel.

/eval @player

Donne un point de trophée à un roliste. Uniquement dans les salons configurés.

/topv-help

Affiche toutes les commandes et un récap du système de trophées RP.

/topv-unlink

Supprime le lien entre cette guilde et ta fiche TopV.

Confiance

Permissions et vie privée

Ce que le bot PEUT faire

  • Lire ta liste de membres (intent GUILD_MEMBERS — approuvé par Discord).
  • Lire qui a quel rôle (lecture seule) pour identifier staff et rolistes.
  • Envoyer des messages dans le salon défini par /topv-channel.
  • Écouter les slash commands dans les salons où il a accès.

Ce que le bot ne peut PAS faire

  • Ban, kick ou timeout un membre.
  • Créer, éditer ou supprimer des salons.
  • Modifier un rôle — uniquement lecture.
  • Envoyer des DM à tes membres.
  • Lire le contenu des messages (pas d'intent MESSAGE_CONTENT).
Aide

Dépannage & FAQ

/topv-link répond « Non autorisé »

Ton compte Discord n'est pas le propriétaire de la fiche TopV visée. Connecte-toi à TopV avec le bon compte Discord, ou transfère la propriété de la fiche depuis /dashboard.

La liste de staff n'apparaît pas sur ma fiche

Vérifie qu'au moins un rôle est coché « staff » dans le dashboard, puis lance /topv-sync. Si ça reste vide, vérifie que le bot voit ces rôles (liste des rôles Discord, position au-dessus du bot).

Les fiches rolistes ne se créent pas

Même logique — marque au moins un rôle « roliste » dans le dashboard et lance /topv-sync. Les membres doivent avoir au moins l'un de ces rôles. Les fiches se créent en quelques secondes.

/eval dit que le salon n'est pas éligible

Relance /topv-trophy-setup et ajoute le salon courant aux salons éligibles. Les points ne comptent que depuis des salons explicitement autorisés.

Je peux désinstaller le bot plus tard ?

Oui, à tout moment. Lance /topv-unlink pour détacher le lien (ta fiche sait alors que la guilde n'est plus connectée), puis vire le bot. Aucune donnée n'est conservée au-delà du record de vérification.

Ça coûte quelque chose ?

Non. Le bot est et restera gratuit. Aucun upsell associé. Les plans Premium TopV existent (visibilité dans les classements, Weekly Spotlight, etc.) mais sont totalement indépendants du bot.

Une commande. Staff vérifié, rolistes en fiche, trophées comptés.