Fabric / Forge Mod Installation

This guide covers Fabric and Forge, both for singleplayer and dedicated servers.

Requirements

| Minecraft | 1.20.4–1.21.1 (Fabric), Forge 1.20.4 & 1.20.6 (separate jars), Fabric 1.20.4–26.x, or NeoForge 26.x | | Bedrock Edition | Supported via GeyserMC / Floodgate on dedicated mod servers | | Java | 17 or newer; Java 21 required for MC 1.20.5+ / Forge 1.20.6 (Java 25 required for MC 26.x execution) | | Loader | Fabric + Fabric API, Forge, or NeoForge |

Install on Fabric

1. Download CraftyAI from Modrinth.
2. Download Fabric API for your Minecraft version.
3. Put both JARs into .minecraft/mods/ (or your server's mods/ folder).
4. Launch the game.

If you're on MC 1.26, use the craftyai-fabric-26 download. The standard Fabric build works on 1.20.4 through 1.21.1.

Install on Forge / NeoForge

1. Download CraftyAI from Modrinth.
2. Pick the right JAR for your Minecraft version: craftyai-forge for 1.20.4, craftyai-forge-1206 for 1.20.6 (1.20.5+ requires Java 21).
3. Put the JAR into .minecraft/mods/ (or your server's mods/ folder).
4. Launch the game.

If you're on MC 1.26 with NeoForge, use the craftyai-forge-26 download.

Note: Forge mods are version-locked — a jar built for 1.20.4 will not load on 1.20.6 and vice versa. Always use the jar that matches your exact Minecraft version.

Configure from the in-game menu

Press M in-game (all mod loaders — rebindable in Controls) to open the CraftyAI settings panel. On first launch, the mod generates an API key for you and fills it in automatically. You don't need to do anything else.

The settings panel has:

• API Key — Auto-filled on first launch
• AI Display Name — Change what the AI is called (default: "Crafty")
• Mode — Cloud (online AI) or Local (offline fallback)
• Custom Provider — Use your own AI key instead of ours
• Agentic Tasks — Let the AI change time, weather, give items, etc.

Configure by editing the file

If you'd rather edit the config directly, it's at config/craftyai.json:

{
  "api_key": "your-api-key",
  "ai_name": "Crafty",
  "ai_enable_actions": true,
  "allow_block_scanning": true
}

The fields not shown here have sensible defaults. You only need to set the key and your AI name in most cases.

Commands

Command	What it does	Platform Support
/crafty	Show mod info	Mod & Plugin
/crafty status	Check connection	Mod & Plugin
/crafty ask <question>	Ask AI privately	Mod & Plugin
/crafty scan	Scan nearby area	Mod & Plugin
/crafty confirm	Confirm a destructive action	Mod & Plugin
/crafty link	Link server to Discord (admin)	Mod & Plugin
/crafty reload	Reload configuration (admin)	Mod & Plugin
/crafty pro help	Show Pro key instructions	Mod & Plugin
/crafty pro status	Show current subscription tier	Mod & Plugin
/crafty pro redeem <key>	Redeem a Pro key	Mod & Plugin
/craftyclient	In-game client config screen	Fabric/Forge Client
/crafty memory	View stored RAG memories	Spigot/Paper Plugin
/crafty forget [n]	Forget a specific memory or all	Spigot/Paper Plugin
/crafty privacy <on|off>	Toggle server-wide RAG memory opt-out	Spigot/Paper Plugin
/crafty mode <local|cloud>	Toggle forced local offline mode	Spigot/Paper Plugin
/crafty prompt set <text>	Set custom AI system prompt	Spigot/Paper Plugin (Pro)

Need an API key?

See Getting Your API Key.