Whitelist en tu servidor de Minecraft: haz que solo entren tus amigos

La whitelist de un servidor de Minecraft (lista blanca) es la lista de los únicos jugadores que pueden entrar. Si activas la whitelist en tu servidor de Minecraft con whitelist on y agregas a cada amigo con whitelist add Nombre, cualquier otra persona se queda afuera. Aquí tienes los comandos, el archivo whitelist.json, la diferencia entre white-list y enforce-whitelist, cómo meter a tus amigos de Bedrock que entran por Geyser y cómo quitar el famoso «¡No estás en la lista blanca del servidor!».

Todo aplica a servidores de Java Edition con Vanilla, Paper, Purpur u otro fork de Paper. Casi al final hay una sección corta para Bedrock Dedicated Server, que usa allowlist en vez de whitelist.

Cómo funciona la whitelist de un servidor de Minecraft

Cuando alguien se conecta, el servidor compara su UUID (el identificador único de su cuenta de Minecraft) con la lista guardada en whitelist.json, en la carpeta principal del servidor. Si el UUID no está, no entra. Según la Minecraft Wiki, hay tres cosas que conviene saber:

• Los operadores siempre entran. En Java Edition, un OP se puede conectar aunque no esté en la lista. En Bedrock es al revés: todos, OP incluidos, tienen que estar en la allowlist.
• La lista guarda UUID, no nombres. Si tu amigo se cambia el nombre de usuario, sigue en la lista. Por eso también importa online-mode=true: así el servidor busca bien a qué cuenta pertenece cada nombre.
• El valor por defecto cambió en 2026. Desde Java Edition 26.3, white-list viene en true en un server.properties nuevo. En versiones anteriores empieza en false, así que revisa el tuyo antes de dar algo por hecho.

Cómo hacer tu servidor solo para amigos, paso a paso

Si tu servidor ya está corriendo, son dos minutos. Si todavía no tienes uno, empieza por cómo crear un servidor de Minecraft Java y regresa aquí.

1. Abre la consola del servidor. En TheGameHosting entras a tu servidor en el panel y abres Console. Lo que escribes ahí corre con todos los permisos y va sin diagonal (/).
2. Escribe whitelist add TuNombre para agregarte primero, con tu nombre exacto de Java.
3. Agrega a cada amigo con whitelist add NombreDeTuAmigo. No hace falta que esté conectado.
4. Escribe whitelist on para activar la lista.
5. Escribe whitelist list y revisa que estén todos y bien escritos.
6. Abre server.properties y confirma que diga white-list=true, para que siga activa después de reiniciar. Agrega enforce-whitelist=true si además quieres sacar a los que ya estén dentro y no aparezcan en la lista.

whitelist add TuNombre
whitelist add NombreDeTuAmigo
whitelist on
whitelist list

Agregarte antes de activar la lista es buena costumbre. Como OP entras de todos modos, pero si algún día te quitas el OP, te quedarías afuera de tu propio mundo.

Comandos de whitelist en Minecraft

Todos piden nivel de permiso 3, así que dentro del juego solo los puede usar un operador, con diagonal (/whitelist add Steve). En la consola van sin diagonal. Si todavía no eres OP, revisa cómo darte OP en un servidor de Minecraft.

La consola del servidor responde en inglés aunque tu juego esté en español: «Added Nombre to the whitelist» al agregar, «Player is already whitelisted» si el nombre ya estaba y «Whitelist is already turned on» si la lista ya estaba activa.

white-list y enforce-whitelist: cuál es la diferencia

Las dos opciones están en server.properties y es muy común confundirlas.

Sin enforce-whitelist, si quitas a alguien con whitelist remove, sigue jugando hasta que se desconecte; lo que ya no puede es volver a entrar. Con enforce-whitelist=true, la documentación de PaperMC dice que el jugador que no está en la lista se va expulsado cuando activas la whitelist o cuando lo quitas de ella, y la Minecraft Wiki agrega que también pasa al recargar el archivo. Si vas a cerrar un servidor que antes era público, activa las dos.

El servidor lee server.properties al arrancar, así que reinicia después de editarlo.

white-list=true
enforce-whitelist=true
online-mode=true

Editar whitelist.json a mano

whitelist.json está en la raíz de la carpeta del servidor, junto a server.properties y ops.json. Cada jugador lleva su uuid (con guiones) y su name:

[
  {
    "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
    "name": "Notch"
  }
]

Editarlo a mano sirve cuando pasas la lista de un servidor viejo o quieres pegar a muchos jugadores de un jalón. Dos reglas: que el JSON quede válido (coma entre jugadores, sin coma después del último) y que corras whitelist reload en la consola al terminar, porque el servidor tiene la lista en memoria y no se entera de los cambios hasta que la recargas. Si no sabes el UUID de alguien, mejor usa whitelist add Nombre y deja que el servidor lo llene.

En TheGameHosting editas el archivo en la pestaña Files del panel, guardas y escribes whitelist reload en Console. Sin programas de FTP.

