TopV Bot

Añadir a mi Discord Ver todos los comandos ↓

128 181 Discord members reached

Antes de empezar

Lo que necesitas

Un servidor Discord donde tengas el permiso Gestionar Servidor (típicamente el dueño o un admin).
Un perfil de servidor TopV ya creado — /setup-server si aún no tienes uno.
Unos 2 minutos. La configuración se hace en una sola pasada.

1Instalación

Añadir el bot a tu Discord

Haz clic en el botón. Discord abre una solicitud de permisos — acepta. El bot llega a tu servidor con lo mínimo (leer miembros y roles, enviar mensajes en el canal que elijas). Nada más.

Añadir a mi Discord

Discord — Authorize prompt

An external application

TopV wants to access your Discord server

ADD TO SERVER

My RP Server

Verifica que esté ahí

Una vez cerrada la ventana, deberías ver TopV en la lista de miembros a la derecha. El punto está verde cuando el bot está online.

Discord — Member list

Welcome to your server. Type / to see commands.

ONLINE — 12

TopVAPP

Damien (you)

ic3d_

speXtrum

2Verificación

Vincular el bot a tu servidor TopV

En cualquier canal de texto, escribe:

/topv-link

Discord — Slash command picker

TopV8 commands

/topv-linkVincular este Discord a tu perfil de servidor o creador TopV

Enter ↵

/topv-link

Discord te pedirá el slug de tu perfil — es la parte de la URL después de topv.gg/servers/. Por ejemplo, si tu ficha está en topv.gg/servers/saga-rp, escribe saga-rp.

Verificación de propiedad

El bot solo acepta el enlace si tu cuenta Discord es la misma que registró el perfil TopV. Anti-squat integrado — nadie más puede secuestrar tu ficha.

Confirmación

Ejecuta /topv-status en cualquier momento para ver el estado del enlace.

Discord — Reply (only visible to you)

TopVAPPToday at 21:42(only visible to you)

✅ Saga RP ahora está vinculado a 🏠 Server Saga RP

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

Auto-sync cada 6h. Ejecuta /topv-sync para resync inmediato.

3Roles

Elegir los roles staff y roliste

Así es como el bot sabe quién está en tu equipo y quién es jugador. Abre tu dashboard TopV:

Abrir dashboard

Ve a la página de edición del servidor, baja a la sección Roles Discord y marca los roles que quieras.

Roles staff — admins, mods y team. Aparecen en tu ficha con avatar + badge de rol, sync automático.
Roles rolistes — cada miembro con este rol obtiene su propia ficha TopV (personaje, proyectos, trofeos, reseñas). La conservan de por vida.

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 bajo demanda

Ejecuta /topv-sync en cualquier momento para forzar un refresh. El bot re-escanea miembros y actualiza tu ficha y los perfiles individuales.

4Notificaciones

Elegir el canal de notificaciones

Decide dónde el bot publica: resultados de sync, nuevos trofeos, reseñas, recordatorios Weekly Spotlight. Ejecuta:

/topv-channel #tu-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)

✅ Las notificaciones TopV se enviarán a #salon-staff

Pro tip: elige un canal privado solo staff — la mayoría son para ti y tu equipo, no para la comunidad.

Permiso requerido

Asegúrate de que el bot pueda leer y enviar mensajes en el canal elegido. Si no, /topv-status lo señalará.

5Trofeos RP

Activar el sistema de trofeos

Este paso es opcional. Si quieres que tu comunidad recompense los buenos momentos RP:

/topv-trophy-setup

Discord — Bot reply

TopVAPPToday at 21:42

⚙️ Configuración de trofeos

Elige el canal donde se anunciarán las recompensas de trofeos, luego pulsa Validar.\n\n*Para gestionar quién puede usar `/eval`, usa los permisos nativos de Discord (Configuración → Integraciones → TopV).*

✅ Validar configuración

El bot pregunta qué canales son elegibles para /eval y qué roles pueden usarlo (típicamente staff + rolistes senior). Anti-abuso integrado:

