# CraftyAI ### An intelligent, conversational AI companion for Minecraft Talk naturally in chat, scan your surroundings to spot mobs and resources, manage weather and time, and run game actions without leaving Minecraft. Completely free with 500,000 daily tokens.
[Documentation](https://craftyai.pages.dev) · [Discord Community](https://discord.gg/zCkE44hsBR) · [Features](#features) · [Installation](#quick-setup) · [Commands](#commands)

> Have questions, ideas, or feedback? Join our community on the [CraftyAI Discord](https://discord.gg/zCkE44hsBR). --- ## What's New in v1.4.0 CraftyAI 1.4.0 is a major update focused on agentic surroundings scans, a 10x boost to the free daily token quota, day-one support for Minecraft 26.3, and a completely rebuilt settings menu: - **Agentic Surroundings Scans**: Scanning your surroundings (via the **V** key or chat) now gives you real feedback. Crafty scans nearby blocks, mobs, caves, and terrain, then replies in natural chat with a conversational summary of what was found nearby. - **500,000 Free Daily Tokens**: The free tier quota has been increased tenfold from 50,000 to **500,000 tokens/day**. Server startup handshakes are also decoupled from chat limits, so servers will never get locked out on restart. - **Rebuilt In-Game Settings GUI**: Press **M** in-game to open the redesigned settings menu. It features clean tabs for General, Connection, and Providers, a one-click **Auto-Mint Free Key** button, and fixes the crash when clicking Save & close on Minecraft 26.x. - **Minecraft 26.3 Ready**: Day-one builds for the newest Minecraft 26.3 on Fabric and NeoForge, including adaptations for the revised input and keybinding system. - **Dedicated Version Jars**: We now ship separate, optimized jars for every major release from 1.20.4 up through 26.3 across Fabric, Forge, and NeoForge, plus an updated Paper/Spigot plugin. - **Verified Game Actions**: Actions now verify actual server execution results before taking subsequent steps, and active runs can be cancelled at any time using `/craftyclient cancel`. - **Survival Operator Permissions**: Survival mode operators have their OP permissions recognized properly without needing creative mode. --- ## Features ### In-Game AI Chat Talk directly to Crafty in Minecraft chat. Ask for crafting recipes, advice on builds, survival tips, or general conversation. Crafty understands typos, recalls recent conversations across sessions, and speaks naturally. ### Surroundings & Vision Scanner Press **V** or ask Crafty in chat to look around. Crafty scans entities, mobs, blocks, and biomes within 32 blocks of you. Whether you are looking for an iron golem in a village, watching out for hostile mobs in the dark, or locating resources, Crafty summarizes what is around you conversationally. ### Game Actions & Helper Commands Authorized players and operators can ask Crafty to perform in-game actions: - Change time (`make it day`, `set time to night`) - Control weather (`clear the rain`, `make it a thunderstorm`) - Heal and feed players - Locate structures and biomes (`/locate structure`, `/locate biome`) - Give items and execute whitelisted commands ### Safety & Confirmation Crafty is designed with safety controls: - Sensitive or disruptive commands require explicit player confirmation before execution. - Any running multi-step action sequence can be aborted instantly with `/craftyclient cancel`. - Non-operator players cannot trigger administrative or cheat commands. ### Bedrock Edition Support CraftyAI fully supports Bedrock Edition players joining through GeyserMC and Floodgate, including prefixed gamertags (`.`, `*`, `-`) up to 36 characters long. --- ## Daily Token Tiers CraftyAI is free for everyone. Higher tiers provide additional capacity for larger server networks. | Tier | RPM | Requests / Day | Tokens / Day | Notes | |---|---|---|---|---| | **Free** | 30 | 100 | **500,000** | Generous quota for solo play and small servers | | **Starter** | 100 | 1,000 | **1,000,000** | Expanded daily limits for growing communities | | **Pro** | 200 | 5,000 | **2,500,000** | Custom prompts and priority routing | | **Enterprise** | 500 | 100,000 | **10,000,000** | High-throughput for large multiplayer networks | --- ## Supported Versions and Loaders Install **only the jar** matching your exact loader and Minecraft version: ### Client / Server Mods - **Fabric**: Minecraft `1.20.4`, `1.20.5`, `1.20.6`, `1.21` through `1.21.11`, `26.1`, `26.1.1`, `26.1.2`, `26.2`, and `26.3` *(requires Fabric API)*. - **NeoForge**: Minecraft `1.20.4`, `1.20.5`, `1.20.6`, `1.21` through `1.21.11`, `26.1`, `26.1.1`, `26.1.2`, `26.2`, and `26.3`. - **Forge**: Minecraft `1.20.4`, `1.20.6`, `1.21`, `1.21.1`, `1.21.3` through `1.21.11`, `26.1`, `26.1.1`, `26.1.2`, and `26.2`. ### Server Plugin - **Paper / Spigot / Purpur / Folia**: Minecraft `1.8` through `26.3` using `craftyai-spigot-1.4.0.jar`. --- ## Quick Setup ### For Singleplayer & Modded Clients (Fabric / Forge / NeoForge) 1. Download the jar for your loader and Minecraft version from the [Versions tab](https://modrinth.com/mod/craftyai/versions). 2. Drop the jar into your `.minecraft/mods` folder. *(Fabric users: make sure [Fabric API](https://modrinth.com/mod/fabric-api) is also in your mods folder).* 3. Launch Minecraft. 4. Press **M** in-game to open settings and click **Auto-Mint Key**. You are ready to chat! ### For Dedicated Servers (Paper / Spigot / Purpur / Folia) 1. Download `craftyai-spigot-1.4.0.jar` from the [Versions tab](https://modrinth.com/mod/craftyai/versions). 2. Place the jar in your server's `plugins/` directory. 3. Start or restart your server. Crafty will automatically provision a free API key on first launch. 4. Type in chat to start talking with Crafty. --- ## Keybinds & Commands ### Default Keybindings | Key | Action | |---|---| | **M** | Open CraftyAI in-game settings screen (rebindable in Controls) | | **V** | Instant surroundings scan (rebindable in Controls) | ### Common Chat Commands | Command | Description | Permission | |---|---|---| | `/crafty ask ` | Talk to Crafty directly via command | `crafty.chat` | | `/crafty status` | Check connection and daily token usage | `crafty.chat` | | `/crafty confirm` | Confirm a pending action requested by Crafty | `crafty.chat` | | `/craftyclient cancel` | Abort an ongoing client action sequence | `crafty.use` | | `/crafty apikey` | View or auto-mint your API key | `crafty.admin` | | `/crafty reload` | Reload plugin or mod configuration | `crafty.admin` | | `/crafty memory` | View recent conversation memory context | `crafty.use` | | `/crafty forget` | Clear stored conversation memory | `crafty.use` | --- ## Transparency, Disclosures & Privacy ### Remote Network Connections When an authorized player chats or triggers a scan, CraftyAI sends an encrypted HTTPS request to our secure edge gateway (`https://craftyai-gateway.craftyauth.workers.dev` or `https://craftydb.demonz.org`). The request payload includes: - The player's prompt or question - Player name (for conversation continuity) - Relevant local game context (such as coordinates, biome name, and nearby block/entity types during a scan) - Your server or client API key ### Privacy Promise - Chat prompts and scan data are processed solely to generate the in-game response and are **never sold or shared with third-party advertisers**. - **BYOK (Bring Your Own Key)**: Server administrators who prefer complete data isolation can supply their own API keys (e.g. Gemini, Groq) via configuration. - **Telemetry**: Crafty collects anonymous heartbeat pings and request volume counters to monitor edge stability. Telemetry can be disabled at any time by setting `enable_metrics: false` in `config.yml` (Plugin) or `telemetry_enabled: false` in client mod settings. --- ## Community & Support - Found a bug or want to suggest a feature? Join our [Discord server](https://discord.gg/zCkE44hsBR) or open an issue on GitHub. - Detailed documentation and guides: [craftyai.pages.dev](https://craftyai.pages.dev) --- ## Sponsored by Nexeu Hosting [![Nexeu Hosting](https://whodoesntloveavatars.s3.fra.databucket.eu/assets/promo.png)](https://nexeu.zip/) High-performance Minecraft server hosting with instant deployment, dedicated hardware, and 24/7 support. **[Explore hosting plans at nexeu.zip](https://nexeu.zip/)** ---

_{CraftyAI is an independent project and is not affiliated with Mojang, Microsoft, or Minecraft.}

CraftyAI

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Tags

Creators

Details