Troubleshooting and frequently asked questions
Common Codexe questions: build failures, running out of tokens, plugin load errors, choosing a Minecraft version, and importing an existing project.
Frequently asked questions
My plugin does not appear on the server. What is wrong?
+
Almost always plugin.yml. Check that the `main` field exactly matches the fully-qualified class name, that the file sits in src/main/resources, and that the JAR you uploaded is the built artifact rather than the source archive. The server console prints the specific reason at startup.
The build failed. Can Codexe fix it?
+
Yes. Compile errors surface inside the workspace, and you can ask the assistant to fix them in the project chat. Because it can see the actual error and the actual file tree, it usually resolves the error in one pass.
Which Minecraft version does the generated code target?
+
Whichever you ask for. Say the version in your prompt. If you do not, Codexe picks a recent stable version, which may not match your server - stating it explicitly is the single most effective thing you can do for correctness on Minecraft targets.
I ran out of tokens mid-project. Did I lose the work?
+
No. The project and everything generated so far are saved. Generation stops rather than producing a truncated file. Free accounts get a fresh allowance at the next daily refill; paid plans can add a token pack or upgrade.
Can I import a project I already have?
+
Yes. Upload a ZIP of the existing project and Codexe imports the file tree, detecting the project type from its structure so the assistant applies the right knowledge when you ask for changes.
Do I own the generated code?
+
The code Codexe generates for you is yours to use. See the Terms of Service for the exact wording.
Why does my Folia plugin throw at runtime when it compiled fine?
+
Folia removed the single main thread that ordinary Bukkit plugins assume, so Bukkit.getScheduler().runTask(...) is not valid there. Work must be scheduled on the correct region or entity scheduler. Pick the Folia target rather than the Spigot target and the generated code uses region-aware scheduling from the start.
My Discord bot connects but never responds.
+
Usually a missing gateway intent or unsynced commands. Message Content and Server Members are privileged intents and must be enabled in the Discord developer portal. Slash commands also have to be synced with Discord before they appear - global syncs can take up to an hour, per-guild syncs are immediate.
My datapack does not load.
+
Check pack_format in pack.mcmeta against your Minecraft version, and check the directory names. Newer versions renamed the folders inside data/<namespace>/ from plural to singular, so functions/ became function/. A pack laid out for the wrong version fails silently.
Can I use Codexe output commercially, for example on a paid server?
+
Yes. Nothing in the generated project phones home or requires a Codexe licence at runtime. Check the Terms of Service for the full detail.
Still stuck
If none of the above covers it, the fastest route is the community Discord, where you can paste the error and the relevant file. See the contact page for where to go.