Resolución de problemas
Errores comunes por plataforma
Errores al usar un resultado de Codexe: plugins que no cargan, mods que se cierran, datapacks sin efecto, errores de Skript y por qué los mods para Java 17 usan Java 21.
Actualizado
En esta página
#Plugins
| Síntoma | Solución |
|---|---|
El plugin no aparece en /plugins | Busca el nombre del plugin en el registro de arranque. "Invalid plugin.yml" o "main class not found" significa que el descriptor es incorrecto: pide en el chat que corrija plugin.yml. |
| "Unsupported API version" | El plugin se compiló para una API de Minecraft más reciente que la de tu servidor. Indica la versión de tu servidor y pide que se vuelva a compilar para ella. |
NoClassDefFoundError que menciona otro plugin | No está instalada una dependencia (Vault, PlaceholderAPI, …). |
Funciona tras reiniciar, pero se rompe tras /reload | Muchos plugins no admiten /reload. Reinicia el servidor en su lugar. |
#Mods
| Síntoma | Solución |
|---|---|
| El juego se cierra en un servidor dedicado | Hay código solo de cliente en el código común o principal. Pide en el chat que separe el código de cliente. |
| "Incompatible mod set" / versión del juego incorrecta | El mod apunta a otra versión de Minecraft o del cargador. Indica las dos de forma explícita. |
| Falta una dependencia al arrancar (Fabric) | Instala Fabric API (y cualquier otra dependencia indicada) en mods/. |
#¿Por qué mi mod se compila con Java 21 si apunta a Java 17?
En las versiones de Minecraft anteriores a la 1.20.5, un mod apunta a Java 17. Sin embargo, la herramienta de compilación de Fabric (Loom) solo funciona con Java 21 o superior. Codexe ejecuta Gradle con Java 21 pero sigue compilando tu mod para Java 17, así que el JAR funciona en un servidor o cliente con Java 17. Es lo esperado, y por eso el registro de compilación de un proyecto Fabric 1.20.1 menciona Java 21.
#Datapacks
| Síntoma | Solución |
|---|---|
/datapack list no lo muestra | El ZIP debe contener pack.mcmeta en su nivel superior, dentro de world/datapacks/. |
| Se carga, pero una receta o una función no hace nada | El pack_format o los nombres de las carpetas no son los de tu versión. Indica tu versión exacta de Minecraft. |
#Skript
| Síntoma | Solución |
|---|---|
Errores de análisis con /sk reload | Normalmente falta un add-on. Comprueba qué add-ons usa el script (pregunta en el chat si no estás seguro) e instálalos. |
No existe una expresión como player's balance | Instala Vault y un plugin de economía. |
#Bots de Discord
Consulta Bots de Discord: problemas comunes.