¿Por qué mis plugins no cargan o no funcionan?

¿Por qué mis plugins no cargan o no funcionan?

Si un plugin no aparece dentro del servidor o parece no funcionar, normalmente existe una razón concreta que puede encontrarse en la Console.

En esta guía te mostramos las causas más comunes y qué debes comprobar para solucionar el problema.

Causas más comunes

Comprueba los siguientes puntos en este orden:

1. El plugin está en la carpeta incorrecta.
2. El servidor utiliza un software incompatible.
3. El plugin no es compatible con tu versión de Minecraft.
4. Falta una dependencia.
5. El plugin se desactivó debido a un error.

1. Comprueba la carpeta del plugin

Los archivos .jar de los plugins deben estar directamente dentro de la carpeta:

plugins/

Por ejemplo, esta estructura es correcta:

plugins/
├── EssentialsX.jar
├── LuckPerms.jar
└── WorldEdit.jar

No debes colocar el archivo .jar dentro de una subcarpeta.

Por ejemplo, esto puede impedir que el servidor detecte el plugin:

plugins/
└── MiPlugin/
    └── MiPlugin.jar

Mueve el archivo directamente a plugins/ y reinicia el servidor.

2. Comprueba el software del servidor

Los plugins tradicionales necesitan un software compatible con la familia Bukkit.

Los principales son:

• Paper
• Spigot
• Purpur

Si tu servidor utiliza Vanilla o Forge, los plugins tradicionales no se cargarán.

¿Cómo sé qué software estoy utilizando?

Puedes comprobarlo desde la sección Versions del panel de EterHosting.

También puedes revisar las primeras líneas de la Console durante el arranque del servidor.

3. Comprueba la versión de Minecraft

Un plugin puede no funcionar si fue creado para una versión diferente de Minecraft.

Por ejemplo, si utilizas:

Minecraft 1.21.x

pero el plugin solamente es compatible con una versión mucho más antigua, puede aparecer un error durante el inicio.

En la consola puedes encontrar mensajes similares a:

Failed to load plugin

Unsupported version

Could not load plugin

Si aparece un mensaje de este tipo, revisa la página del plugin y descarga una versión compatible con tu servidor.

4. Comprueba las dependencias

Algunos plugins necesitan otros plugins o librerías para funcionar.

Por ejemplo, un plugin puede requerir:

Vault

Si Vault no está instalado, el plugin que depende de él puede no iniciarse correctamente.

La consola normalmente indicará qué dependencia falta.

Puedes encontrar mensajes similares a:

Missing dependency

Vault not found

Could not find required plugin

En ese caso, instala la dependencia indicada dentro de:

plugins/

Después, reinicia el servidor.

5. El plugin puede haberse desactivado por un error

Un plugin puede comenzar a cargarse correctamente pero desactivarse posteriormente debido a un error.

Para comprobarlo, revisa las líneas de la consola correspondientes al plugin durante el arranque.

Busca mensajes como:

Error enabling plugin

Error occurred while enabling

Disabling plugin

Exception

Normalmente, las líneas inmediatamente anteriores o posteriores contienen información sobre la causa.

¿Cómo diagnostico el problema?

Sigue estos pasos:

1. Abre la Console de tu servidor.
2. Reinicia completamente el servidor.
3. Observa las líneas que aparecen durante el arranque.
4. Busca el nombre del plugin que está dando problemas.
5. Lee el mensaje de error o advertencia.
6. Corrige el problema indicado.
7. Reinicia nuevamente el servidor.
8. Comprueba que el plugin se haya habilitado correctamente.

Comprueba el mensaje de inicio del plugin

Durante el arranque, los plugins normalmente muestran información indicando si se han habilitado correctamente.

Una carga correcta puede aparecer de forma similar a:

[PluginName] Enabling PluginName...

Si existe un problema, normalmente aparecerá un error o advertencia.

Por ejemplo:

[PluginName] Could not load plugin
[PluginName] Missing dependency
[PluginName] Error enabling plugin

