Commands

Commands

All commands are under /ai. Type /ai help in-game for the live list.

Command	Description
/ai help	Show the in-game command list
/ai tutorial	Open the how-to walkthrough
/ai panel	Open the unified panel (admins → Admin, players → My Settings)
/ai menu · /ai config	Open the settings screen (admins)
/ai summon [name]	Spawn an assistant (default: Ethan)
/ai dismiss	Remove your assistant
/ai come	Call it to you
/ai follow	Have it follow you
/ai stay	Hold position and keep watch
/ai stop	Cancel the current task
/ai possess	Let your companion drive your character — opens a console to type instructions — see Possession Mode
/ai possess <instruction>	Steer possession by text (also works on Bedrock/vanilla)
/ai possess stop	End possession, hand control back
/ai connection	Show which one AI connection this server uses
/ai connection set <id>	(ops) Switch it — mcp, key, player2, ollama, free, off
/ai mcp	(ops) Connect Claude / ChatGPT / Grok / Gemini to your world — see MCP server
/ai look	Read what your companion can see right now (its own eyes, not the map)
/ai code <script> · /ai code stop	Hand it a script in the language its AI writes — see Vision & Code
/ai resume · /ai enable	Re-enable after the FPS kill-switch tripped
/ai locate · /ai where	Distance, direction and coords
/ai name <name>	Rename it
/ai skin <name>	Change skin (built-in or custom PNG) — see Custom Skins
/ai personality [<id>]	List or set how it talks & acts — see Personalities
/ai personality custom <text>	Give it your own AI-moderated personality
/ai bots	Open the visual Bots panel (every bot + owner); text list on Bedrock/vanilla — see Trust & Per-Bot Management
/ai trust <player> · /ai untrust <player>	Let / stop another player command this bot
/ai trust list · /ai trust clear	Show / clear this bot's trusted players
/ai voice	Voice status — hold V to talk to YOUR companion — see Voice
/ai voice share <player> · unshare <player>	Let / stop another player hearing your agent (links your agents' conversations)
/ai voice list · /ai voice clear	Who hears your agent / make it private again
/ai voice set <id>	Give your nearby bot its own TTS voice (nova, onyx, …)
/ai inventory · /ai inv	Show carried items
/ai mykey <token>|clear	Set/clear your own API key — see Per-Player Keys & Models
/ai model [<id>] · /ai models	Pick your bot's model / list allowed models
/ai mymenu	Personal settings screen (your model + your key)
/aiskins list|reload	(client) List or hot-reload the skins folder
/aichat	(client) Open the private AI chat box — works on any server — see Client-Side Assistant
/aidrive [<instruction>|stop]	(client) Off-server possession console / steer / end — see Client-Side Assistant
/aitips [on|off]	(client) Toggle the private on-screen survival tips
/aivoice [on|off|stop|key <code>|voice <id>|test <text>]	(client) Your voice settings: hear the agent or not, rebind push-to-talk, default voice — see Voice
/aihost · /aihost status|stop	(client, Java only) Host a Bedrock-capable server — see Bedrock (Geyser)
/ai admin …	(ops only) Admin panel — see below
/ai mcp status|token|newtoken|port <n>|remote on|off|start|stop	(ops) MCP server details and controls
/ai <task>	Give a natural-language task
/ai queue <task>	Add a job to its list (16 deep, survives logging off)
/ai queue list / clear	Show / empty the list
/ai speed [instant|fast|human]	How quickly it reacts — see Speed & Combat
/ai combat [basic|skilled|expert]	How well it fights
/ai attack <player>	(owner) Point it at someone — needs allowPvp, and only ever someone who started it
/ai pvt / /ai pvt status	How learning by watching is going
/ai pvt watch on|off	Opt your own play in or out of being learned from
/ai pvt record start|stop	Start/stop a recording session by hand

No setting commands (3.4.0). The old /ai settings, /ai token, /ai listen, /ai active and /ai commands were removed — they were too fiddly. Configure everything in the panel (/ai panel / /ai menu), which is operator-only (adminPermissionLevel, default 2 = ops). Everyday commands above stay open to all players. Ops on a vanilla client can still configure via the text /ai admin … tree (and the BLOCKPAL_API_TOKEN environment variable for the shared key).

Running the AI on your own GPU

Command	Who	Effect
/ai local	anyone	Status: model, runtime, hardware, state
/ai local models	anyone	The models it can run (all under 3 GB)
/ai local setup [model]	ops	Show exactly what would be downloaded — downloads nothing
/ai local accept	ops	Agree to it. The only thing that starts a download.
/ai local cancel	ops	Forget the pending download
/ai local start / stop	ops	Run it / stop it (files are kept)
/ai local log	ops	What the model server printed

Full detail on Local AI on your GPU.

Teaching it by example (PVT)

/ai pvt watch on lets your companion learn from how you play — it is off until you say so, and off stops it immediately. An operator then runs /ai pvt train and /ai pvt use on. Full detail on PVT — learning by watching.

Who can command a bot

By default only the owner (the player who summoned it) can give a companion orders. The owner can trust other players with /ai trust <player> so they may command it too, and server admins can always command or moderate any bot. Trusted players can give orders (come/follow/stay/stop, locate, inventory, tasks) but cannot rename, re-skin, change the personality of, dismiss, or re-trust someone else's bot — those stay owner-only. See Trust & Per-Bot Management.

Admin commands (ops only)

The whole /ai admin tree is hidden from, and refused to, anyone below the admin permission level. See Admin Menu for the full guide.

Command	Description
/ai admin menu	Open the visual admin panel
/ai admin stats	Bots, players, FPS, mod status (text)
/ai admin list	Every bot and where it is (text)
/ai admin killall	Remove all bots on the server
/ai admin maxbots <0-50>	Cap bots per server (0 = unlimited)
/ai admin disable · /ai admin enable	Turn all bots off / on for everyone
/ai admin reload	Reload config.json from disk
/ai admin token <key>	Set the shared AI API key (no GUI needed)
/ai admin apiurl <url>	Set the OpenAI-compatible API endpoint
/ai admin provider [<name>]	Quick-switch provider: huggingface/chatgpt/claude/gemini/grok (bare lists them) — see Settings
/ai admin model <id>	Set the server default model
/ai admin requirekey on|off	Make players use their own API key — see Per-Player Keys & Models
/ai admin possession on|off	Allow / deny possession mode (/ai possess) — see Possession Mode
/ai admin voice on|off	Allow / deny agent voice (push-to-talk + speech) — see Voice
/ai admin keylist add|remove|list <player>	Who may use the shared key when BYOK is on
/ai admin models add|remove|list <id>	Curate the models players may pick

PvP and training (ops)

Command	Effect
/ai admin pvp on|off	May companions ever raise a hand to a player? Off by default. Even on, only against someone who attacked them or their owner in the last ten seconds, or whom their owner named — never the owner or anyone trusted.
/ai pvt train	Train a policy from the play people have opted to share
/ai pvt use on|off	Let companions act on what they learned
/ai pvt clear	Delete every recording (the trained policy is kept)
/ai speed <tempo>	Set the server-wide reaction speed
/ai combat <skill>	Set the server-wide combat skill

Party commands

Team up with friends (the group that Minigames will run on). Open to everyone and server-side, so Java and Bedrock players use them the same. See Friend Sharing.

Command	Description
/party invite <player>	Invite an online player (auto-creates your party)
/party accept · /party deny	Accept / decline an invite (expires after 2 min)
/party list	Show your party and its leader
/party leave	Leave your party
/party kick <player>	(leader) Remove a member
/party disband	(leader) End the party

Mini-game commands

Play game modes with the bot and your party. See Minigames.

Command	Description
/ai minigame list	Show the modes (and your current game)
/ai minigame start <mode>	Start a game for your party — chained, samehealth, oneblock, fusion, growth
/ai minigame stop	(leader) End the game, or (member) leave it

Quick intents (no API token)

These common phrases — whether as a command or just typed in chat — are handled instantly with no LLM call: come, follow, stop, stay, where are you.

See Talking to Your Assistant for how chat addressing and active analysis decide what counts as a command.