Troubleshooting
Common platform errors
Fixes for errors when running a Codexe result: plugins not loading, mod crashes, datapacks not applying, Skript parse errors, and why mods build with Java 21 for Java 17.
Updated
On this page
#Plugins
| Symptom | Fix |
|---|---|
Plugin missing from /plugins | Check the startup log for the plugin's name. "Invalid plugin.yml" or "main class not found" means the descriptor is wrong: ask the chat to fix plugin.yml. |
| "Unsupported API version" | The plugin was built for a newer Minecraft API than your server. Say your server version and ask for a rebuild against it. |
NoClassDefFoundError naming another plugin | A dependency (Vault, PlaceholderAPI, …) isn't installed. |
Works after restart, breaks after /reload | Many plugins don't support /reload. Restart the server instead. |
#Mods
| Symptom | Fix |
|---|---|
| Game crashes on a dedicated server | Client-only code in common or main code. Ask the chat to separate client code. |
| "Incompatible mod set" / wrong game version | The mod targets a different Minecraft or loader version. State both explicitly. |
| Missing dependency at startup (Fabric) | Install Fabric API (and any other listed dependency) in mods/. |
#Why does my mod build with Java 21 when it targets Java 17?
For Minecraft versions before 1.20.5 a mod targets Java 17. Fabric's build tool (Loom), however, only runs on Java 21 or newer. Codexe runs Gradle with Java 21 while still compiling your mod for Java 17, so the JAR works on a Java 17 server or client. That's expected, and it's why a Fabric 1.20.1 build log mentions Java 21.
#Datapacks
| Symptom | Fix |
|---|---|
/datapack list doesn't show it | The ZIP must contain pack.mcmeta at its top level, in world/datapacks/. |
| Loaded but a recipe or function does nothing | Wrong pack_format or folder names for your version. Say your exact Minecraft version. |
#Skript
| Symptom | Fix |
|---|---|
Parse errors on /sk reload | Usually a missing add-on. Check which add-ons the script uses (ask the chat if unsure), then install them. |
An expression like player's balance doesn't exist | Install Vault and an economy plugin. |