Fabric / Forge Mod Installation

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

Requirements

	Version
Minecraft	1.20.4–1.21.1 or 26.x
Java	17 or newer (21 recommended)
Loader	Fabric + Fabric API, or Forge

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 only works on 1.20.4 through 1.21.1.

Install on Forge

1. Download CraftyAI from Modrinth.
2. Put the JAR into .minecraft/mods/ (or your server's mods/ folder).
3. Launch the game.

Configure from the in-game menu

Press K in-game 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
/crafty	Show mod info
/crafty status	Check connection
/crafty test	Send a test message
/crafty apikey	Generate a new API key
/crafty pro status	Show your current tier
/crafty pro redeem <key>	Redeem a Pro key
/crafty link	Get a code to link this server to your Discord

Need an API key?

See Getting Your API Key.