CraftyAI

CraftyAI 1.4.0 is a major update focused on surroundings scan feedback, stability on newer Minecraft versions, expanded loader compatibility, and a significantly higher free tier token quota.

Surroundings scans and agentic feedback

- Fixed surroundings scans returning only a placeholder message or nothing at all. Crafty now processes the detected entity, mob, block, and biome data from the scan harness and returns a natural chat summary of what was found nearby. - Fixed an issue where repeated scan triggers during harness execution caused the action loop to abort.

Free tier quota and connectivity

- Raised the free tier token limit from 50,000 to 500,000 tokens per day. - Decoupled server startup handshakes and heartbeats from daily chat token limits. Servers will no longer fail to connect or auto-mint keys if daily tokens are exhausted.

In-game settings menu

- Fixed a client crash when clicking Save & close on Minecraft 26.x caused by upstream changes to screen fields. - Reorganized the in-game settings screen (keybind M or via the mod list) into tabs for General, Connection, and Providers. - Fixed settings persistence issues so configuration changes reliably save across game sessions. - Added a one-click Auto-Mint Free Key button in the menu header for instant setup without copying keys manually.

Version and loader support

- Added support for Minecraft 26.3 on Fabric and NeoForge, including updates for the revised input handling system. - Shipped dedicated jars for each target version: 1.20.4, 1.20.5, 1.20.6, 1.21 through 1.21.11, 26.1, 26.2, and 26.3. - Supported loaders include Fabric, Forge, and NeoForge, as well as the Paper/Spigot server plugin.

Actions and permissions

- Action runs now inspect actual command execution results before planning subsequent steps instead of assuming commands succeeded. - Fixed OP permission checks in survival mode so operators can run authorized commands without needing creative mode. - Actions requiring confirmation now pause for player approval, and active runs can be cancelled at any time with /craftyclient cancel.

Installation

- Client mods go in your .minecraft/mods folder. Install only the jar that matches your exact loader and Minecraft version. - Server plugin (craftyai-spigot-1.4.0.jar) goes in your server's plugins/ folder. - Keybinds: M opens the settings menu, V triggers an surroundings scan. Both can be rebound in Minecraft's Controls menu. - Chat command: /crafty ask <question> or /crafty status.

CraftyAI 1.3.0 is here — a big step forward.

New

- NeoForge support for Minecraft 26.x — CraftyAI now runs on the modern NeoForge loader for MC 26.x, alongside Fabric 26.x. - Agentic actions for everyone — healing, time/weather, item give, teleport and block scanning are available on all tiers, not just Pro. - Chat-based scheduled tasks — ask the AI to set a recurring task (remind the server every morning at 9am) and it runs on schedule. - One-shot delayed actions — teleport me in 10 seconds now works as a timed action. - Block scanning — ask the AI to scan the area and it reports what is around you. - Automatic API key minting — new servers get a working connection key automatically on first start; no dashboard needed. - Discord server linking — link your Minecraft server to your Discord account with /link. - Offline mode — singleplayer worlds and offline servers get a local fallback brain, with questions saved locally that can be replayed once your connection is restored.

Platforms

- Spigot / Paper / Purpur / Folia — MC 1.8+ - Fabric — MC 1.20.4 to 1.21.x - Fabric 26 — MC 26.x - Forge — MC 1.20.4 to 1.20.6 - NeoForge — MC 26.x (new!) Install the jar that matches your server, restart, and an OP can type /crafty apikey to get connected. Chat with the AI using @crafty <message>.

v1.2.0-beta "Orion" — Unblock Everyone

Theme: Tier is now purely a scale axis, not a feature axis. Vision, agentic tasks, and block scanning are free for all tiers. #### New Features - Auto-Mint API Key: Servers automatically generate a free API key on first startup — no Discord required - Block Scanning: New SCAN_BLOCKS action — AI can scan nearby blocks and entities (radius: free=8, pro=16, enterprise=32) - Scheduled Tasks: New SCHEDULE_TASK action — create cron-based recurring events via chat (unlimited per tier) - Delayed Actions: New DELAYED_ACTION — one-shot timers (1-300 seconds) for any agentic action - Custom Prompts: Pro-only feature — customize the AI's personality via /crafty prompt set (1 change per 24h) - Server Linking: /crafty link + Discord /link to link Minecraft servers to Discord accounts - Rate Limit Audit: Session-level rate limit tracking for forensic analysis - Scan Context Feedback: After block scan, results are sent back to AI for informed decisions #### Breaking Changes - Memory limits removed: RAG memory is unlimited for all tiers (compactor handles eviction) - Tier gates removed: Vision scanning, agentic tasks, and block scanning are free for all tiers - added better compaction engine: now there might be some compaction and old memory issues but overall we tried our best to tackle them - Config migration: config_version: 3 — automatic migration on first load #### New Commands - /crafty apikey — Generate a new API key (auto-mint) - /crafty pro status — Show current tier and expiry - /crafty pro redeem <key> — Redeem a Discord-issued Pro key - /crafty pro help — Show how to get a Pro key - /crafty link — Link server to Discord account - /crafty prompt view — View current custom prompt (Pro) - /crafty prompt set <text> — Set custom prompt (Pro, 1/day) - /crafty help - learn how commands works #### Tier Model (Updated) | 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 | #### Compatibility - Backward compatible with v1.1.x clients - Fabric 1.20 now works on MC 1.20.4–1.21.1 (was 1.20.4–1.20.6) - Fabric 26 (MC 26.x) compiles and runs on MC 26.1.2 - Forge compiles and runs on MC 1.20.4

Hotfix: Update Checker

A critical defect in both UpdateChecker classes silently broke in-game update notifications on v1.1.0-beta — admins running v1.0.0-beta were never notified that v1.1.0-beta was available. This hotfix restores the update channel. - Modrinth project ID typo — XOF1R6bb → XOFIR6bb (one missing I). The v2 API call returned 404 silently; the JSON versions[0] was always null, so the "Update Available" banner never printed. - Wrong download URL in update banner — /mod/craftyai → /plugin/craftyai to match the canonical Modrinth slug the project is published under. - Both defects existed in two parallel implementations: - craftyai-common/src/main/java/com/demonz/craftyai/common/UpdateChecker.java (used by Fabric 1.20, Fabric 1.26, and Forge) - craftyai-plugin/src/main/java/com/demonz/craftyai/UpdateChecker.java (Spigot plugin)

CraftyAI v1.0.0-beta

Welcome to the official release of CraftyAI! This plugin/mod brings natural, context-aware AI intelligence directly into your Minecraft server's chat.

Core Features

🗣️ Natural Chat* — Talk to the AI naturally in game chat using its name/aliases. Highly configurable with fuzzy-matching typo tolerance. 🔍 Vision Scanner* — Scan block types, coordinates, and entities for real-time AI-powered description and contextual advice. 🎯 AI Game Actions* — The AI can trigger in-game commands on active request (e.g. changing time/weather, healing, or giving items). 💾 RAG Memory & Compaction* — Edge-cached database storage with background compaction giving the AI permanent recall of your server's unique rules and lore. 🔑 BYOK (Bring Your Own Key)* — Bypasses Gateway limits entirely by using your own Google Gemini API key directly from Google AI Studio.

Centralized Management & Security

Discord Bot Hub* — Manage your API keys, link new servers, and track daily usage dynamically via the Discord Bot (/panel and /my-sessions). Strict Security Checks* — Heartbeat connections secure your uplink and verify server credentials over standard HTTPS. Zero Lag Performance* — Fully asynchronous networking and async thread scheduling (with native Folia support) to ensure your TPS remains at a perfect 20.0.