CraftTweaker
Adjustments to recipes and mod behavior — the server sets its own rules.
← Mods Operations and overviews license MIT guide for CraftTweaker (Forge, NeoForge, Fabric) — version for your game version
Download from the author Source code 4 152 495 download from the author
What does it do?
CraftTweaker changes recipes. Not through some menu, but with a script: a file is written that states what should be added, removed, or changed — and the server starts following it. It is a tool for operators, not for ordinary players.
Typical uses: disable an overly powerful item, add a recipe for something missing from the modpack, or conversely remove a recipe (for example, so players have to take a longer path). When multiple mods run on a server at once, CraftTweaker is often the only way to reconcile their recipes with one another.
Scripts are written in the ZenScript language and reside in the scripts folder in the world or in the instance. The server loads them at startup; if there is an error in them, the recipe simply won't change. That is why the crafttweaker.log file is important — errors are printed there, including the line number.
CraftTweaker is primarily a server-side tool: recipes apply to all players, even if they do not have the mod installed. On the client, it is used mainly so that players see the correct recipes in JEI.
Important rule: back up your scripts. If you lose the scripts folder after updating the modpack, the recipes return to their default state and players will notice immediately — usually because something cannot be crafted.
Installation
- CraftTweaker is mainly a server-side mod — it is installed on the server; on players it is used for correct recipe display.
- Find out the server loader (Forge, NeoForge, or Fabric) and download CraftTweaker from modrinth.com/mod/crafttweaker for your game version.
- Stop the server and back up the world and the scripts folder.
- Upload the .jar to the mods folder on the server.
- Start the server and try the
/ct helpcommand — it must list the commands. - Create a scripts folder (the
/ct scriptscommand will show where it should be) and put a simple script in it. - Check the script with the
/ct syntaxcommand — it will list errors without applying the changes. - Load the changes with the
/reloadcommand (it reloads datapacks and then scripts). - Verify in game that the recipe has actually changed (in JEI or at the crafting table).
- If the change does not take effect, open
crafttweaker.log— the error will be there, including the line number. - Tell players what changed. Recipe changes are visible to them and, without explanation, look like a server error.
- Back up the scripts folder with every modpack change — otherwise you will lose your recipe modifications.
Commands
Type it in chat with slashes as well. Where is it? <player> or <uzel>, fill in your own value without brackets.
| Command | What does it do? |
|---|---|
| /ct help | lists all CraftTweaker commands |
| /ct hand | prints out the item in hand (id and tags) and copies it to the clipboard |
| /ct syntax | goes through the scripts and prints errors without applying the changes |
| /ct scripts | shows the path to the scripts folder (in the server console it prints it to the log) |
| /reload | reloads datapacks and then the server scripts |
| /ct examples | creates a folder with example scripts for your version |
Configuration and common mistakes
CraftTweaker is a tool for operators. Regular players don't need to know about it, but they will feel the recipe changes — explain them to them.
Before editing recipes, back up the scripts folder. Updating the modpack is the most common reason people lose them.
An error in the script won't crash the server, the change just won't take effect. Always check crafttweaker.log; errors are there even with line numbers.
Before loading scripts, use /ct syntax — it lists errors without applying the changes. It saves you a server restart.
Recipes apply to all players, even if they don't have the mod installed. There's no need to force them to install it (recommending it for display in JEI is enough).
A recipe change is immediately visible to players. If you don't announce it, they'll think the server isn't working correctly.
For simpler recipe edits, datapacks also exist (the vanilla way). CraftTweaker is worth using where datapacks aren't enough — for example, when you need to edit recipes from mods.
Who uses it?
Servers from our list that use this mod:
Do you use it on your server? Write to us and we'll add it to the list.
Similar mods
Where does the guide come from?
The guide is our own and is based on the author's documentation. We describe permissions and commands as facts, we don't make anything up — if mod changes after an update, the guide may be out of date. (version CraftTweaker (Forge, NeoForge, Fabric) — version for your game version) Did you find an error? Write to us and we'll fix it.
License: MIT. The file isn't hosted with us; it's downloaded from the author at — that way the current version is always available.