TopV × Discord

TopV Bot

Adicionar ao meu DiscordVer todos os comandos ↓
124 203 Discord members reached
Antes de começar

O que precisas

  • Um servidor Discord onde tens a permissão Gerir Servidor (tipicamente o dono ou um admin).
  • Uma ficha servidor TopV já criada — /setup-server se ainda não tens uma.
  • Cerca de 2 minutos. A configuração faz-se numa só passagem.
1Instalação

Adicionar o bot ao teu Discord

Clica no botão abaixo. Discord abre um pedido de permissões — aceita. O bot chega ao teu servidor com o mínimo (ler membros e cargos, enviar mensagens no canal que escolheres). Nada mais.

Adicionar ao meu Discord
Discord — Authorize prompt
An external application
TopV wants to access your Discord server
ADD TO SERVER
R
My RP Server
Verifica que está lá
Depois do popup fechar, deves ver TopV na lista de membros à direita. O ponto está verde quando o bot está online.
Discord — Member list
Welcome to your server. Type / to see commands.
ONLINE — 12
TopVAPP
D
Damien (you)
I
ic3d_
S
speXtrum
2Verificação

Ligar o bot à tua ficha TopV

Em qualquer canal de texto, escreve:

/topv-link
Discord — Slash command picker
TopV8 commands
/topv-linkLigar este Discord à tua ficha servidor ou criador TopV
Enter ↵
/topv-link

Discord pede o slug da tua ficha — é a parte do URL depois de topv.gg/servers/. Por exemplo, se a tua ficha está em topv.gg/servers/saga-rp, escreve saga-rp.

Verificação de propriedade
O bot só aceita a ligação se a tua conta Discord for a mesma que registou a ficha TopV. Anti-squat integrado.
Confirmação
Executa /topv-status a qualquer momento para ver o estado da ligação.
Discord — Reply (only visible to you)
TopVAPPToday at 21:42(only visible to you)
✅ Saga RP está agora ligado a 🏠 Server Saga RP

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

Auto-sync a cada 6h. Executa /topv-sync para resync imediato.
3Cargos

Escolher os cargos staff e roliste

É assim que o bot sabe quem está na equipa e quem é jogador. Abre o teu dashboard TopV:

Abrir dashboard

Vai à página de edição da ficha servidor, desce até à secção Cargos Discord e marca os cargos pretendidos.

  • Cargos staff — admins, mods e team. Aparecem na ficha com avatar + badge de cargo, sync automático.
  • Cargos rolistes — cada membro com este cargo recebe a sua ficha TopV (personagem, projetos, troféus, avaliações). Mantém-na para 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 sob pedido
Executa /topv-sync a qualquer momento. O bot re-escaneia membros e atualiza a tua ficha e perfis individuais.
4Notificações

Escolher o canal de notificações

Decide onde o bot publica: resultados de sync, novos troféus, avaliações, lembretes Weekly Spotlight. Executa:

/topv-channel #teu-canal
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)
✅ As notificações TopV serão enviadas para #salon-staff

Pro tip: escolhe um canal privado só staff — a maioria das mensagens são para ti e a tua equipa.

Permissão necessária
Garante que o bot pode ler e enviar mensagens no canal escolhido. Senão /topv-status indica o erro.
5Troféus RP

Ativar o sistema de troféus

Este passo é opcional. Se queres que a tua comunidade recompense momentos RP:

/topv-trophy-setup
Discord — Bot reply
TopVAPPToday at 21:42
⚙️ Configuração de troféus
Escolhe o canal onde as recompensas serão anunciadas publicamente e clica em Validar.\n\n*Para gerir quem pode usar `/eval`, usa as permissões nativas Discord (Definições → Integrações → TopV).*
✅ Validar configuração

