mc.nates.cloud
CraftGPT 2.0 beta

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

  1. Paper 1.19.4+ only. No Spigot, no Folia.
  2. Memory is shared per mob. A mob can repeat one player’s words to another.
  3. AI mobs are deleted when they die, memory and all.
  4. Keep reasoning-effort: none with gpt-6-luna. Anything else breaks every chat that offers tools.
  5. OpenAI-compatible servers get no reasoning effort, so thinking models are slow there. Use the native ollama type with none instead.
  6. Strict config. Any invalid value, or an unset ${ENV_VAR} key, switches the plugin off at startup.
  7. One tool policy for the whole server: no /cg tools command and no per-mob tool settings yet.
  8. /cg stop doesn’t end a follow; the mob stops on its own within 30 seconds.
  9. Some tool settings need a restart (time zone, follow and wander limits, the nearby radius).
  10. Smaller models may guess instead of using a tool.
  11. No streaming. Replies arrive whole.
  12. Event reactions only happen during a chat, and don’t use tools.
  13. Occasional empty replies from the provider are logged as a warning; the cause isn’t confirmed yet.
  14. No going back by swapping jars. Returning to 0.3.x means restoring your backup.
  15. CLI providers are experimental. Check the CLI vendor’s terms before serving other players.

Planned, not in this beta

  • A /cg tools command and per-mob tool settings (2.1).
  • Tools during event reactions; a player-hurt-entity reaction.
  • 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.