TopV Bot

133 554 Discord members reached

Before you start

What you need

A Discord server where you have the Manage Server permission (typically the owner or an admin).
A TopV server profile already created — /setup-server if you don't have one yet.
About 2 minutes of your time. The setup is a single trip through the wizard.

1Install

Add the bot to your Discord

Click the button below. Discord opens a permission prompt — accept it. The bot lands in your server with the minimum permissions it needs (read members and roles, send messages in the channel of your choice). Nothing more.

Add to my Discord

Discord — Authorize prompt

An external application

TopV wants to access your Discord server

ADD TO SERVER

My RP Server

Verify it's there

Once the prompt closes, you should see TopV in the member list on the right side of Discord. The status dot is green when the bot is online.

Discord — Member list

Welcome to your server. Type / to see commands.

ONLINE — 12

TopVAPP

Damien (you)

ic3d_

speXtrum

2Verification

Link the bot to your TopV server

In any text channel, type:

/topv-link

Discord — Slash command picker

TopV8 commands

/topv-linkBind this Discord to your TopV server or creator profile

Enter ↵

/topv-link

Discord will ask you for the slug of your TopV server profile — that's the part of the URL after topv.gg/servers/. For example, if your fiche is at topv.gg/servers/saga-rp, type saga-rp.

Ownership check

The bot will only accept the link if your Discord account is the same one that registered the TopV profile. Anti-squat is built-in — nobody else can hijack your fiche.

Confirmation

Run /topv-status anytime to see the current link status (linked / unlinked / error).

Discord — Reply (only visible to you)

TopVAPPToday at 21:42(only visible to you)

✅ Saga RP is now linked to 🏠 Server Saga RP

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

Auto-sync every 6h. Run /topv-sync for an immediate resync.

3Roles

Pick the staff and roliste roles

This is how the bot knows who's on your team and who's a roleplayer. Open your TopV dashboard:

Open dashboard

Go to your server's edit page, scroll to the Discord roles section, and tick the roles you want.

Staff roles — admins, mods and team members. They appear on your fiche with avatar + role badge, auto-updated.
Roliste roles — every member with this role gets their own TopV profile (character, projects, trophies, reviews). They keep it for life, even if they leave your server.

TopV Dashboard — Discord roles

⚙️

Discord Roles

2 selected

Pick the Discord roles that represent your staff team and your players (rolistes). Staff will appear on your public profile, and rolistes will automatically get a player profile on TopV.

🛡️I SAST

⭐I LSCSO

EMS

👤I Animateur

🎮I Streamer

✓

👥I Partenaire

Staff▾

✓

Citoyen

Roleplayer▾

Staff

Roliste

Refresh on demand

Run /topv-sync any time to force a fresh pull. The bot will re-scan members for the configured roles and update both your fiche and individual profiles.

4Notifications

Pick the notifications channel

Decide where the bot announces things: sync results, new trophies, new reviews on your fiche, Weekly Spotlight reminders. Run:

/topv-channel #your-channel

Discord — Slash command (autocomplete)

/topv-channelchannel:

Text channel

général

staff-only

rolistes

annonces

↑↓navigate↵selectesccancel

/topv-channelchannel:|

Discord — Reply (only visible to you)

TopVAPPToday at 21:42(only visible to you)

✅ TopV notifications will now be sent to #salon-staff

Pro tip: pick a private staff-only channel — most messages are for you and your team, not for the whole community.

Required permission

Make sure the bot can read and send messages in the channel you pick. If it can't, you'll see the error in /topv-status.

5RP Trophies

Activate the trophy system

This step is optional. If you want your community to be able to reward great RP moments:

/topv-trophy-setup

Discord — Bot reply

TopVAPPToday at 21:42

⚙️ Trophy Configuration

Choose the channel where trophy rewards will be publicly announced, then click Validate.\n\n*To manage who can use `/eval` and in which channels, use Discord native permissions (Server Settings → Integrations → TopV).*

✅ Validate configuration

The bot asks you which channels are eligible for /eval and which roles can use it (typically your staff + senior rolistes). Anti-abuse is built in:

Cooldown between two /eval from the same author.
Daily cap per evaluator (no flood).
Role-based gating — only configured roles can use /eval.
Full audit log: every trophy point is traceable to the evaluator and channel.

Once active, anyone with the right role can type /eval @player in an eligible channel. The trophy point counts toward the player's TopV ranking.

Discord — Slash command picker

TopV8 commands

/evalEvaluate this player's RP

Enter ↵

/evalplayer:@Dr Stone

Discord — Bot reply

IppoJinEvoVerse Académie | FAused/eval

TopVAPPToday at 21:42

TopV — Trophy System

🏆 RP Evaluation

Evaluate @Dr Stone's RP skills by clicking a button below.\n\nEach point contributes to their progression and rank on TopV.gg

Evaluator: IppoJin · EvoVerse Académie | FA

🎭Fear RP

🎬RP Coherence

🎪Theatre

😰Pain RP

🗣️Improvisation

👑Server Pillar

Reference

All slash commands

/topv-link

Bind this Discord guild to your TopV server profile.

/topv-sync

Force a fresh staff & roliste sync. Use after changing roles.

/topv-status

Show current verification status, linked TopV slug, last sync date.

/topv-channel

Pick the channel for sync, trophies, reviews and Weekly Spotlight reminders.

/topv-trophy-setup

Configure trophy channels and eligible roles for /eval. Optional.

/eval @player

Award one trophy point to a roleplayer. Only inside configured channels.

/topv-help

Show all commands and a recap of how the RP trophy system works.

/topv-unlink

Remove the link between this guild and your TopV profile.

Trust

Permissions & privacy

What the bot CAN do

Read your member list (Privileged GUILD_MEMBERS intent — approved by Discord).
Read role assignments (read-only) to identify staff and rolistes.
Send messages in the channel you set with /topv-channel.
Listen to slash commands in any channel where it has access.

What the bot CANNOT do

Ban, kick or timeout any member.
Create, edit or delete channels.
Modify any role — only read-access.
Send DMs to your members.
Read message content (no MESSAGE_CONTENT intent).

Help

Troubleshooting & FAQ

›/topv-link says 'Unauthorized'

Your Discord account is not the owner of the targeted TopV server profile. Either log into TopV with the right Discord account, or transfer ownership of the TopV profile first via /dashboard.

›Staff list isn't showing up on my fiche

Make sure you ticked at least one role as 'staff' in the dashboard, then run /topv-sync to force a refresh. If still empty, check that the bot can see those roles (Discord role list, position above the bot).

›Roliste profiles don't get created

Same logic — tag at least one role as 'roliste' in the dashboard and run /topv-sync. Members need to have at least one of those roles. Profiles are created within seconds.

›/eval says the channel isn't eligible

Run /topv-trophy-setup again and add the current channel to the eligible list. Trophy points only count from channels you have explicitly approved.

›Can I uninstall the bot later?

Yes, any time. Run /topv-unlink to detach the link first (so your fiche knows the guild is no longer connected), then kick the bot from your Discord. No data of yours is kept beyond the verification record.

›Does it cost anything?

No. The bot is and will stay free. There is no upsell tied to it. Premium TopV plans exist (visibility on rankings, Weekly Spotlight, etc.) but they are completely independent of the bot.

One command. Staff verified, players listed, trophies counted.

Add to my Discord Back home