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

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

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

⌨️ 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

Settings Screen Guide

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

📋 Requirements

Plugin (Spigot / Paper / Folia / 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)

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

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

⚡ Sponsored by Nexeu Hosting

Looking for high-performance, reliable, and affordable hosting for your Minecraft server proxy? Check out Nexeu Hosting! Premium hardware, instant setup, and 24/7 support.

👉 Get Premium Hosting at nexeu.zip

🔗 Links

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