Skip to main content
Esta guía recorre todo el bot en orden: primero decides qué quieres montar, luego lo montas, y al final lo conectas con tu servidor de Minecraft. Si solo quieres arrancar rápido, ve a Primeros pasos.

​
Paso 0 · Decide qué necesitas

Antes de escribir ningún comando, responde estas cuatro preguntas: cada una se corresponde con una opción de /whitelist create.
Una whitelist = un canal de registro = un conjunto de reglas. Crea varias cuando el público sea distinto: Evento abierto a todos, Beta solo para testers, Staff aparte.Un mismo jugador puede estar en varias whitelists del servidor; el límite de nicks se cuenta por whitelist, no en total.
Máximo 3 whitelists por propietario de servidor. El cupo es del dueño del Discord, no del servidor ni de quien escribe el comando: si tienes tres Discords, las 3 whitelists se reparten entre los tres, y una whitelist creada por un miembro de tu staff cuenta igualmente para ti. Puedes ver cuántas llevas con /whitelist list, y liberar hueco con /whitelist delete.
  • Premium y No Premium (por defecto): entra todo el mundo. Si el nick tiene cuenta de Mojang, el bot pregunta al jugador cómo quiere registrarse.
  • Solo Premium: se rechaza cualquier nick que no exista en Mojang.
  • Solo No Premium: se rechaza cualquier nick que sí exista en Mojang.
Cámbialo cuando quieras con /whitelist set-type.
  • Mensajes: el jugador escribe su nick en el canal. Clásico, muy fácil de entender, pero el canal se llena de mensajes.
  • Botones: el canal solo tiene un panel; todo el registro ocurre en privado. Canal limpio, y el jugador puede gestionar sus nicks desde el propio panel.
Comparativa completa en Cómo funciona el registro.
De 1 a 50. Con 1 (por defecto) cada jugador registra una cuenta; súbelo si permites cuentas alternativas o si un mismo Discord gestiona varias personas (familias, cibercafés, equipos).Cuando alguien llega a su límite, el bot no le rechaza sin más: le ofrece sustituir uno de sus nicks por el nuevo.

​
Paso 1 · Prepara Discord

1

Invita el bot

Enlace de invitación.
2

Crea los canales

Uno de registro por whitelist, y (opcional) uno de logs. En el canal de registro el bot necesita ver el canal, enviar mensajes, insertar enlaces, añadir reacciones y gestionar mensajes.
3

Decide quién es staff del bot

Por defecto pueden usar los comandos el dueño del servidor y quien tenga Administrador o Gestionar servidor. Para dar acceso a un rol concreto sin darle permisos de Discord:
Detalle completo en Permisos.

​
Paso 2 · Crea la whitelist

El bot publica el embed (o el panel, en modo Botones) en el canal y te devuelve el ID de la whitelist en un mensaje privado. Ese ID aparece también en /whitelist list y /whitelist show, y es lo que necesitas para la API y para soporte.
Si ya sabes que la whitelist será solo para un rol y con logs propios, déjalo listo en el mismo comando con rol_requerido: y canal_logs:. Te ahorras dos comandos.

​
Cambiar cosas después

Nada de lo que elijas al crear es definitivo:
/whitelist delete borra la whitelist y todos sus nicks, sin confirmación y sin vuelta atrás. Si solo quieres cerrar el registro temporalmente, usa /whitelist toggle.

​
Paso 3 · Controla quién puede entrar

Cada whitelist tiene cuatro listas de roles independientes. La página de Roles las explica a fondo; el resumen: Receta habitual — verificación automática:
Al registrarse, el jugador pasa de @SinVerificar a @Verificado en el mismo paso. Si más adelante se quita el nick (él, el staff o el servidor de Minecraft), el bot deshace el intercambio.
Para que esto funcione el bot necesita Gestionar roles y su rol debe estar por encima de los roles implicados. Si no puede, el nick se registra igualmente pero los roles no se mueven — es un fallo silencioso. Compruébalo antes de anunciarlo a tu comunidad.

​
Paso 4 · Enciende los logs

Sin logs el bot funciona igual, pero te quedas sin saber quién se apuntó y quién no pudo.
Ese canal recoge la actividad de todas las whitelists que no tengan uno propio. Si gestionas varios eventos con equipos distintos, dale a cada whitelist el suyo:
El orden es siempre canal de la whitelist → canal del servidor → nada. Todo el detalle, en Logs.

​
Paso 5 · El día a día del staff

El bot detecta solo si la cuenta es Premium. Si necesitas forzarlo (por ejemplo, registrar como No Premium un nick que sí existe en Mojang), añade tipo_cuenta:"No Premium". Las altas manuales también aplican los roles configurados.
Se revierte el intercambio de roles y, si tienes el plugin, el jugador sale de la whitelist del servidor al instante.
/whitelist list para el resumen de todas (con su ID y su número de nicks), y /whitelist show whitelist:"Evento" para el detalle completo de una.
Qué formato elegir, en Exportar.
Útil si el panel se borró o quedó sepultado. Si la whitelist no estaba en modo Botones, el comando la cambia automáticamente.
Y los jugadores se autogestionan: /mis-nicks les deja ver y quitar sus propios registros sin molestar al staff.

​
Paso 6 · Conecta el servidor de Minecraft

Hasta aquí tienes la whitelist viviendo en Discord y la exportas cuando quieras. Con el plugin oficial el ciclo se cierra solo:
1

Genera la clave en Discord

La clave se muestra una sola vez. Cópiala en ese momento.
2

Instala el plugin

Copia el .jar en plugins/, arranca el servidor y ejecuta en el juego /eventswhitelist apikey TU_CLAVE.
3

Comprueba la conexión

/eventswhitelist status en el juego: api-key configurada, WebSocket conectado, última sincronización.
A partir de ahí, cada alta y cada baja en Discord se aplican en el servidor al instante — y al revés: si el staff quita a alguien con /whitelist remove en el juego, también desaparece de Discord. ¿Tienes tu propio panel o backend? Puedes hablar directamente con la API en vez de usar el plugin.

​
Tres configuraciones que funcionan

Máxima participación, mínima fricción.
Canal limpio gracias al modo Botones, todo el mundo puede apuntarse y el staff ve la actividad en un único canal de logs.

​
Siguiente parada

Referencia de comandos

Todos los comandos, con sus opciones.

Preguntas frecuentes

Las dudas que más nos llegan.

Solución de problemas

Cuando algo no sale como esperabas.

Soporte de EventsMC

Te ayudamos con tu configuración concreta.