Fabric / Forge Mod Installation

This guide covers the installation and configuration of the CraftyAI mod for Fabric and Forge clients/servers.

Requirements

Requirement	Version
Minecraft	1.20+ (Incl. 1.21.x / 1.26.x)
Java	17+ (Recommended 21)
Loader	Fabric + Fabric API, or Forge

:::warning Fabric 1.26 Users Due to mappings changes by Mojang in Minecraft 1.26, you must use the specific craftyai-fabric-26 download. Do not use the standard Fabric download for 1.26.x servers/clients. :::

Installation: Fabric

1. Download Mods: Download the Fabric version of CraftyAI from Modrinth.
2. Download Fabric API: You must also download the Fabric API version that matches your Minecraft version.
3. Install: Place both .jar files into your .minecraft/mods/ directory (or your server's mods/ directory).
4. Launch: Start your game or server.

Installation: Forge

1. Download Mod: Download the Forge version of CraftyAI from Modrinth.
2. Install: Place the .jar file into your .minecraft/mods/ directory (or your server's mods/ directory).
3. Launch: Start your game or server.

Configuration (In-Game Settings)

CraftyAI for mods includes a built-in settings screen that makes configuration incredibly easy.

1. Once in-game, press the K key to open the CraftyAI Settings panel (or type /crafty settings).
2. The screen provides the following options:
   • API Key: Paste your API key here (obtained via Discord).
   • AI Display Name: Change what the AI is called in chat.
   • Mode Toggle: Switch between Cloud (online AI) and Local (offline fallback, if configured).
   • Session ID: Your unique server/client identifier. Click Copy to easily grab it for the Discord bot.
   • Test Connection: Instantly verify your connection to the CraftyAI Gateway.

Configuration (craftyai.json)

If you are running a dedicated server or prefer manual configuration, you can edit the config/craftyai.json file:

{
  "api_key": "your-api-key",
  "ai_name": "Crafty",
  "aliases": ["crafty", "craftyai", "ai", "helper"],
  "prefix": "@",
  "require_prefix": false,
  "cooldown_seconds": 3,
  "ai_enable_actions": true,
  "telemetry_enabled": true
}

Commands

Command	Description
/crafty	Show mod information and status.
/crafty status	View connection diagnostics.
/crafty reload	Reload the configuration file.
/crafty learn Q | A	Teach the AI custom knowledge.
/crafty test	Test the connection to the AI engine.
/crafty settings	Open the in-game settings GUI.

tip

Need an API key? Check out our Getting Your API Key guide.