TopV × Discord

TopV Bot

Aggiungi al mio DiscordVedi tutti i comandi ↓
128 181 Discord members reached
Prima di iniziare

Cosa ti serve

  • Un server Discord dove hai il permesso Gestisci Server (di solito il proprietario o un admin).
  • Una scheda server TopV già creata — /setup-server se non ne hai ancora una.
  • Circa 2 minuti. La configurazione si fa in una sola passata.
1Installazione

Aggiungi il bot al tuo Discord

Clicca sul pulsante. Discord apre una richiesta di permessi — accetta. Il bot arriva nel server con il minimo necessario (leggere membri e ruoli, inviare messaggi nel canale che scegli). Niente di più.

Aggiungi al mio Discord
Discord — Authorize prompt
An external application
TopV wants to access your Discord server
ADD TO SERVER
R
My RP Server
Verifica che ci sia
Una volta chiuso il popup, dovresti vedere TopV nella lista dei membri a destra. Il pallino è verde quando il bot è online.
Discord — Member list
Welcome to your server. Type / to see commands.
ONLINE — 12
TopVAPP
D
Damien (you)
I
ic3d_
S
speXtrum
2Verifica

Collega il bot al tuo server TopV

In qualsiasi canale di testo, digita:

/topv-link
Discord — Slash command picker
TopV8 commands
/topv-linkCollega questo Discord al tuo profilo server o creator TopV
Enter ↵
/topv-link

Discord chiederà lo slug del tuo profilo — la parte URL dopo topv.gg/servers/. Per esempio, se la scheda è a topv.gg/servers/saga-rp, digita saga-rp.

Verifica di proprietà
Il bot accetta il link solo se il tuo account Discord è lo stesso che ha registrato il profilo TopV. Anti-squat integrato.
Conferma
Esegui /topv-status in qualsiasi momento per vedere lo stato del collegamento.
Discord — Reply (only visible to you)
TopVAPPToday at 21:42(only visible to you)
✅ Saga RP è ora collegato a 🏠 Server Saga RP

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

Auto-sync ogni 6h. Esegui /topv-sync per resync immediata.
3Ruoli

Scegliere i ruoli staff e roliste

È così che il bot sa chi è nel team e chi è un roleplayer. Apri il dashboard TopV:

Apri dashboard

Vai alla pagina di modifica del server, scorri fino alla sezione Ruoli Discord e spunta i ruoli desiderati.

  • Ruoli staff — admin, mod e team. Appaiono sulla scheda con avatar + badge ruolo, sync automatica.
  • Ruoli rolistes — ogni membro con questo ruolo ottiene la sua scheda TopV (personaggio, progetti, trofei, recensioni). La mantengono per sempre.
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
Resync su richiesta
Esegui /topv-sync per forzare un refresh. Il bot ri-scansiona i membri e aggiorna scheda e profili individuali.
4Notifiche

Scegliere il canale notifiche

Decidi dove il bot pubblica: risultati sync, nuovi trofei, recensioni, promemoria Weekly Spotlight. Esegui:

/topv-channel #tuo-canale
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)
✅ Le notifiche TopV verranno inviate a #salon-staff

Pro tip: scegli un canale privato solo staff — la maggior parte dei messaggi sono per te e il team.

Permesso richiesto
Assicurati che il bot possa leggere e inviare messaggi nel canale scelto. Altrimenti /topv-status mostra l'errore.
5Trofei RP

Attivare il sistema di trofei

Questo passaggio è opzionale. Se vuoi che la tua community premi i grandi momenti RP:

/topv-trophy-setup
Discord — Bot reply
TopVAPPToday at 21:42
⚙️ Configurazione trofei
Scegli il canale dove i premi trofeo saranno annunciati pubblicamente, poi clicca Valida.\n\n*Per gestire chi può usare `/eval`, usa i permessi Discord nativi (Impostazioni → Integrazioni → TopV).*
✅ Valida configurazione

