Saltar al contenido
ESEN
Iniciar sesiónRegistrarse
Seguridad

Lista blanca y permisos en tu servidor de Paper

Decide quién entra en tu servidor de Paper con la lista blanca y qué puede hacer cada jugador con LuckPerms. Probada en laboratorio.

MinecraftIntermedio≈15 minRevisada el 28 oct 2026Kraslich
  • Última prueba: 28 oct 2026
  • Revisión externa: sin revisión externa
Un escudo con una marca verde entre una lista de jugadores permitidos y una tabla de permisos por grupos

Requisitos previos

  • Un servidor de Paper 26.3 ya montado que arranca.
  • Acceso a la consola del servidor.
  • Un jugador de prueba (tú o un amigo) para el paso 5.

Probado en

Probado en: Paper 26.3 (compilación 227) con Java 25 (Temurin 25.0.4.1 portátil) y LuckPerms 5.5.71, en Windows 11 Home de 64 bits, el 2026-10-28, en el equipo de kraslich. Las pruebas las hizo una IA. El cliente de Minecraft 26.3 se abrió sin cuenta y el servidor de pruebas no comprobaba las cuentas. No se ha probado con el Minecraft Launcher original ni con jugadores reales.

Comprueba que la lista blanca está activada

Con la lista blanca activada, el servidor deja conectar a los jugadores seleccionados y a los operadores, que entran aunque no estén en la lista. server.properties lo controla con «white-list=true». Escribe «whitelist on» en la consola del servidor para activarla (la consola contesta «Whitelist is already turned on» si ya lo estaba) y «whitelist list» para ver a quién deja entrar.

Consola del servidor (recorte): «whitelist on» contesta «Whitelist is already turned on» y «whitelist list» enseña dos jugadores; el nombre de una cuenta real está difuminado
text
whitelist on
whitelist list

Según la documentación de docs.papermc.io (se abre en otra pestaña) · consultada el 28 oct 2026 · https://minecraft.wiki/w/Commands/whitelist (; observado en laboratorio).

Añade y quita jugadores de la lista blanca

Escribe «whitelist add NombreJugador» para añadir un jugador a la lista. No hace falta que esté conectado. Escribe «whitelist list» para comprobar quién está en la lista y «whitelist remove NombreJugador» para quitarlo. Si editas whitelist.json a mano, «whitelist reload» vuelve a leer el fichero. La consola confirma con «Added NombreJugador to the whitelist» y «Removed NombreJugador from the whitelist». Quien no está en la lista y no es operador ve «You are not whitelisted on this server!» al intentar entrar.

Consola del servidor (recorte): «whitelist add AmigoPrueba» lo añade, la lista pasa a tres jugadores (un nombre real está difuminado) y «whitelist remove AmigoPrueba» lo quita
Juego (cliente de pruebas de Minecraft 26.3 sin cuenta): al entrar sin estar en la lista sale «You are not whitelisted on this server!» (captura del 2026-10-27, misma versión de Paper y de cliente)
text
whitelist add NombreJugador
whitelist list
whitelist remove NombreJugador
NotaCon enforce-whitelist en true, el servidor expulsa a los jugadores que no estén en la lista. En las pruebas estaba en false y no se comprobó la expulsión.

Según la documentación de minecraft.wiki (se abre en otra pestaña) · consultada el 28 oct 2026 · (; observado en laboratorio el 2026-10-27 y el 2026-10-28).

Haz operador solo a quien de verdad lo necesite

Escribe «op NombreJugador» para conceder el estatus de operador. La consola contesta «Made NombreJugador a server operator». El servidor lo guarda en ops.json con el nivel que marca op-permission-level en server.properties. Escribe «deop NombreJugador» para quitárselo y la consola confirma «Made NombreJugador no longer a server operator».

Consola del servidor (recorte): «op JugadorPrueba» contesta «Made JugadorPrueba a server operator»
Contenido de ops.json tras hacer operador a JugadorPrueba: uuid, name, level 4 y bypassesPlayerLimit false (el UUID es el que calcula el servidor para el nombre de prueba)
text
op NombreJugador
deop NombreJugador

Según la documentación de minecraft.wiki (se abre en otra pestaña) · consultada el 28 oct 2026 · https://minecraft.wiki/w/Operator (; observado en laboratorio).

Instala LuckPerms para repartir permisos sin hacer operador a nadie

LuckPerms es un plugin de permisos que permite controlar qué pueden hacer los jugadores creando grupos y asignando permisos. Descárgalo de su página en Modrinth: el archivo para Paper es «LuckPerms-Bukkit», y la versión probada es la 5.5.71. Copia el fichero .jar a la carpeta plugins. Detén el servidor con «stop» y vuelve a arrancarlo. Al arrancar, LuckPerms se habilita y genera su configuración. Cuando arranque, escribe «plugins»: la consola lista LuckPerms.

Consola del servidor (recorte): el comando «plugins» contesta «Server Plugins (1)» y lista LuckPerms en verde
text
stop
plugins
NotaEn las pruebas, todos los comandos de LuckPerms se escribieron en la consola del servidor.

