Guía

Cómo corregir errores de plugins de Minecraft

Actualizado el 18 de octubre de 2026

Cuando un plugin no carga, el servidor casi siempre dice por qué: el motivo está en la consola durante el arranque, unas líneas por encima o por debajo del nombre del plugin. Aprende a leer esa parte del registro y la mayoría de los errores se corrigen en un minuto. Estos son los habituales y lo que significan.

Indica la versión de tu servidor y lo que debe hacer el plugin.

Genera esto con Codexe

Paso a paso

1.Abre el registro del arranque
Lee la consola o logs/latest.log en la carpeta del servidor. En un panel de hosting, usa su consola o su gestor de archivos.
2.Busca el nombre del plugin
Encuentra el primer error que lo menciona. Las líneas que empiezan por [ERROR] o [WARN], con un stack trace debajo, son las que importan.
3.Lee la primera línea y las de «Caused by»
La primera línea dice qué falló; la última línea Caused by: suele decir por qué. Las líneas con el nombre del paquete del propio plugin muestran en qué parte de su código.
4.Búscalo en la lista de abajo
La mayoría de los errores de arranque son un problema de versión, de Java o de dependencias, y el mensaje dice cuál.
5.Corrige una sola cosa y reinicia
Cambia una sola cosa, reinicia (no uses /reload) y vuelve a leer el registro. Los errores de un plugin pueden causar errores en otros.

Los errores habituales

Ves	Qué significa	Solución
`Unsupported API version 1.21`	El `api-version` del plugin es más nuevo que tu servidor.	Consigue la versión para tu servidor o actualiza el servidor.
`Could not load 'plugins/X.jar'` con `Invalid plugin.yml` o `Jar does not contain plugin.yml`	Falta el descriptor del plugin o tiene un error de YAML, o el archivo no es un plugin.	Comprueba que descargaste el plugin y no su código fuente, un mod o un zip. Si lo compilaste tú, corrige `plugin.yml`.
`UnsupportedClassVersionError`, «class file version 65.0»	El plugin necesita un Java más nuevo que el del servidor (61 = Java 17, 65 = Java 21, 69 = Java 25).	Ejecuta el servidor con ese Java o vuelve a compilar el plugin para tu Java.
`NoClassDefFoundError` o `ClassNotFoundException`	Falta una clase que el plugin necesita: falta un plugin del que depende, una librería no se empaquetó en el .jar o la API no existe en esta versión.	Instala el plugin que nombra el error (Vault, ProtocolLib) o usa una compilación para tu versión.
`Unknown/missing dependency plugins`	No está instalado un plugin indicado en `depend`.	Instálalo en `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	El plugin se cargó pero falló en `onEnable`.	Lee la línea `Caused by`: a menudo es un error de configuración o una dependencia que falta.
`Ambiguous plugin name`	Hay dos archivos .jar del mismo plugin en `plugins/`.	Borra el antiguo.

Errores que no tienen que ver con la carga

El plugin está en verde pero un comando dice «Unknown command»: el comando falta en plugin.yml u otro plugin usa el mismo nombre.
«I'm sorry, but you do not have permission»: al jugador le falta el nodo de permiso. Busca el nodo en la página del plugin y dáselo con tu plugin de permisos.
Errores después de editar config.yml: YAML necesita espacios, no tabulaciones, y comillas alrededor del texto que empieza por : o &.
Funciona tras un reinicio y se rompe tras /reload: el plugin no admite /reload. Reinicia en su lugar.

Qué Java necesita tu servidor

Minecraft 1.20.5 y posteriores necesitan Java 21, y la 26.x necesita Java 25; de la 1.18 a la 1.20.4 necesitan Java 17. Ejecuta java -version con el mismo Java que usa el servidor (en un panel de hosting suele ser un ajuste llamado imagen de Docker o versión de Java). Un plugin compilado para un Java más antiguo funciona en uno más nuevo, pero no al revés.

Corregir plugins hechos con Codexe

Los plugins hechos en Codexe se compilan para la versión que elegiste y se comprueba que tengan un plugin.yml válido antes de estar Listos. En un servidor de prueba, la pestaña Registros muestra el registro en directo con los errores resaltados, y Exportar registros lo guarda como archivo. Describe lo que ves en el chat del proyecto («el plugin sale en rojo en /plugins y el registro dice ...») y Codexe cambia el código y vuelve a compilar. Si Compilar falla con los archivos tal como los entregó Codexe, Corregir con IA los repara gratis.

Preguntas

¿Dónde está el registro del servidor?

logs/latest.log en la carpeta del servidor, para la ejecución actual. Las ejecuciones anteriores están en la misma carpeta como archivos .log.gz.

¿Puede un plugin romper otro?

Sí: una dependencia que falta o está rota detiene todos los plugins que la necesitan. Corrige el primer error del registro antes que los demás.

¿Es seguro compartir mi registro?

En general sí, pero revísalo antes: los registros pueden contener direcciones IP y, con algunos plugins, contraseñas de bases de datos que aparecen en los errores.

Vuelve a crear un plugin roto para tu servidor

Este prompt se abre listo para enviar:

“Un plugin para Paper 1.21.4 llamado SimpleWarps que sustituya al antiguo, que ya no carga: /setwarp, /warp y /delwarp con un nombre, /warps los lista en una GUI, permiso warps.admin para crearlos y borrarlos, warps que se conservan tras los reinicios, mensajes en config.yml.”