Status and known issues
Where it stands
- 2.0.0-beta.4 is the upcoming public beta: a ground-up rewrite of CraftGPT 0.3.x.
- It’s been tested live with OpenAI (
gpt-6-luna), Anthropic (claude-haiku-5-5), native Ollama (qwen3:8b) and an OpenAI-compatible server, all with tools. Gemini is checked by request-format tests and a code review, not live yet. - Upgrading from 0.3.x has been tested on Paper 1.19.4 against real 0.3.x data.
- The plan is to call it 2.0.0 after about two weeks without a serious bug report.
- The demo server (address at the top of every page) still runs an older 2.0 beta with tools turned off, so you won’t see mobs use tools there yet.
Found a bug? Report it with your Paper version, CraftGPT version, an excerpt of logs/latest.log, and the output of /cg admin status.
Known limitations
- Paper 1.19.4+ only. No Spigot, no Folia.
- Memory is shared per mob. A mob can repeat one player’s words to another.
- AI mobs are deleted when they die, memory and all.
- Keep
reasoning-effort: nonewithgpt-6-luna. Anything else breaks every chat that offers tools. - OpenAI-compatible servers get no reasoning effort, so thinking models are slow there. Use the native
ollamatype withnoneinstead. - Strict config. Any invalid value, or an unset
${ENV_VAR}key, switches the plugin off at startup. - One tool policy for the whole server: no
/cg toolscommand and no per-mob tool settings yet. /cg stopdoesn’t end a follow; the mob stops on its own within 30 seconds.- Some tool settings need a restart (time zone, follow and wander limits, the nearby radius).
- Smaller models may guess instead of using a tool.
- No streaming. Replies arrive whole.
- Event reactions only happen during a chat, and don’t use tools.
- Occasional empty replies from the provider are logged as a warning; the cause isn’t confirmed yet.
- No going back by swapping jars. Returning to 0.3.x means restoring your backup.
- CLI providers are experimental. Check the CLI vendor’s terms before serving other players.
Planned, not in this beta
- A
/cg toolscommand and per-mob tool settings (2.1). - Tools during event reactions; a
player-hurt-entityreaction. - Citizens-aware follow and wander.
- Tool settings that refresh on
/cg reload. - The API on a public Maven repository.
- Streaming replies.
- Ideas for 2.1: mobs talking to each other, network tools, web search for the AI, and longer-term memory.