Descripción general

Publicado v1.2.1

Plataformas

Paper, Purpur, Spigot, Folia

Minecraft

1.21 a 1.21.11, 26.1, 26.2

Java

21

Obligatorio

Ninguno

Opcional

Ninguno

Analizador real de compatibilidad de plugins a nivel de bytecode para servidores Paper/Spigot. PluginGuard no adivina a partir de una base de datos en línea ni de una comparación de cadenas de versión: abre cada jar de tu carpeta plugins/ e inspecciona los bytes reales: la versión del archivo de clase compilado, los metadatos declarados en plugin.yml/paper-plugin.yml, las bibliotecas incluidas o empaquetadas con shade, los binarios nativos incrustados y el grafo de dependencias entre los plugins que tienes instalados. No se ejecuta nada y no se modifica nada: PluginGuard solo lee.

Por qué existe #

Cada una de las comprobaciones siguientes modela una forma real y concreta en que un plugin puede romperse en silencio y que un verificador que se limite a «ver si el número de versión parece correcto» pasará por alto:

• Un plugin se actualiza y ahora está compilado para una versión de Java más nueva que la que ejecuta tu servidor; no solo se comportará mal, sino que la JVM se negará de plano a cargar la clase (UnsupportedClassVersionError) y el plugin no se activará, con un confuso seguimiento de pila.
• Un plugin incluye con shade el controlador JDBC de SQLite y reubica el paquete org.sqlite durante la compilación (un error de shading muy habitual); el enlace JNI nativo se basa en nombres, así que esto se rompe en silencio en tiempo de ejecución con UnsatisfiedLinkError la primera vez que el plugin toca su base de datos, a menudo mucho después de que el servidor llevara funcionando sin problemas.
• Dos plugins declaran el mismo nombre de comando en su plugin.yml: solo uno de ellos es realmente dueño del comando sin prefijo; el otro recurre discretamente a su forma calificada /plugin:command y los administradores pasan una hora preguntándose por qué un comando «no funciona».
• Un plugin declara una dependencia obligatoria que no está instalada o que se eliminó en una actualización posterior: no se activará y el motivo real queda enterrado en un mensaje de registro de una sola línea fácil de pasar por alto en un registro de arranque largo.

Instalación #

1. Copia PluginGuard.jar en tu carpeta plugins/.
2. Inicia (o reinicia) tu servidor. PluginGuard tiene cero dependencias obligatorias y no requiere configuración: config.yml y los archivos de idioma de lang/ (en, tr, es, de, fr, ru) se crean automáticamente con valores razonables y ejecuta su primer análisis automáticamente 5 segundos después del arranque, salvo que lo desactives.
3. Lee la salida de la consola (o ejecuta /pluginguard scan tú mismo en cualquier momento).

Compatibilidad #

• Minecraft 1.21 hasta 1.21.11, además de 26.1 y 26.2. Java 21 o superior. Paper, Spigot, forks compatibles con Paper y Folia.
• PluginGuard compara los plugins con la versión de Java y de la API que informa el servidor, así que también comprueba correctamente cuando el servidor ejecuta una versión más reciente de Minecraft/Java.

Soporte #

Usa la pestaña de Discusión de la página oficial del recurso en BuiltByBit o los mensajes directos de BuiltByBit para las solicitudes de soporte y los informes de errores.