CraftyAI

AI Companion for Minecraft

Talk to AI directly in your Minecraft chat. Get intelligent, context-aware responses.

⚠️ 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!

Full Documentation: Visit our Documentation Wiki for detailed guides, troubleshooting, and FAQ.

✨ What is CraftyAI?

CraftyAI adds a configurable AI companion to your Minecraft server or client. Players can ask questions, get help, and interact with AI naturally through in-game chat — no commands, no menus, just conversation.

The AI understands your game context — it knows your biome, health, coordinates, time of day, and what you're looking at.

🎮 Key Features

Natural Chat Activation

Just type naturally in chat:

crafty how do I find diamonds? @ai what is this biome? helper tell me about the Nether

No commands needed. Fuzzy matching handles typos!

Vision Scanner

Scan blocks and entities (right-click with a Compass for plugin, or press the V key for mod) to get an AI analysis:

• Entity identification & stats
• Block properties & usage tips
• Biome-aware contextual responses
• Works on ALL entities & blocks

⚡ Clustered Proprietary Engine

• Dedicated, private-clustered AI hosted on our own high-performance core infrastructure
• Zero server lag — fully async, ultra-low latency local database caching
• BYOK (Bring Your Own Key) Support: Integrate your own Google Gemini keys for isolated, private custom quotas!

AI Game Actions

The AI can take actions in your world:

• ⏰ Set time (day/night)
• 🌧️ Control weather
• ❤️ Heal & feed players
• 🎮 Change gamemodes
• 🎁 Give items

Conversation Memory

• AI remembers your recent chat history
• Context-aware follow-up responses
• Per-player conversation threads
• Configurable memory depth

📚 Teachable AI

Server admins can teach CraftyAI custom knowledge:

/crafty learn What is spawn? | Spawn is at 0, 64, 0!

Perfect for server rules, lore, and guides.

CraftyAI responding to player questions in real-time

⌨️ Mod Settings (Fabric / Forge)

CraftyAI includes a beautiful in-game settings screen accessible with a single keypress.

How to Open Settings

Press K at any time in-game to open the CraftyAI Settings panel. You can also use the command: /crafty settings

The native CraftyAI Settings GUI

Settings Screen Guide

Setting Description API Key Paste your API key. CraftyAI keys start with cai_ AI Display Name Change what the AI is called in chat (default: "Crafty") Mode Toggle Switch between Cloud (online AI) and Local (offline fallback) Session ID Your unique server identifier — click Copy to share with admins Test Connection Instantly verify your connection to the CraftyAI Gateway How to Get a Key Opens a step-by-step tutorial for obtaining your free API key

Tip: The settings screen auto-checks your Gateway connection status on open. Look for the green "Online" indicator!

📋 Requirements

Plugin (Spigot / Paper / Folia / Purpur)

Requirement Version Minecraft 1.8 → 1.21.x+ Java 17+ (Recommended 21) Server Spigot, Paper, Folia, or Purpur

[!IMPORTANT] Folia Users: Java 17 or higher is mandatory for regionized multithreading. Legacy Java 8 is only supported for Spigot/Paper 1.8 - 1.12.2.

Mod (Fabric / Forge)

Requirement Version Minecraft Fabric (1.20+ & 1.26.x) / Forge (1.20.x) Java 17+ (Recommended 21) Loader Fabric + Fabric API, or Forge

How to Get Your API Key

CraftyAI requires an API key to connect your server/client to our AI engine. Getting one is free and takes under a minute:

1. Start your server — The plugin/mod will generate a unique Session ID automatically. Check your server console or look inside .craftyai_session (plugin) or open the in-game settings GUI (mod, press K).
2. Join our Discord — 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 your API Key
6. Configure your server — Add it to your config.yml as secret: "your-api-key" (plugin) or paste it in the in-game settings GUI (mod)

Tip: Each server needs its own API key. You can manage your keys via the "My Sessions" button in the #crafty channel.

Quick Setup

Plugin Installation

1. Download CraftyAI-1.0.0-beta.jar and place it in your plugins/ folder
2. Start the server — config.yml is auto-generated
3. Edit plugins/CraftyAI/config.yml with your settings
4. Run /crafty reload and start chatting!

Mod Installation

1. Download the Fabric or Forge JAR and place it in your mods/ folder
2. Fabric users: Also install Fabric API — download the version matching your Minecraft version and place it in mods/
3. Launch Minecraft
4. Press K to open the settings screen
5. Configure your API key
6. Click Save and start chatting!

Commands

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 test Test AI connection crafty.chat /crafty settings (Mod only) Open settings GUI —

Vision Scanner analyzing entities in real-time

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.

🌐 Remote Connections

Per Modrinth Content Rule 1.11, this project connects to remote servers to provide core functionality and verify connection health:

• AI Chat & Generation Gateway:

  • Target Domain: https://craftyai-gateway.craftyauth.workers.dev
  • What is sent: Player in-game chat messages, player game context (coordinates, biome name, health, current world time, target block/entity metadata when using the Vision Scanner), API Key (cai_...), Session ID (generated UUID), and client/mod version.
  • Why it is sent: Required to process and reply to in-game chat using CraftyAI's hybrid AI generation pipeline.
  • Opt-out: This connection is only established when players actively chat with the AI (e.g. starting a message with crafty) or use the Vision Scanner. You can disable all AI processing by deleting the API key or removing the mod/plugin.

• Telemetry & Connection Heartbeats:

  • Target Domain: https://craftyai-gateway.craftyauth.workers.dev
  • What is sent: Hashed server/session ID, connection status, and daily request count.
  • Why it is sent: Used to perform security handshakes, verify API key quotas, and display active status on the Discord bot panel.
  • Opt-out: You can disable telemetry entirely by setting telemetry_enabled: false in config/craftyai.json (for Fabric/Forge mods) or enable_metrics: false in plugins/CraftyAI/config.yml (for Spigot/Paper plugins).

• Custom API Providers (Optional / User-Configured):

  • Target Domain: Any custom OpenAI/Gemini compatible base URL configured by the user.
  • What is sent: Chat completion payloads.
  • Why it is sent: Allows administrators to bring their own API keys (e.g. Google Gemini API keys) to call AI directly under their own private quota.

🐛 Found a Bug?

CraftyAI is in beta! We do NOT have a public issue tracker. If you encounter any bugs, crashes, or have feature requests, please open a ticket on our Discord server. Our team actively monitors tickets and will respond promptly.

Open a Support Ticket on Discord

🔗 Links

• Documentation: CraftyAI Wiki
• Discord: DemonZ Development
• Website: demonzdevelopment.online

Built with ❤️ by DemonZ Development

CraftyAI is not affiliated with Mojang, Microsoft, or Minecraft.