AI Game Actions
CraftyAI isn't just a chatbot—it can actually execute commands and modify the game world when requested by players.
Supported Actions
The AI is capable of executing the following actions:
| Action Category | Description | Example Trigger Phrase |
|---|---|---|
| Time | Set the time to day or night | "Crafty, make it daytime please." |
| Weather | Clear the weather or make it rain | "AI, stop the rain!" |
| Health | Restore health and hunger | "Helper, I'm dying, heal me!" |
| Gamemode | Switch to survival or creative | "Put me in creative mode." |
| Items | Give the player specific items | "Crafty, give me 64 diamonds." |
Enabling & Disabling Actions
Server administrators have full control over whether the AI is allowed to perform actions.
To globally enable or disable actions, change the setting in your config:
- Plugin (
config.yml):ai.enable_actions: true - Mod (
craftyai.json):"ai_enable_actions": true
Permissions
Even if actions are globally enabled, players must have specific permissions to request them:
crafty.actions: Required for a player to request any action (time, weather, heal, give).crafty.actions.gamemode: Required specifically for gamemode changes (for extra security).
By default, OPs have all permissions. Standard players will not be able to execute actions unless you grant them the crafty.actions permission using a plugin like LuckPerms.
The Give Item Blacklist
To prevent players (even those with permission) from obtaining dangerous items, CraftyAI has a built-in blacklist. The AI will refuse to give items such as:
- Command Blocks, Structure Blocks, Jigsaw Blocks
- Bedrock, End Portal Frames, Barrier Blocks
- Spawners
If a player requests one of these items, the AI will politely decline the request.