Complementos en servidores de Minecraft; Opera el sistema de autorización, economía, protección, mercado, evento, reclamo, anti-trampas y muchos sistemas especiales. Si uno de los complementos no está instalado, es posible que una parte importante del servidor no funcione.

Los errores de complementos generalmente ocurren en la consola o registros/último.log aparece en el archivo. Los errores más comunes; No se pudo cargar el complemento, Versión de API no compatible, dependencia desconocida, Complemento.yml no válido e incompatibilidades de versiones de Java.

1. ¿Dónde puedes ver el error del complemento?

Si el complemento no se carga, el primer lugar donde buscar es la consola del servidor y el archivo Latest.log.

tail -n 200 logs/latest.log

Para seguimiento en vivo:

tail -f logs/latest.log

Para buscar por nombre de complemento:

grep -i "pluginadi" logs/latest.log

2. Error de versión de API no compatible

Este error indica que la versión de la API de Minecraft admitida por el complemento no es compatible con la versión del servidor.

Unsupported API version 1.20

Por ejemplo, es posible que el complemento esté preparado para 1.20, pero que su servidor esté ejecutando 1.16.5. En este caso, es posible que el complemento no se cargue o funcione incorrectamente.

Solución:

• Verifique la versión de Minecraft compatible con el complemento.
• Descargue la versión del complemento compatible con la versión de su servidor.
• No espere que los nuevos complementos funcionen en servidores muy antiguos.
• Si es necesario, busque la versión adecuada en el archivo de la versión anterior del complemento.

3. Error de dependencia desconocida

Algunos complementos no funcionan solos. Primero solicita que se instale otro complemento. Esto se llama dependencia.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

Por ejemplo, los complementos económicos a menudo Bóveda si... o. Los complementos de autorización o de mercado también pueden necesitar otros complementos de biblioteca.

Solución:

• Lea los requisitos en la página del complemento.
• Descargue el complemento de dependencia que falta.
• Asegúrese de que el complemento de dependencia también sea compatible con la versión de su servidor.
• Reinicie el servidor por completo.

4. Error de plugin.yml no válido

Dentro del archivo jar del complemento complemento.yml Si el archivo está dañado, falta o es incorrecto, no se podrá instalar el complemento.

Invalid plugin.yml
Plugin does not contain a plugin.yml

Esto suele ocurrir cuando:

• Se descargó el archivo incorrecto.
• En lugar del complemento, el código fuente zip se colocó en la carpeta de complementos.
• El archivo jar está dañado.
• El desarrollador empaquetó incorrectamente el complemento.

Como solución, el complemento es correcto. .frasco El archivo debe descargarse. El código fuente.zip descargado de GitHub no debe colocarse directamente en la carpeta de complementos.

5. Incompatibilidad de la versión de Java

La versión y los complementos de Minecraft requieren versiones específicas de Java. Si se utiliza una versión incorrecta de Java, es posible que el complemento o el servidor no se abra en absoluto.

java -version

Error común:

UnsupportedClassVersionError

Este error indica que el complemento se compiló con Java más nuevo, pero se utiliza Java más antiguo en el servidor.

Lógica general:

• Las versiones anteriores de Minecraft suelen requerir Java más antiguo.
• Las versiones más nuevas de Minecraft requieren Java más nuevo.
• Se debe verificar el requisito de Java en la descripción del complemento.
• Se debe verificar la versión de Java seleccionada en el panel de hosting.

6. ¿Está el archivo del complemento en la carpeta correcta?

Archivos de complemento en los servidores Bukkit, Spigot y Paper complementos se arroja a la carpeta.

ls plugins/

El archivo del complemento debería ser así:

plugins/PluginAdi.jar

Los complementos que se dejan en zip, rar, código fuente o carpetas a menudo no funcionan.

7. Conflictos de complementos

Dos complementos que hacen el mismo trabajo pueden entrar en conflicto entre sí. Por ejemplo, dos complementos de chat diferentes, dos complementos económicos diferentes o dos sistemas de reclamos diferentes pueden intentar gestionar los mismos eventos.

Síntomas de conflicto:

• El complemento está instalado pero sus comandos no funcionan.
• Un complemento abruma la configuración de otro.
• Se produce un conflicto de eventos o una excepción en la consola.
• Los jugadores no pueden usar comandos incluso si tienen permiso.
• El servidor se comporta de manera diferente después del reinicio.

Para encontrar una solución, se pueden probar los complementos deshabilitándolos uno por uno. Sin embargo, antes de hacer esto en el servidor en vivo, se debe hacer una copia de seguridad y se debe preferir pocas horas de juego.

8. Un error de configuración puede impedir que se abra el complemento

Algunos complementos no se abrirán si hay un error YAML en el archivo de configuración. Las sangrías de espacios en blanco son especialmente importantes en los archivos YAML.

Errores comunes:

• Usando el carácter de tabulación
• No dejes un espacio después de los dos puntos.
• Escribir texto que requiera comillas sin comillas
• Corrupción de archivos debido a caracteres turcos o símbolos especiales
• Guardando el archivo de configuración que falta

Si hay un archivo de configuración incorrecto, se puede cambiar el nombre de la carpeta del complemento temporalmente para hacer una copia de seguridad de la carpeta del complemento y recrear la configuración.

Errores comunes

• Instalar complementos que no son compatibles con la versión del servidor
• No instalar complementos de dependencia faltantes
• Confundir el archivo zip fuente de GitHub con un complemento
• No comprobar la versión de Java
• Intentando instalar un complemento con /reload
• Usar pestañas en archivos de configuración YAML

Preguntas frecuentes

El complemento está en la carpeta de complementos pero no funciona, ¿por qué?
Podría ser incompatibilidad de versión, dependencia faltante, incompatibilidad de Java o error de configuración. Se debe examinar el archivo Latest.log.

¿Qué significa UnsupportedClassVersionError?
El complemento acaba de compilarse con Java. La versión de Java utilizada en el servidor está desactualizada.

¿Es seguro usar/recargar?
No se recomienda para muchos complementos. Un reinicio completo es más seguro para la instalación y eliminación de complementos y cambios importantes de configuración.

Recomendaciones de seguridad y operaciones

• Descargue complementos de fuentes confiables.
• Antes de agregar el complemento al servidor en vivo, pruébelo en el servidor de prueba.
• Haga una copia de seguridad de la carpeta de complementos antes de cada actualización de complementos.
• Reduzca la superficie de ataque eliminando complementos innecesarios.
• Verifique los registros de complementos con regularidad.

Este artículo está especialmente preparado para PvPServer.