AI Game Actions
The AI doesn't just answer questions. It can change the time, clear the rain, give you items, scan nearby blocks, and run other in-game actions when you ask.
What the AI can do
| Category | What it does | How to ask |
|---|---|---|
| Time | Set the time to day or night | "Make it daytime" |
| Weather | Clear rain or start a storm | "Stop the rain" |
| Health | Restore your health and hunger | "Heal me, I'm low" |
| Gamemode | Switch between survival and creative | "Put me in creative" |
| Items | Give you specific items | "Give me 64 diamonds" |
| Block scan | Look around and describe nearby blocks | "Scan the area" |
| Scheduled tasks | Set a recurring reminder | "Remind me at 9am every day" |
| Delayed action | Do something after a delay | "Teleport me to spawn in 10 seconds" |
| Commands (CHAT) | Look up locations with /locate | "Find the nearest village" |
The AI figures out which action matches your question. You don't need to memorize exact phrases.
Turning actions on and off
By default, all actions are enabled. To disable them globally:
- Plugin: Set
enable_actions: falseinconfig.yml - Mod: Set
ai_enable_actions: falseincraftyai.json
When actions are disabled, the AI will still answer questions but won't change anything in the game.
Permissions
CraftyAI uses a granular permission system so you can control exactly what each player can do:
| Permission | Default | What it allows |
|---|---|---|
crafty.chat | Everyone | Talk to the AI in chat |
crafty.vision | Everyone | Scan blocks and entities |
crafty.scan | Everyone | Use /crafty scan command |
crafty.agentic | OP only | Master toggle for agentic tasks |
crafty.agentic.gamemode | OP only | Change player gamemode via AI |
crafty.actions | OP only | Execute AI actions (time, weather, give, etc.) |
crafty.actions.gamemode | OP only | Change gamemode via actions system |
crafty.admin | OP only | Admin commands (reload, learn, status) |
Install LuckPerms to assign granular permissions to specific players without making them OP.
CHAT action — running vanilla commands
When the AI outputs the CHAT action, it runs a vanilla /locate command as the player (requires OP). This is how the AI finds villages, biomes, and other structures.
Supported commands: Only /locate structure, /locate biome, and /locate poi are allowed via the CHAT action. Other commands like /tp and /kill have their own dedicated actions (Teleport, Kill Mobs) with proper safety checks.
/locate support: The AI supports /locate for structures (/locate structure minecraft:village), biomes (/locate biome minecraft:dark_forest), and points of interest (/locate poi). Command normalization handles common spelling mistakes automatically.
Compound example: "Give me a maxed out netherite pickaxe" generates a compound action like GIVE:netherite_pickaxe:1|ENCHANT:unbreaking:3|ENCHANT:mending:1|ENCHANT:efficiency:5|ENCHANT:fortune:3.
Risk level: CHAT actions are classified as destructive — the player must type /crafty confirm before they execute.
DELAYED_ACTION — timed execution
The AI can run an action after a delay. For example, "teleport me to spawn in 10 seconds" generates DELAYED_ACTION:10:TELEPORT_SPAWN. The delay range is 1–300 seconds (5 minutes). The action is handled client-side — no server roundtrip needed for the timer itself. Any action the client supports (TIME_DAY, WEATHER_CLEAR, TELEPORT_SPAWN, etc.) can be delayed.
Scan feedback loop
When the AI scans nearby blocks, the results are fed back into the AI conversation. The AI sees player coordinates, underground status, block types and counts, entity types and counts, and nearby player names. This lets it give informed suggestions (e.g. "I see diamonds 12 blocks below you" instead of guessing).
Items the AI will refuse to give
Some items break servers or trivialize survival. The AI will refuse to give these even if the player has crafty.actions:
- Command blocks, structure blocks, jigsaw blocks
- Bedrock, end portal frames, barrier blocks
- Spawners
- End gateway blocks
If a player asks for one, the AI tells them it can't help with that.
Confirming destructive actions
A few actions are destructive enough that the AI asks for confirmation before doing them. When the AI says something like "Say confirm to change your gamemode", just type confirm (or /crafty confirm) and it will run.
This applies to:
- Killing all mobs in the area
- Changing gamemode
- Running commands that affect other players
Compound actions
The AI can chain multiple actions in one response. For example:
Player: "Give me a fully enchanted netherite pickaxe" AI: gives netherite pickaxe, applies unbreaking 3, mending, efficiency 5, fortune 3
You see one response in chat, the AI does everything in order.
Limits
Some actions have hard limits to prevent abuse:
- Block scan radius: Free and Starter players can scan 8 blocks in each direction, Pro can scan 16, Enterprise can scan 32. You can also scan up to once every 30 seconds.
- Scheduled tasks: Unlimited count, but each task counts against your daily request limit.
Asking the AI to scan
When you ask the AI to scan nearby blocks, it first responds with "Scanning..." while scanning your surroundings. The scan results (coordinates, block types, entities, players) are then sent back to the AI, which responds with an informed description of what it found around you. This scan feedback loop means the AI can give specific advice like "There's a ravine 20 blocks east with exposed coal ore" rather than a generic response.
The scan returns a short list of the most common blocks plus entities and players it sees. It does not dump the full block list, that would flood chat.
If you want a more detailed scan (for example, "what blocks are above me"), the AI will tell you what it found at that specific location.