O bot pergunta quais canais são elegíveis a /eval e quais cargos podem usá-lo (tipicamente staff + rolistes seniores). Anti-abuso integrado:

  • Cooldown entre dois /eval do mesmo autor.
  • Limite diário por avaliador (anti-flood).
  • Gating por cargo — só os cargos configurados podem usar /eval.
  • Audit log completo: cada ponto é rastreável ao avaliador e canal.

Uma vez ativo, qualquer membro com o cargo certo pode escrever /eval @player num canal elegível. O ponto conta no ranking TopV do jogador.

Discord — Slash command picker
TopV8 commands
/evalAvaliar o RP deste jogador
Enter ↵
/evaljogador:@Dr Stone
Discord — Bot reply
IppoJinEvoVerse Académie | FAused/eval
TopVAPPToday at 21:42
TopV — Sistema de Troféus
🏆 Avaliação RP
Avalia as habilidades RP de @Dr Stone clicando num botão.\n\nCada ponto contribui para a sua progressão e rank em TopV.gg
Avaliador: IppoJin · EvoVerse Académie | FA
🎭Fear RP
🎬Coerência RP
🎪Teatro
😰Pain RP
🗣️Improvisation
👑Pilar
Referência

Todos os slash commands

/topv-link

Liga esta guild Discord à tua ficha servidor TopV.

/topv-sync

Força uma resync staff + rolistes. Útil após mudar cargos.

/topv-status

Mostra estado de verificação, slug TopV ligado, última sync.

/topv-channel

Escolhe o canal para sync, troféus, avaliações e lembretes Weekly Spotlight.

/topv-trophy-setup

Configura canais e cargos elegíveis para /eval. Opcional.

/eval @player

Atribui um ponto de troféu a um jogador. Só em canais configurados.

/topv-help

Mostra todos os comandos e um resumo do sistema de troféus RP.

/topv-unlink

Remove a ligação entre esta guild e o teu perfil TopV.

Confiança

Permissões e privacidade

O que o bot PODE fazer

  • Ler a lista de membros (intent GUILD_MEMBERS — aprovado pelo Discord).
  • Ler atribuições de cargos (só leitura) para identificar staff e rolistes.
  • Enviar mensagens no canal definido por /topv-channel.
  • Ouvir slash commands em qualquer canal a que tem acesso.

O que o bot NÃO pode fazer

  • Banir, expulsar ou silenciar membros.
  • Criar, editar ou eliminar canais.
  • Modificar qualquer cargo — só acesso de leitura.
  • Enviar DMs aos membros.
  • Ler conteúdo de mensagens (sem intent MESSAGE_CONTENT).
Ajuda

Resolução de problemas e FAQ

›/topv-link diz 'Não autorizado'

A tua conta Discord não é proprietária da ficha TopV. Inicia sessão com a conta certa ou transfere a propriedade via /dashboard.

›Lista de staff não aparece na minha ficha

Verifica que pelo menos um cargo está marcado 'staff' no dashboard, depois executa /topv-sync. Se vazio, verifica que o bot vê esses cargos (posição acima do bot).

›Os perfis rolistes não são criados

Mesma lógica — marca pelo menos um cargo como 'roliste' no dashboard e executa /topv-sync. Membros precisam ter pelo menos um desses cargos. Fichas criadas em segundos.

›/eval diz que o canal não é elegível

Executa /topv-trophy-setup novamente e adiciona o canal atual à lista elegível. Os pontos só contam de canais explicitamente aprovados.

›Posso desinstalar o bot mais tarde?

Sim, a qualquer momento. Executa /topv-unlink primeiro (para a tua ficha saber que a guild já não está ligada), depois expulsa o bot. Não são guardados dados além do registro de verificação.

›Custa alguma coisa?

Não. O bot é e continuará gratuito. Sem upsell associado. Os planos Premium TopV existem (visibilidade nos rankings, Weekly Spotlight, etc.) mas são totalmente independentes do bot.

Um comando. Staff verificado, jogadores listados, troféus contados.

Adicionar ao meu DiscordVoltar à página inicial