Skip to main content

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

CategoryWhat it doesHow to ask
TimeSet the time to day or night"Make it daytime"
WeatherClear rain or start a storm"Stop the rain"
HealthRestore your health and hunger"Heal me, I'm low"
GamemodeSwitch between survival and creative"Put me in creative"
ItemsGive you specific items"Give me 64 diamonds"
Block scanLook around and describe nearby blocks"Scan the area"
Scheduled tasksSet a recurring reminder"Remind me at 9am every day"
Delayed actionDo something after a delay"Teleport me to spawn in 10 seconds"
CommandsRun any vanilla command as you"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: false in config.yml
  • Mod: Set ai_enable_actions: false in craftyai.json

When actions are disabled, the AI will still answer questions but won't change anything in the game.

Permissions

Even with actions enabled, individual players need permission to request them:

  • crafty.actions is required for any action
  • crafty.actions.gamemode is required for gamemode changes specifically

By default, OPs have both. Standard players have neither. If you want to grant actions to specific players without making them OP, install LuckPerms.

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 responds with a short list of the most common blocks plus any 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.