Documentacion

Tutoriales y Guias

Aprende a configurar KellyMaster paso a paso con nuestras guias detalladas.

1
Facil
5 min

Instalacion Basica

Aprende a instalar KellyMaster en tu servidor de Minecraft paso a paso.

  1. 1 Descarga el archivo KellyMaster.jar desde nuestro Discord oficial o la pagina de descargas.
  2. 2 Detiene tu servidor de Minecraft completamente antes de instalar el plugin.
  3. 3 Coloca el archivo KellyMaster.jar en la carpeta /plugins de tu servidor.
  4. 4 Inicia el servidor. El plugin generara automaticamente los archivos config.yml, whitelist.yml y messages.yml.
  5. 5 Detiene el servidor nuevamente para editar los archivos de configuracion.
  6. 6 Configura config.yml con tus preferencias de seguridad (timeout, intentos maximos, acciones de seguridad).
  7. 7 Configura whitelist.yml con los operadores autorizados y sus metodos de verificacion.
  8. 8 Inicia el servidor nuevamente. KellyMaster estara activo y protegiendo tu servidor.
2
Intermedio
10 min

Configurar config.yml

Guia completa para configurar todas las opciones del archivo config.yml.

  1. 1 Abre el archivo plugins/KellyMaster/config.yml con un editor de texto.
  2. 2 En la seccion "settings", configura el idioma (lang: es/en/ru/zh) para las notificaciones externas.
  3. 3 Configura verification-timeout (tiempo en segundos para verificar, recomendado: 60-120).
  4. 4 Configura code-length (longitud del codigo, recomendado: 6-8 caracteres).
  5. 5 Activa deop-on-disconnect: true para quitar OP automaticamente cuando un jugador se desconecta.
  6. 6 En la seccion "security", configura unauthorized-action (BAN/KICK/DEOP) para jugadores no autorizados.
  7. 7 En "blocked-commands", agrega los comandos que quieres bloquear para jugadores (solo consola puede usarlos).
  8. 8 Guarda el archivo y reinicia el servidor para aplicar los cambios.
3
Intermedio
8 min

Configurar whitelist.yml

Como agregar operadores autorizados y configurar sus metodos de verificacion.

  1. 1 Abre el archivo plugins/KellyMaster/whitelist.yml con un editor de texto.
  2. 2 En la seccion "setup-verification", define el metodo para cada operador: Usuario:Gmail, Usuario:Discord o Usuario:Telegram.
  3. 3 En "authorized-operators", agrega cada operador con su identificador: Usuario:email@example.com (Gmail), Usuario:123456789012345678 (Discord ID) o Usuario:123456789 (Telegram Chat ID).
  4. 4 Para obtener tu Discord ID: Activa Modo Desarrollador en Discord > Click derecho en tu perfil > Copiar ID.
  5. 5 Para obtener tu Telegram Chat ID: Habla con @userinfobot en Telegram y te dara tu ID.
  6. 6 Puedes tener multiples operadores con diferentes metodos de verificacion.
  7. 7 Los jugadores no listados en authorized-operators seran tratados como no autorizados.
  8. 8 Guarda el archivo y reinicia el servidor para aplicar los cambios.
4
Avanzado
15 min

Configurar Bot de Discord

Configura el bot de Discord para recibir codigos de verificacion por DM.

  1. 1 Ve a Discord Developer Portal (discord.com/developers/applications) e inicia sesion.
  2. 2 Haz clic en "New Application" y dale un nombre (ej: KellyMaster Bot).
  3. 3 Ve a la seccion "Bot" en el menu lateral y haz clic en "Add Bot".
  4. 4 En la seccion del Bot, haz clic en "Reset Token" y copia el token generado. NUNCA compartas este token.
  5. 5 Activa los intents necesarios: "Message Content Intent" en la seccion "Privileged Gateway Intents".
  6. 6 Ve a "OAuth2" > "URL Generator", selecciona "bot" y los permisos: "Send Messages", "Read Message History".
  7. 7 Copia la URL generada y abrela en tu navegador para invitar el bot a tu servidor de Discord.
  8. 8 En whitelist.yml, pega el token en discord.bot-token y activa discord.enabled: true.
  9. 9 En setup-verification, agrega tus operadores con el formato: NombreJugador:Discord.
  10. 10 En authorized-operators, agrega: NombreJugador:TU_DISCORD_ID (18 digitos).
  11. 11 Reinicia el servidor de Minecraft. El bot se conectara y estara listo para enviar codigos.
5
Avanzado
12 min

Configurar Bot de Telegram

Configura Telegram como metodo de verificacion usando BotFather.

  1. 1 Abre Telegram y busca @BotFather (el bot oficial de Telegram para crear bots).
  2. 2 Envia el comando /newbot para crear un nuevo bot.
  3. 3 Sigue las instrucciones: primero un nombre amigable (ej: KellyMaster Security) y luego un username unico (ej: KellyMasterSecBot).
  4. 4 BotFather te dara un token HTTP API. Copia este token.
  5. 5 En whitelist.yml, pega el token en telegram.bot-token y activa telegram.enabled: true.
  6. 6 Busca tu nuevo bot en Telegram y envia /start para iniciar una conversacion.
  7. 7 Para obtener tu Chat ID, habla con @userinfobot o @RawDataBot en Telegram.
  8. 8 En setup-verification, agrega tus operadores con el formato: NombreJugador:Telegram.
  9. 9 En authorized-operators, agrega: NombreJugador:TU_CHAT_ID (numeros).
  10. 10 Reinicia el servidor de Minecraft. Cuando necesites verificarte, recibiras el codigo por Telegram.
