Installation

This guide will walk you through installing Alchemy on your Minecraft Fabric server.

Prerequisites

Before installing Alchemy, ensure you have:

Download the latest Alchemy JAR file and place it in your server’s mods folder.

Start your server to generate the default configuration:

config/alchemy/
├── config.json
└── transmutations/
    └── (empty - add your rules here)

Create your transmutation rule files in config/alchemy/transmutations/. Each file should contain a JSON object with a conversions array.

Example file structure:

config/alchemy/transmutations/
├── oraxen_migration.json
├── itemsadder_migration.json
└── custom_conversions.json

Restart your server to load the transmutation rules. You should see log messages indicating how many rules were loaded:

[Alchemy] Loaded 5 transmutation rules from oraxen_migration.json
[Alchemy] Loaded 3 transmutation rules from itemsadder_migration.json

The config.json file contains general Alchemy settings:

{
  "enableTransmutation": true,
  "logConversions": false,
  "debugMode": false
}

Setting	Type	Default	Description
`enableTransmutation`	boolean	`true`	Enable/disable the transmutation system
`logConversions`	boolean	`false`	Log each item conversion (useful for debugging)
`debugMode`	boolean	`false`	Enable detailed debug logging

See the Transmutation System Overview for detailed information on creating conversion rules.

To verify Alchemy is working correctly:

Now that Alchemy is installed, learn how to create transmutation rules: