Teramont DocsTeramont Docs

Como usar la Whitelist

Aprende a gestionar el acceso privado a tu servidor y solucionar problemas comunes.

La Whitelist (Lista Blanca) es el sistema nativo de Minecraft para restringir el acceso a tu servidor. Cuando está activada, solo los jugadores que tú añadas explícitamente podrán unirse; el resto será rechazado automáticamente.

Es ideal para servidores privados de amigos, SMPs técnicos o comunidades cerradas.

1. Comandos Básicos

Puedes ejecutar estos comandos desde la Consola de tu panel de control (sin usar /) o dentro del juego si eres operador (usando /).

AcciónComandoDescripción
Activarwhitelist onEnciende la lista blanca. Nadie fuera de la lista podrá entrar.
Desactivarwhitelist offApaga la lista blanca. El servidor se vuelve público.
Añadirwhitelist add JugadorAutoriza a un usuario para entrar.
Eliminarwhitelist remove JugadorRevoca el acceso a un usuario.
Listarwhitelist listMuestra quiénes están autorizados actualmente.
Recargarwhitelist reloadFuerza al servidor a leer de nuevo el archivo whitelist.json (útil si lo editaste manualmente).

2. Gestión desde el Panel (Recomendado)

La forma más segura de gestionar la whitelist es directamente desde la Consola de tu panel Teramont.

  1. Ve a la pestaña Console.
  2. Escribe whitelist add NombreDeTuAmigo y presiona Enter.
  3. Verás un mensaje confirmando: Added NombreDeTuAmigo to the whitelist.

Añadir a la whitelist desde la consola


Whitelist en Servidores "No Premium" (Offline)

Si tu servidor está configurado en online-mode=false (No Premium), debes tener mucho cuidado con cómo funciona la whitelist.

El problema de seguridad

En servidores No Premium, Minecraft no verifica la identidad real del jugador. La whitelist solo comprueba el nombre de usuario.

  • Ejemplo: Si añades a Vegetta777 a la whitelist, cualquier persona que se configure ese nombre en su launcher pirata podrá entrar a tu servidor.

Riesgo de Suplantación

En servidores No Premium, la whitelist NO sirve como seguridad única. Es obligatorio usar un plugin de autenticación (como NLogin) junto con la whitelist. De lo contrario, cualquiera puede ponerse el nombre de un usuario permitido y entrar a destruir tu servidor.

Problema de UUIDs

Si cambias tu servidor de Premium a No Premium (o viceversa), los códigos de identificación (UUID) de los jugadores cambiarán. Esto hará que la whitelist "olvide" a los usuarios antiguos y tendrás que añadirlos de nuevo.


Solución de problemas (FAQ)

"Añadí a mi amigo pero no puede entrar"

  1. Revisa el nombre: Asegúrate de haber escrito el nombre exactamente igual, respetando mayúsculas y minúsculas (aunque Minecraft suele ser flexible, algunos plugins no lo son).
  2. Espacios en el nombre: Si el nombre tiene espacios (común en Bedrock/No Premium), intenta ponerlo entre comillas: whitelist add "Nombre Con Espacio".
  3. Recarga: Ejecuta whitelist reload para asegurarte de que el servidor guardó el cambio.

"Soy OP y no estoy en la whitelist"

Por defecto, los operadores (OPs) pueden entrar al servidor aunque no estén en la whitelist. Esto es normal y es una medida de seguridad para que los dueños no se queden fuera.

"La whitelist se desactiva sola"

Esto suele ocurrir si tienes otro plugin que gestiona el acceso (como LuckPerms, WorldGuard o plugins de BungeeCord). Revisa si algún plugin está forzando la entrada de jugadores.

Mensaje "You are not white-listed on this server"

Si un jugador ve esto, significa que la whitelist funciona correctamente pero él no está en ella.

  • Solución: Revisa la consola. Cuando intenta entrar, aparecerá su nombre exacto y su UUID. Copia ese nombre y usa whitelist add con él.

Last updated on

En esta página