mc.nates.cloud
CraftGPT 2.0 beta

Creating AI characters

The basics

  1. /cg wand gives you the Magic Wand (a golden hoe; it does nothing to blocks).
  2. Left-click a mob with the wand to select it, again to unselect. (Sneaking with the wand doesn’t work: “Can’t use magic wand while sneaking!”)
  3. /cg create turns the selected mob into an AI mob.

If you didn’t give it a personality, CraftGPT asks the AI to write a short, wacky one (and a name, unless you set one). A mob that already has a visible custom name, or a Citizens NPC, keeps its name.

The mob builder

Before /cg create, you can stage details on the selected mob:

Command What it stages
/cg name <text> Its name
/cg backstory <text> A personality. It’s slotted into the default system prompt
/cg rawprompt <text> A complete system prompt, used word for word (can’t be combined with a backstory)
/cg displayname <text> Its visible name tag (changes immediately)
/cg prefix <text> Its chat prefix. %NAME% is the mob’s name; & colour codes work. Default <%NAME%>
/cg visibility <normal|private|world|global> Who sees its chats
/cg auto-chat Toggles its auto-chat flag

/cg dryrun previews what you’ve staged; /cg clearMobBuilder starts over. prefix, visibility and auto-chat also work on mobs that are already AI.

Editing a personality

/cg prompt works on the mob you’ve selected:

Command What it does
/cg prompt show [page] Shows the prompt, 1,000 characters per page
/cg prompt set <text> [--clear-history] Replaces it
/cg prompt append <text> [--clear-history] Adds to it
/cg prompt tobook Gives you a book with the prompt in it, so you can edit it comfortably
/cg prompt frombook [backstory] [--clear-history] Reads the book in your main hand back in, as the prompt (or as a backstory)
/cg prompt edit Opens a native editor screen (Paper 1.21.7+)

Prompts can be up to 8,000 characters (prompt-editor.max-prompt-length). When you change an existing mob’s prompt, either clear its chat history (--clear-history), or keep it and the mob is told “The persona was just updated.”

Other admin tools

  • /cg info: the selected mob’s name and its prompt or backstory.
  • /cg model [<profile>|clear]: give one mob a different AI provider, or go back to the default.
  • /cg locate: make the selected or chatting mob glow for 10 seconds.
  • /cg tphere / /cg tpto: bring the mob to you, or go to it.
  • /cg remove: turn the AI off and delete the mob’s record and memory.
  • /cg consolecreate <uuid> [rawprompt] (console only): create an AI mob by entity ID, with auto-chat on.

Auto-spawn

Off by default. With auto-spawn.enabled: true, the first time a chunk in one of the listed worlds loads, each eligible mob in it (not players, armour stands, named mobs or Citizens NPCs) has a 1.5% chance (auto-spawn.chance) of becoming an AI mob with a random personality, plus any prompt-appendix text you add. Each chunk is only checked once. Auto-spawned mobs start with auto-chat on.