6
Avanzado
12 min

Configurar Email SMTP

Usa Gmail u otro servidor SMTP para enviar codigos de verificacion por email.

  1. 1 Ve a la configuracion de tu cuenta de Google: myaccount.google.com.
  2. 2 Ve a "Seguridad" y activa la "Verificacion en 2 pasos" si no la tienes activada.
  3. 3 En "Verificacion en 2 pasos", baja hasta "Contrasenas de aplicacion".
  4. 4 Crea una nueva contrasena de aplicacion: selecciona "Otro" y ponle nombre "KellyMaster".
  5. 5 Google generara una contrasena de 16 caracteres. Copiala (se muestra solo una vez).
  6. 6 En config.yml, configura la seccion email con: enabled: true, smtp.host: smtp.gmail.com, smtp.port: 587.
  7. 7 En smtp.user pon tu email de Gmail, en smtp.password pon la contrasena de aplicacion (16 caracteres).
  8. 8 En whitelist.yml, en setup-verification agrega: NombreJugador:Gmail.
  9. 9 En authorized-operators agrega: NombreJugador:tuemail@gmail.com.
  10. 10 Reinicia el servidor. Los codigos se enviaran a tu email cuando necesites verificarte.
7
Facil
5 min

Configurar Discord Webhook

Recibe alertas de seguridad en un canal de Discord usando webhooks.

  1. 1 En Discord, ve al servidor donde quieres recibir las alertas.
  2. 2 Click derecho en el canal donde quieres las notificaciones > "Editar canal".
  3. 3 Ve a "Integraciones" > "Webhooks" > "Nuevo Webhook".
  4. 4 Dale un nombre al webhook (ej: KellyMaster Alerts) y opcionalmente cambia el avatar.
  5. 5 Haz clic en "Copiar URL del Webhook".
  6. 6 En config.yml, pega la URL en webhook.url y activa webhook.enabled: true.
  7. 7 Configura que notificaciones quieres: notify-blocked-commands, notify-unauthorized-op, include-ip, include-geolocation.
  8. 8 Reinicia el servidor. Las alertas de seguridad se enviaran al canal de Discord.
8
Facil
5 min

Integracion con LuckPerms

Protege permisos peligrosos con la integracion automatica de LuckPerms.

  1. 1 Asegurate de tener LuckPerms instalado en tu servidor (es una dependencia opcional).
  2. 2 KellyMaster detectara automaticamente LuckPerms al iniciar.
  3. 3 La integracion monitorea cuando se asignan permisos peligrosos como: *, essentials.*, luckperms.*, minecraft.command.op.
  4. 4 Si un jugador no autorizado recibe estos permisos, sera automaticamente baneado y los permisos removidos.
  5. 5 Para ver los eventos detectados, revisa los logs del servidor o configura el webhook de Discord.
  6. 6 No necesitas configuracion adicional, la integracion funciona automaticamente.
Ejemplos

Ejemplos de Configuracion

config.yml 

# Configuracion General
settings:
  lang: es
  debug: false
  verification-timeout: 60
  code-length: 8
  deop-on-disconnect: true
  max-verification-attempts: 3

# Configuracion de Seguridad
security:
  unauthorized-action: BAN
  allow-non-whitelist-op: false
  log-ip-addresses: true

# Discord Webhook
webhook:
  enabled: true
  url: "https://discord.com/api/webhooks/..."
  notify-blocked-commands: true
  include-geolocation: true

whitelist.yml 

# Configuracion del Bot de Discord
discord:
  enabled: true
  bot-token: "MTIzNDU2Nzg5..."

# Metodos de Verificacion
setup-verification:
  - "SrCodex:Discord"
  - "Admin:Gmail"
  - "Moderador:Telegram"

# Operadores Autorizados
authorized-operators:
  - "SrCodex:123456789012345678"
  - "Admin:admin@example.com"
  - "Moderador:987654321"
FAQ

Preguntas Frecuentes

KellyMaster es compatible con todas las versiones de Minecraft desde 1.8 hasta 1.21.x. Funciona con Spigot, Paper, Purpur y otros forks basados en Bukkit.

No son obligatorios. ProtocolLib y LuckPerms son dependencias opcionales que agregan funcionalidades adicionales (como mejor deteccion de permisos), pero el plugin funciona perfectamente sin ellos.

Si el operador no ingresa el codigo correcto dentro del tiempo limite (60 segundos por defecto), sera desconectado automaticamente del servidor y perdera sus privilegios de OP hasta que se verifique correctamente.

Si, cada operador puede tener su propio metodo de verificacion configurado en whitelist.yml. Puedes mezclar Email, Discord y Telegram segun las preferencias de cada operador.

Activa el modo desarrollador en Discord: Configuracion > Avanzado > Modo Desarrollador. Luego haz clic derecho en tu perfil o nombre de usuario y selecciona "Copiar ID". El ID es un numero de 18 digitos.

No significativamente. KellyMaster esta optimizado para tener un impacto minimo en el rendimiento. Las verificaciones y notificaciones son asincronas y no bloquean el hilo principal del servidor.

Si, KellyMaster funciona en servidores online-mode=false. Sin embargo, recomendamos usar un plugin de autenticacion adicional como AuthMe para mayor seguridad.

No hay limite. Puedes agregar tantos operadores autorizados como necesites en whitelist.yml, cada uno con su propio metodo de verificacion.

Necesitas Ayuda?

Unete a nuestro servidor de Discord para obtener soporte directo de la comunidad y los desarrolladores.

Obtener Soporte en Discord
KellyMaster KellyMaster