Según la documentación de raw.githubusercontent.com (se abre en otra pestaña) · consultada el 28 oct 2026 · https://modrinth.com/plugin/luckperms (; observado en laboratorio).

Da un permiso concreto a un jugador

Un permiso es un texto separado por puntos y los de los comandos de vanilla en Paper son «minecraft.command.» más el nombre del comando. Por ejemplo, el de «time» es «minecraft.command.time» y los jugadores no lo tienen por defecto. Con «lp user NombreJugador permission set minecraft.command.time true» se lo das y con «lp user NombreJugador permission check minecraft.command.time» compruebas el resultado. Antes del permiso, si el jugador (que no es operador) escribe «/time set day» en el chat, el juego le contesta que el comando es desconocido o incompleto. Después del permiso, el mismo comando funciona. No hace falta reiniciar ni que el jugador vuelva a entrar.

Juego (cliente de pruebas sin cuenta): el jugador JugadorPrueba, que no es operador, escribe «/time set day» y el juego contesta «Comando desconocido o incompleto, revisa el error a continuación»
Consola del servidor (recorte): «lp user JugadorPrueba permission set minecraft.command.time true» y su comprobación con «permission check», que da «Resultado: true»
Juego: con el permiso dado, el mismo «/time set day» funciona y el juego contesta «Se ha establecido minecraft:overworld a la marca de tiempo minecraft:day»
text
lp user NombreJugador permission set minecraft.command.time true
lp user NombreJugador permission check minecraft.command.time

Según la documentación de docs.papermc.io (se abre en otra pestaña) · consultada el 28 oct 2026 · (; observado en laboratorio).

Reúne permisos en un grupo

En vez de dar permisos jugador a jugador, crea grupos y asígnalos a los jugadores. Todos heredan del grupo «default». «lp creategroup moderador» crea el grupo, «lp group moderador permission set minecraft.command.kick true» le da un permiso y «lp user NombreJugador parent add moderador» mete al jugador en el grupo. Después, «lp user NombreJugador info» lista los grupos padres «default» y «moderador».

Consola del servidor (recorte): «lp creategroup moderador», «lp group moderador permission set minecraft.command.kick true» y «lp user JugadorPrueba parent add moderador» con sus respuestas
Consola del servidor (recorte): «lp user JugadorPrueba info» muestra los grupos padres «default» y «moderador»
text
lp creategroup moderador
lp group moderador permission set minecraft.command.kick true
lp user NombreJugador parent add moderador
lp user NombreJugador info

Según la documentación de raw.githubusercontent.com (se abre en otra pestaña) · consultada el 28 oct 2026 · (; observado en laboratorio).

Revisa de vez en cuando quién tiene qué

«whitelist list» enseña la lista blanca. El archivo ops.json (en la carpeta del servidor) tiene los operadores. «lp group moderador permission info» enseña los permisos del grupo, con el de kick. «lp user NombreJugador info» enseña a qué grupos pertenece un jugador.

text
whitelist list
lp group moderador permission info
lp user NombreJugador info

Según la documentación de minecraft.wiki (se abre en otra pestaña) · consultada el 28 oct 2026 · https://raw.githubusercontent.com/LuckPerms/LuckPerms/master/README.md (; observado en laboratorio).

Solución de errores comunes

«You are not whitelisted on this server!»

El nombre del jugador no está en la lista. Escribe «whitelist add NombreJugador» para añadirlo.

Juego (cliente de pruebas sin cuenta): la pantalla «Error al conectar con el servidor» con «You are not whitelisted on this server!» (captura del 2026-10-27)
«Comando desconocido o incompleto, revisa el error a continuación»

Este aviso sale por dos causas. La primera es un comando mal escrito o incompleto: comprueba que lo has escrito entero. La segunda es que el jugador no tiene permiso para ese comando: el juego le contesta lo mismo. En ese caso dale el permiso «minecraft.command.» más el nombre del comando, con LuckPerms.

Juego: el aviso «Comando desconocido o incompleto, revisa el error a continuación» al escribir «/time set day» sin el permiso
«No se pudo encontrar un usuario para NombreJugador»

Mensaje de LuckPerms. En las pruebas salió en castellano. El jugador todavía no ha entrado con LuckPerms instalado o el nombre está mal escrito. Que entre una vez y repite.

Consola del servidor (recorte): «lp user NadieConocido info» contesta «No se pudo encontrar un usuario para NadieConocido»
«Nothing changed. The player is not an operator»

Se ha usado «deop» con alguien que no es operador. No hay nada que arreglar: ese jugador ya no era operador.

Lo que no se ha comprobado

Lo que no se ha comprobado: el Minecraft Launcher original, los jugadores reales y un servidor que sí compruebe las cuentas. Tampoco se han probado enforce-whitelist con un jugador ya conectado, ban, pardon, el editor web de LuckPerms ni las versiones de LuckPerms posteriores a la 5.5.71. Ninguna práctica garantiza una seguridad absoluta. El tiempo de 15 minutos es una estimación.

¿Te ha resultado útil esta guía?

Última revisión: 28 oct 2026 · Si algo ha cambiado, avísanos.