Utiliza ese mensaje para identificar qué debes corregir.

¿Qué hago después de realizar un cambio?

Después de mover un plugin, actualizarlo, instalar una dependencia o cambiar cualquier configuración importante, realiza un reinicio completo.

No recomendamos utilizar:

/reload

para solucionar problemas de carga de plugins.

Comprueba que el plugin aparece en el servidor

Una vez que el servidor haya iniciado, puedes utilizar:

/plugins

para comprobar qué plugins están cargados.

Si el plugin no aparece, vuelve a revisar:

• La carpeta plugins/.
• El software del servidor.
• La versión de Minecraft.
• Las dependencias.
• La consola.

¿El plugin aparece pero sus funciones no funcionan?

Si el plugin aparece cargado pero alguna función no funciona, el problema puede estar relacionado con su configuración.

Comprueba la carpeta que el plugin haya creado dentro de:

plugins/

Por ejemplo:

plugins/
├── MiPlugin.jar
└── MiPlugin/
    └── config.yml

Revisa la documentación del plugin para comprobar que la configuración sea correcta.

¿Puede otro plugin estar causando el problema?

Sí.

Algunos plugins pueden entrar en conflicto entre ellos o modificar sistemas utilizados por otros plugins.

Si el problema comenzó después de instalar un plugin nuevo, prueba a retirarlo temporalmente y reinicia el servidor.

1. Detén el servidor.
2. Retira temporalmente el plugin sospechoso.
3. Inicia el servidor.
4. Comprueba si el problema desaparece.

Si el problema desaparece, es posible que ese plugin sea incompatible o esté entrando en conflicto con otro.

¿Qué pasa si falta una base de datos?

Algunos plugins necesitan una base de datos para almacenar información.

Esto es especialmente común en plugins que gestionan:

• Usuarios.
• Economía.
• Estadísticas.
• Permisos.
• Datos de varias instancias.
• Sistemas externos.

Si el plugin requiere MySQL o MariaDB, comprueba su documentación para conocer los datos de conexión y configuración necesarios.

No todos los plugins necesitan una base de datos externa.

Problemas habituales y soluciones

¿Cómo compartir los logs para recibir ayuda?

Si no puedes encontrar el problema, puedes compartir los logs de inicio del servidor para que sea más fácil identificar el error.

Desde la consola puedes utilizar la opción disponible para compartir los logs mediante mclo.gs, si está disponible en tu panel.

Comparte el enlace generado junto con una descripción del problema.

Esto permite revisar exactamente qué ocurrió durante el arranque del servidor.

Preguntas frecuentes

¿Por qué mi plugin no aparece?

Comprueba que el archivo .jar esté directamente dentro de plugins/ y que tu servidor utilice Paper, Spigot o Purpur.

¿Por qué el plugin aparece pero está desactivado?

Revisa la consola durante el arranque. Normalmente aparecerá un error indicando por qué el plugin se desactivó.

¿Por qué aparece "Missing dependency"?

El plugin necesita otro plugin o componente. La consola normalmente indica cuál debes instalar.

¿Por qué aparece "Failed to load"?

Puede deberse a una versión incompatible, un archivo incorrecto, dependencias faltantes u otro problema de carga.

¿Puedo instalar plugins en Vanilla?

No. Utiliza Paper, Spigot o Purpur para plugins tradicionales.

¿Puedo instalar plugins de Paper en Forge?

No directamente. Forge utiliza principalmente mods, mientras que los plugins tradicionales utilizan la API Bukkit.

¿Debo usar /reload después de instalar un plugin?

No. Es preferible realizar un reinicio completo del servidor.

¿Qué hago si sigo sin encontrar el problema?

Comparte los logs de inicio del servidor y revisa los mensajes de error relacionados con el plugin.

Proceso recomendado de diagnóstico

Resumen

Panel de EterHosting

Puedes administrar tus plugins, archivos, versiones y consola desde el panel de EterHosting:

panel.eterhosting.net