«¡No estás en la lista blanca del servidor!»: cómo arreglarlo

Es el mensaje que ve un jugador cuando la whitelist está activa y su cuenta no aparece. Si tu amigo juega en inglés verá «You are not white-listed on this server!», y en servidores Paper o Spigot el texto es «You are not whitelisted on this server!», que puedes cambiar en messages.whitelist dentro de spigot.yml. Revisa estas causas en orden:

1. No está en la lista. Corre whitelist list. Si no aparece, whitelist add Nombre.
2. El nombre se escribió mal. La lista guarda el UUID de la cuenta que escribiste. Con un error de dedo puedes agregar otra cuenta o ninguna. Quita la entrada mala y agrega el nombre exacto.
3. Editaste el archivo y no recargaste. Los cambios en whitelist.json no cuentan hasta que corres whitelist reload o reinicias.
4. El JSON quedó roto. Una coma o un corchete de más dejan el archivo ilegible. Revisa los errores de la consola al arrancar y corrige el archivo en Files.
5. Juega en Bedrock. Si entra por Geyser, su nombre y su UUID son otros. Mira la siguiente sección.
6. El servidor es no premium. Con online-mode=false, el servidor busca un UUID offline creado a partir del nombre, así que lo que agregaste en modo online no coincide.

Si solo quieres que todos vuelvan a entrar, whitelist off quita la restricción al instante. Revisa también que server.properties diga white-list=false, para que la lista no regrese al reiniciar.

Si tu amigo no llega ni a ver ese mensaje y la conexión simplemente falla, el problema es de conexión, no de whitelist.

Agregar jugadores de Bedrock a la whitelist con Floodgate

Si tu servidor de Java deja entrar a tus amigos de celular y consola con Geyser y Floodgate, esos jugadores no tienen cuenta de Java, así que el whitelist add normal no los encuentra. Floodgate trae su propio comando: la wiki de GeyserMC indica que fwhitelist es el que se usa para agregar o quitar jugadores de Floodgate en whitelist.json.

fwhitelist add GamertagDeBedrock
fwhitelist remove GamertagDeBedrock

• No escribas el prefijo. Floodgate le pone uno a los nombres de Bedrock (un punto por defecto, se cambia con username-prefix en su config.yml), pero fwhitelist lo resuelve solo.
• También puedes agregar a alguien por su UUID de Floodgate, por ejemplo fwhitelist add 00000000-0000-0000-0009-01f64f65c7c3.
• Para que alguien del staff sin OP lo use, el permiso es floodgate.command.fwhitelist.

Si todavía no tienes Geyser, primero sigue cómo instalar Geyser y Floodgate.

¿Tu servidor es Bedrock Dedicated Server?

Un servidor Bedrock puro le dice allowlist. La opción es allow-list en server.properties, el archivo es allowlist.json y el comando es allowlist add Nombre. En Bedrock no existen on ni off como subcomandos, y los operadores también tienen que estar en la lista.

Whitelist en un servidor no premium

Con online-mode=true (el valor por defecto), cada jugador se verifica con los servidores de cuentas de Minecraft, así que el nombre que pusiste en la lista de verdad es de esa cuenta. Con online-mode=false, la whitelist compara un UUID offline que sale del nombre de usuario. Cualquiera que escriba ese mismo nombre en un launcher no oficial obtiene el mismo UUID, y la lista deja de ser un candado. La Minecraft Wiki recomienda el modo offline solo para servidores que no están conectados a internet. Si aun así lo estás pensando, lee servidor de Minecraft no premium antes de cambiarlo.

Tu servidor privado, prendido 24/7 con TheGameHosting

La whitelist deja afuera a los desconocidos, pero solo sirve mientras el servidor está prendido. Si lo corres en tu PC, el mundo se cierra cuando la apagas y además tienes que abrir puertos en tu módem para que tus amigos entren. En TheGameHosting el servidor corre en nuestro hardware en Dallas o Ámsterdam, con CPU AMD 9950X o 7950X3D y discos NVMe, así que sigue en línea con tu PC apagada y no tocas el módem.

Todo lo de esta guía se hace en un solo panel: Console para los comandos de whitelist, Files para editar whitelist.json y server.properties, y Backups para guardar una copia antes de mover algo. Con Users le das acceso al panel a tu socio del servidor sin pasarle tu cuenta. La protección DDoS viene en todos los planes y no cobramos por slot de jugador. Los planes empiezan en $1.90 USD al mes en la página de hosting de Minecraft, y puedes comparar todos los tamaños de RAM en nuestros planes de servidores de juegos.

Tu servidor queda listo en unos 60 segundos después del pago. Elige tu plan en Precios, agrega a tus amigos con whitelist add y comparte la dirección y el puerto que te muestra el panel solo con ellos.

Preguntas frecuentes

Hosting para este juego

• Hosting para MinecraftUn plan, más de 60 juegos · desde $1.90 USD/mes