Actualiza LuckPerms con el archivo para la plataforma en la que el plugin se ejecuta realmente. Una descarga de Velocity no corresponde a un servidor Paper. Antes, guarda una copia de seguridad de los datos de permisos y de la configuración, y después de la actualización comprueba con una cuenta normal de jugador si los grupos y permisos siguen funcionando igual.
Determinar la plataforma y la ubicación
Primero anota dónde está instalado LuckPerms: en el servidor de Minecraft, en el proxy o en varios componentes. Revisa en el log la plataforma iniciada y la versión. No te fíes solo del nombre de archivo de un JAR que se subió en algún momento.
Después, comprueba el almacenamiento configurado para los permisos. Si usas una base de datos externa, los datos principales no tienen por qué estar en la carpeta del plugin. Por eso, una simple copia de seguridad de archivos de esa carpeta puede estar incompleta. Trata los datos de acceso de la configuración de forma confidencial y no los pegues en informes de errores públicos.
Backup antes del reemplazo
Haz una copia de seguridad del archivo actual del plugin, de la configuración y del conjunto de datos de permisos que se usa realmente. Para los datos, utiliza un proceso adecuado de exportación o backup de base de datos y comprueba que puedes volver a leer la copia. Anota la hora y qué servidores o proxys usan el mismo conjunto de datos.
Para una prueba pequeña bastan ejemplos documentados de antemano: un jugador normal sin permisos especiales, un miembro de un grupo con nombre y una cuenta con un permiso adicional concreto. Anota el comportamiento esperado. No concedas permisos wildcard globales ni permisos OP generales para la prueba; con eso ocultarías errores de permisos.
Actualización en una ventana de mantenimiento
- Elige la descarga para tu plataforma real desde la página oficial de LuckPerms.
- Revisa los requisitos indicados allí y las notas sobre el cambio desde tu versión actual.
- Apaga correctamente el componente de servidor o proxy afectado.
- Sustituye el archivo del plugin; mantén la configuración y el almacenamiento de datos, salvo que la guía concreta de actualización exija una migración.
- Inicia el componente y revisa el log por si hay errores de carga o almacenamiento.
- Prueba los casos de permisos documentados previamente.
Si tienes varios componentes, actualízalos de forma controlada y documenta sus versiones. No deduzcas de una nueva build del proxy una instrucción general de actualización para todos los servidores de Minecraft.
Comprobar el resultado
No pruebes únicamente con tu cuenta de administrador. Comprueba con un jugador normal si los comandos permitidos siguen funcionando y las acciones prohibidas siguen siendo rechazadas. Si usas permisos distintos por servidor o mundo, repite la prueba exactamente en esos contextos.
Que el servidor arranque en verde no basta: el servidor puede estar accesible mientras una conexión de base de datos o una regla de permisos se comporta de forma distinta a la esperada. Anota la plataforma, la versión del plugin, el resultado de la prueba y, si procede, el primer mensaje de error relevante.
Ruta segura de vuelta
Si aparecen permisos inesperados, detén más cambios administrativos y revisa primero el archivo de plataforma y la conexión de almacenamiento. Usa los datos guardados para una prueba de restauración controlada. No restaures a ciegas un estado antiguo de la base de datos si, mientras tanto, otros servidores han escrito cambios correctos en el mismo conjunto de datos.
FAQ
¿El último archivo publicado siempre es el correcto? No. La plataforma, los requisitos y las notas concretas de la release tienen que encajar.
¿Basta la carpeta del plugin como backup? Solo si también contiene por completo el conjunto de datos usado realmente. Comprueba la conexión de almacenamiento.
¿Tengo que volver a crear los permisos después de cada actualización? Una actualización normal no es motivo para reconstruir tus grupos por precaución. Revisa primero los datos y los mensajes de error.