Client-side AI assistant for Minecraft 1.21 Fabric.
G1axAgenticAI connects a language model to Minecraft through a set of built-in capabilities. The assistant can inspect game state, retrieve recipe data, analyze client performance, read configuration files, and optionally execute commands when Trust Mode is enabled.
- ReAct-based tool execution
- Inventory and world awareness
- Recipe lookup and craftability analysis
- Performance diagnostics
- Configuration management
- Log and crash analysis
- Safe-by-default actions
- Groq and Gemini support
- Inventory
- Player information
- World information
- Nearby entities
- Targeted block
- Recipe lookup
- Craftability analysis
- Performance information
- Installed mods
- Configuration files
- Log analysis
- Crash reports
- Command execution
- Chat messaging
/mcai <message>
/mcai config
/mcai toggle
/mcai reset
/mcai status
/mcai trust <on|off>
/mcai key <provider> <key>
/mcai provider <auto|groq|gemini>
/mcai analyze
/mcai optimize <low|medium|high>
/mcai list mods
/mcai list configs
/mcai about
- Install Fabric Loader.
- Install Fabric API.
- Place the mod in the
modsdirectory. - Start Minecraft.
- Open
/mcai config. - Add a Groq or Gemini API key.
The configuration screen allows you to:
- Configure API keys
- Select the preferred provider
- Choose the active model
- Toggle Trust Mode
By default, the assistant runs in Safe Mode and cannot perform actions.
When Trust Mode is enabled, it can:
- Execute commands
- Send chat messages
- Modify supported configuration files
- Minecraft 1.21.x
- Fabric Loader
- Fabric API
- Groq or Gemini API key
Issues and pull requests are welcome.
Licensed under CC0 1.0. This is the layout used by many well-maintained GitHub projects. It keeps the README concise while still providing detailed documentation for users who need it.