# CraftyAI ### AI companion for Paper servers
Talk to an AI in Minecraft chat. It answers questions, scans blocks, controls time and weather, gives items, and runs commands. Free to use.
[Docs](https://craftyai.pages.dev) · [Download](#installation) · [Discord](https://discord.gg/zCkE44hsBR)

> [!NOTE] > **Need Help or Have Feedback?** Join our [Discord server](https://discord.gg/zCkE44hsBR) for support, setup guidance, feature requests, and discussions with our community. --- ## What's New in v1.3.0 - **Bedrock players welcome** — GeyserMC and Floodgate players are fully supported, including prefixes and gamertags up to 36 characters. - **API keys set themselves up** — no Discord verification needed to start. Just drop the JAR in and a key is generated and saved automatically. - **Minecraft 26 support** — the same plugin JAR runs on 1.21.x and 26.x Paper servers (built on the stable Spigot API). - **More ways to find things** — `/locate poi` joins the existing structure and biome lookups. - **Conversation memory** — the AI remembers players across sessions using vector similarity search. - **Block and entity scanning** — players can ask the AI to scan nearby blocks and entities up to 32 blocks out. --- ## Why CraftyAI for your Server? ### Natural Chat Experience Players interact by simply typing in chat. No slash commands needed: ``` crafty what's the best enchantment for a diamond sword? @ai how do I get to the Nether? helper where can I find iron? ``` The AI knows their game context: time, biome, health, coords, and inventory! ### AI Game Actions The AI doesn't just talk — it acts. - Control time and weather - Heal and feed players - Change gamemodes - Give specific items - Execute scheduled or delayed automations ### Edge Infrastructure All processing is done on our secure edge network. Your server's CPU is completely unaffected. --- ## Subscription Tiers CraftyAI is free for everyone, with high-scale options for large networks. | Tier | RPM | Requests/Day | Tokens/Day | Custom Prompts | |------|-----|-------------|-----------|---------------| | **Free** | 30 | 100 | 50K | No | | **Starter** | 100 | 1,000 | 500K | No | | **Pro** | 200 | 5,000 | 2.5M | 1 change/24h | | **Enterprise**| 500 | 100,000 | 10M | Yes | --- ## Platform Support | Platform | Versions | Status | |----------|----------|--------| | **Spigot** | 1.9 → 1.21.x & 26.x | Full Support | | **Paper** | 1.9 → 1.21.x & 26.x | Full Support | | **Folia** | 1.19 → 1.21.x & 26.x | Async Scheduling | | **Purpur** | 1.16 → 1.21.x & 26.x | Full Support | *One plugin JAR covers every supported version — CraftyAI is built on the stable Bukkit/Paper API, working on 1.9 through 26.x.* --- ## Installation 1. Download `craftyai-spigot-1.3.0.jar` from [Modrinth](https://modrinth.com/plugin/craftyai) 2. Drop it in `plugins/` and start the server 3. Start chatting. --- ## Commands & Permissions | Command | Description | Permission | |---------|-------------|------------| | `/crafty` | Plugin info & status | `crafty.chat` | | `/crafty status` | Connection diagnostics | `crafty.chat` | | `/crafty reload` | Reload configuration | `crafty.admin` | | `/crafty learn Q \| A` | Teach the AI new knowledge | `crafty.admin` | | `/crafty confirm` | Confirm pending AI world actions | `crafty.chat` | | `/crafty memory` | View player RAG vector memory context | `crafty.use` | | `/crafty forget [n]` | Clear recent player vector memories | `crafty.use` | | `/crafty privacy ` | Toggle server RAG memory privacy | `crafty.admin` | | `/crafty mode ` | Toggle local vs cloud AI mode | `crafty.admin` | | `/crafty apikey` | View or auto-mint server API key | `crafty.admin` | | `/crafty apikey rotate` | Rotate server API key | `crafty.admin` | | `/crafty pro status` | Show current tier and expiry | `crafty.chat` | | `/crafty pro redeem ` | Redeem a Pro key from Discord | `crafty.admin` | | `/crafty pro help` | Show how to get a Pro key | `crafty.chat` | | `/crafty link` | Link server to Discord | `crafty.chat` | | `/crafty prompt view` | View custom prompt | `crafty.admin` | | `/crafty prompt set ` | Set custom prompt (Pro) | `crafty.admin` | | `/crafty prompt reset` | Reset prompt (Pro) | `crafty.admin` | *Allow AI to execute actions with the `crafty.actions` permission.* --- ## Transparency & Privacy - **DemonZ AI Cloud**: CraftyAI is powered by DemonZ Development's proprietary AI Cloud infrastructure. Chat history is processed securely and is never sold. - **BYOK**: Bring your own AI API key for full data isolation. - **Closed Source Infrastructure**: Server-side AI network code is proprietary to DemonZ Development. Plugins communicate via secure, encrypted HTTPS endpoints. **Remote Connections**: - **AI Gateway Endpoint**: Connects to `https://craftyai-gateway.craftyauth.workers.dev` when a player chats. Sends game context, API key, and Session ID to process AI chat and actions. - **Telemetry**: Sends anonymous heartbeats with server/plugin version and player count. Disable with `enable_metrics: false`. --- ## Found a Bug? Please **open a ticket** on our [Discord server](https://discord.gg/zCkE44hsBR). Our team actively monitors tickets and will respond promptly. ---

**Built with care by DemonZ Development**
_{CraftyAI is not affiliated with Mojang, Microsoft, or Minecraft.}

CraftyAI

1.3.0

1.2.0

1.1.1