Il bot chiede quali canali sono idonei per /eval e quali ruoli possono usarlo (tipicamente staff + rolistes senior). Anti-abuso integrato:

  • Cooldown tra due /eval dello stesso autore.
  • Limite giornaliero per valutatore (anti-flood).
  • Gating per ruolo — solo i ruoli configurati possono usare /eval.
  • Audit log completo: ogni punto è tracciabile a valutatore e canale.

Una volta attivo, chiunque con il ruolo giusto può digitare /eval @player in un canale idoneo. Il punto conta nel ranking TopV del giocatore.

Discord — Slash command picker
TopV8 commands
/evalValuta l'RP di questo giocatore
Enter ↵
/evalgiocatore:@Dr Stone
Discord — Bot reply
IppoJinEvoVerse Académie | FAused/eval
TopVAPPToday at 21:42
TopV — Sistema Trofei
🏆 Valutazione RP
Valuta le abilità RP di @Dr Stone cliccando un pulsante.\n\nOgni punto contribuisce alla progressione e al rank su TopV.gg
Valutatore: IppoJin · EvoVerse Académie | FA
🎭Fear RP
🎬Coerenza RP
🎪Teatro
😰Pain RP
🗣️Improvisation
👑Pilastro
Riferimento

Tutti gli slash commands

/topv-link

Lega questa guild Discord al tuo profilo server TopV.

/topv-sync

Forza una resync staff + rolistes. Utile dopo aver cambiato ruoli.

/topv-status

Mostra stato verifica, slug TopV collegato, ultima sync.

/topv-channel

Scegli il canale per sync, trofei, recensioni e promemoria Weekly Spotlight.

/topv-trophy-setup

Configura canali trofei e ruoli idonei per /eval. Opzionale.

/eval @player

Assegna un punto trofeo a un giocatore. Solo nei canali configurati.

/topv-help

Mostra tutti i comandi e un riassunto del sistema trofei RP.

/topv-unlink

Rimuove il collegamento tra questa guild e il tuo profilo TopV.

Fiducia

Permessi e privacy

Cosa il bot PUÒ fare

  • Leggere la lista membri (intent GUILD_MEMBERS — approvato da Discord).
  • Leggere assegnazioni ruoli (sola lettura) per identificare staff e rolistes.
  • Inviare messaggi nel canale impostato con /topv-channel.
  • Ascoltare slash commands nei canali a cui ha accesso.

Cosa il bot NON PUÒ fare

  • Bannare, espellere o silenziare membri.
  • Creare, modificare o eliminare canali.
  • Modificare ruoli — solo accesso in lettura.
  • Inviare DM ai membri.
  • Leggere contenuto messaggi (no MESSAGE_CONTENT intent).
Aiuto

Risoluzione problemi & FAQ

›/topv-link dice 'Non autorizzato'

Il tuo account Discord non è il proprietario del profilo TopV. Accedi a TopV con l'account giusto o trasferisci la proprietà da /dashboard.

›L'elenco staff non appare sulla mia scheda

Assicurati di aver spuntato almeno un ruolo come 'staff' nel dashboard, poi esegui /topv-sync. Se ancora vuoto, verifica che il bot veda quei ruoli.

›I profili rolistes non vengono creati

Stessa logica — spunta almeno un ruolo come 'roliste' nel dashboard ed esegui /topv-sync. I membri devono avere almeno uno di quei ruoli. Schede create in secondi.

›/eval dice che il canale non è idoneo

Esegui /topv-trophy-setup di nuovo e aggiungi il canale corrente alla lista idonea. I punti contano solo da canali esplicitamente approvati.

›Posso disinstallare il bot più tardi?

Sì, in qualsiasi momento. Esegui /topv-unlink prima (così la scheda sa che la guild non è più connessa), poi caccia il bot. Nessun dato viene conservato oltre il record di verifica.

›Costa qualcosa?

No. Il bot è e resterà gratuito. Nessun upsell associato. I piani Premium TopV esistono (visibilità classifiche, Weekly Spotlight, ecc.) ma sono completamente indipendenti dal bot.

Un comando. Staff verificato, giocatori elencati, trofei contati.

Aggiungi al mio DiscordTorna alla home