# CraftyAI — AI Companion **The most advanced AI companion for Paper, Spigot, Folia & Purpur servers.** [![Version](https://img.shields.io/badge/version-1.1.1--beta-00f3ff?style=for-the-badge&labelColor=0a0a0f)](https://modrinth.com/plugin/craftyai) [![Minecraft](https://img.shields.io/badge/paper-1.8%20→%201.21+-4ade80?style=for-the-badge&labelColor=0a0a0f)](https://papermc.io) [![Java](https://img.shields.io/badge/Java-17+-f59e0b?style=for-the-badge&labelColor=0a0a0f)](https://java.com)

> **⚠️ Beta Notice:** CraftyAI is currently in beta. You may encounter bugs, service interruptions, or unexpected behavior. Because the default AI service is entirely **free**, the system may occasionally experience performance drops, and the AI might sound a little bit dumb sometimes (we are actively working to tackle this by training our models more). If the AI is not working well or you run into issues, please just report it on our [Discord server](https://discord.gg/zCkE44hsBR)! > **Full Documentation**: Visit our [Documentation Wiki](https://craftyai.pages.dev) for detailed guides, troubleshooting, and FAQ. --- ## ⚡ Why CraftyAI? CraftyAI brings **real AI intelligence** directly into your Minecraft server's chat. No external bots, no web dashboards — players just **talk naturally** and get instant, intelligent, context-aware responses. **Your AI knows the game.** It reads the player's biome, health, coordinates, inventory, time of day, and nearby entities to give answers that actually make sense. --- ## 🎮 Features at a Glance ### Natural Language Chat 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? ``` ### Vision Scanner Players can right-click any block or entity with a Compass in hand (or use a command) to get an instant AI analysis — identification, properties, tips, and contextual advice. ### AI-Powered Game Actions The AI can execute real in-game commands: | Action | What it Does | |--------|-------------| | `TIME_DAY` / `TIME_NIGHT` | Sets the world time | | `WEATHER_CLEAR` / `WEATHER_RAIN` | Controls weather | | `HEAL` / `FEED` | Restores player health & hunger | | `GAMEMODE_CREATIVE` | Switches gamemode | | `GIVE::` | Gives items to players | ### Memory & Context - Per-player conversation history - Biome, health, coordinates, and time context - Fuzzy trigger matching (handles typos!) ### 📚 Teachable Knowledge Base ``` /crafty learn What are the server rules? | No griefing, be respectful, and have fun! ``` Teach the AI your server's unique lore, rules, and guides. ### ⚡ Clustered Proprietary Engine - Dedicated, private-clustered AI hosted on our own high-performance core infrastructure - **BYOK (Bring Your Own Key) Support**: Integrate your own Google Gemini keys for isolated, private custom quotas! - Automatic failover and active-active locking ensure **99.9% uptime** ---

*Players chatting with CraftyAI in real-time*

--- ## Platform Support | Platform | Versions | Status | |----------|----------|--------| | **Paper** | 1.8 → 1.21.x+ | ✅ Full Support | | **Spigot** | 1.8 → 1.21.x+ | ✅ Full Support | | **Folia** | 1.19 → 1.21.x+ | ✅ Regionized Schedulers | | **Purpur** | 1.16 → 1.21.x+ | ✅ Full Support | > [!NOTE] > **Java 17+ (Recommended 21)** is required for all modern versions (1.20.4 - 1.21.x+). Folia **requires** Java 17+ regardless of Minecraft version. --- ## How to Get Your API Key CraftyAI requires an API key to connect your server to our AI engine. Getting one is **free** and takes under a minute: 1. **Start your server** — The plugin will generate a unique **Session ID** automatically. Check your server console or look inside `.craftyai_session`. 2. **Join our Discord** — [discord.gg/zCkE44hsBR](https://discord.gg/zCkE44hsBR) 3. **Go to `#crafty`** — Find the CraftyAI panel posted by the Crafty bot 4. **Click "Get API Key"** — Enter your **Session ID** when prompted. The bot will generate a unique API key (`cai_...`) and link it to your session. 5. **Copy your API Key** — The bot will DM you the API key. 6. **Paste into your config** — Add it to `plugins/CraftyAI/config.yml` as `secret: "your-api-key"` > **Tip:** Each server needs its own API key. You can manage your keys via the **"My Sessions"** button in the `#crafty` channel. --- ## Installation 1. **Download** `CraftyAI-1.0.0.jar` from the releases 2. **Drop** it into your server's `plugins/` folder 3. **Start** the server — `config.yml` generates automatically 4. **Configure** `plugins/CraftyAI/config.yml`: ```yaml server: secret: "your-api-key" # From Discord bot ai: name: "Crafty" # AI display name aliases: - crafty - craftyai - ai - helper activation: prefix: "@" # Optional trigger prefix require-prefix: false # Make prefix mandatory? fuzzy-match: true # Handle typos? cooldown: 3 # Seconds between queries ``` 5. Run `/crafty reload` and you're live! --- ## Commands & Permissions | Command | Permission | Description | |---------|-----------|-------------| | `/crafty` | `crafty.chat` | Show plugin info | | `/crafty status` | `crafty.chat` | Connection diagnostics | | `/crafty reload` | `crafty.admin` | Reload configuration | | `/crafty learn \| ` | `crafty.admin` | Teach AI knowledge | | `/crafty test` | `crafty.chat` | Test AI connection | --- ## Transparency & Privacy CraftyAI is a powerful, secure AI companion built to protect your server's data privacy: - **Self-Hosted Infrastructure:** All AI processing, chat requests, and "Vision" scans are executed directly on our custom, high-performance hybrid clustered core. No third-party data tracking, advertising, or selling of chat history. - **BYOK (Bring Your Own Key):** For absolute isolation, server administrators can bring their own API keys (e.g. Google Gemini API keys) to bypass public limits and call AI directly under their own private quota. - **Closed Source & Security:** To protect our proprietary hybrid clustering algorithms and combat exploitation, the backend remains closed source. All client plugins (Spigot/Fabric/Forge) communicate over encrypted HTTPS requests. - **Telemetry & Heartbeats:** By default, the plugin/mod sends a heartbeat signal every 3 minutes to our central gateway to perform strict security checks and populate your Discord Bot status. This can be fully disabled by setting `enable_metrics: false` (Plugin) or `telemetry_enabled: false` (Mod) in your config. --- ## 🐛 Found a Bug? > **CraftyAI is in beta!** Found a bug? Need help? Open a support ticket on our Discord server! We don't use a public issue tracker — all support is handled through Discord tickets for faster, personalized responses. > > **[Open a Support Ticket on Discord](https://discord.gg/zCkE44hsBR)** --- - **Documentation**: [CraftyAI Wiki](https://craftyai.pages.dev) ---

**Built with ❤️ by [DemonZ Development](https://demonzdevelopment.online)** *CraftyAI is not affiliated with Mojang, Microsoft, or Minecraft.*
[![bStats](https://bstats.org/signatures/bukkit/CraftyAI.svg)](https://bstats.org/plugin/bukkit/CraftyAI/28401)

Published on	June 5, 2026
Downloads	1

CraftyAI

Release 1.1.1

DemonZ released CraftyAI version 1.1.1 on Fri 11:28 AM

Initial beta release

Information

Platforms

Release
1.1.1