Cooldown entre dos /eval del mismo autor.
Límite diario por evaluador (anti-flood).
Gating por rol — solo los roles configurados pueden usar /eval.
Audit log completo: cada punto es trazable al evaluador y canal.

Una vez activo, cualquier miembro con el rol correcto puede escribir /eval @player en un canal elegible. El punto cuenta en el ranking TopV del jugador.

Discord — Slash command picker

TopV8 commands

/evalEvaluar el RP de este jugador

Enter ↵

/evaljugador:@Dr Stone

Discord — Bot reply

IppoJinEvoVerse Académie | FAused/eval

TopVAPPToday at 21:42

TopV — Sistema de Trofeos

🏆 Evaluación RP

Evalúa las habilidades RP de @Dr Stone haciendo clic en un botón.\n\nCada punto contribuye a su progresión y rango en TopV.gg

Evaluador: IppoJin · EvoVerse Académie | FA

🎭Fear RP

🎬Coherencia RP

🎪Teatro

😰Pain RP

🗣️Improvisation

👑Pilar

Referencia

Todos los slash commands

/topv-link

Vincula esta guild Discord a tu perfil de servidor TopV.

/topv-sync

Fuerza una resync staff + rolistes. Útil tras cambiar roles.

/topv-status

Muestra el estado de verificación, slug TopV vinculado, última sync.

/topv-channel

Elige el canal para sync, trofeos, reseñas y recordatorios Weekly Spotlight.

/topv-trophy-setup

Configura canales y roles elegibles para /eval. Opcional.

/eval @player

Otorga un punto de trofeo a un jugador. Solo en canales configurados.

/topv-help

Muestra todos los comandos y un resumen del sistema de trofeos RP.

/topv-unlink

Elimina el enlace entre esta guild y tu perfil TopV.

Confianza

Permisos y privacidad

Lo que el bot PUEDE hacer

Leer tu lista de miembros (intent GUILD_MEMBERS — aprobado por Discord).
Leer asignaciones de rol (solo lectura) para identificar staff y rolistes.
Enviar mensajes en el canal definido por /topv-channel.
Escuchar slash commands en cualquier canal donde tenga acceso.

Lo que el bot NO puede hacer

Banear, expulsar o silenciar a un miembro.
Crear, editar o eliminar canales.
Modificar cualquier rol — solo acceso de lectura.
Enviar DMs a tus miembros.
Leer el contenido de mensajes (sin intent MESSAGE_CONTENT).

Ayuda

Resolución de problemas y FAQ

›/topv-link dice 'No autorizado'

Tu cuenta Discord no es el propietario del perfil TopV. Inicia sesión en TopV con la cuenta correcta o transfiere la propiedad desde /dashboard.

›La lista de staff no aparece en mi ficha

Asegúrate de marcar al menos un rol como 'staff' en el dashboard, luego ejecuta /topv-sync. Si sigue vacío, comprueba que el bot pueda ver esos roles (posición arriba del bot).

›Los perfiles rolistes no se crean

Misma lógica — marca al menos un rol como 'roliste' en el dashboard y ejecuta /topv-sync. Los miembros deben tener al menos uno de esos roles. Las fichas se crean en segundos.

›/eval dice que el canal no es elegible

Ejecuta /topv-trophy-setup de nuevo y añade el canal actual a la lista elegible. Los puntos solo cuentan desde canales explícitamente aprobados.

›¿Puedo desinstalar el bot más tarde?

Sí, en cualquier momento. Ejecuta /topv-unlink para desconectar primero (tu ficha sabe que la guild ya no está conectada), luego echa el bot. No se conservan tus datos más allá del registro de verificación.

›¿Cuesta algo?

No. El bot es y será gratis. No hay upsell asociado. Los planes Premium TopV existen (visibilidad en rankings, Weekly Spotlight, etc.) pero son totalmente independientes del bot.

Un comando. Staff verificado, jugadores listados, trofeos contados.

Añadir a mi Discord Volver al inicio