CraftyAI

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

⚡ 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:

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

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
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:

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

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

• Documentation: CraftyAI Wiki