Repository navigation
1.20.1 Training
Version: This guide applies to Minecraft 1.20.1 (Forge).
Each worker has its own experience (XP), its own list of learned tasks and its own upgrades. Two workers of the same player can be trained differently.
- A worker earns XP while it runs a task: 5 XP per minute (
xpPerMinute) times the task's XP rate (follow x1, hold position x0.5, crank x1.5, farm x1.5). - XP is shown in the command screen header.
- Servers can turn work XP off (
xpFromWork = false) and give XP only from scripts, quests or commands.
Follow and Hold position are known by every worker. Any other task needs a Training Manual for that task:
- Hold the manual and right-click the worker.
- If the worker has enough XP (crank 30, farm 40), the XP is spent, the manual is used up, and the task appears in the command screen.
- Otherwise the message says how much XP it needs and how much it has.
A manual is the item ratworker:tome with the task in its NBT, for example /give @p ratworker:tome{Task:"ratworker:crank"}. Add Xp:0 to make it free: ratworker:tome{Task:"ratworker:crank",Xp:0}. JEI lists one manual per task.
Any item can be a manual. A modpack can make its own manual items (for example with KubeJS), give them their own name, texture and recipe, and say which task each teaches and what it costs, with a datapack or with KubeJS (see Datapacks and KubeJS Integration). Such items show in JEI like any other item.
Default recipes of the built-in manual:
| Manual | Recipe (shapeless) |
|---|---|
| Turn crank | book, Create hand crank, andesite alloy (only with Create) |
| Farm | book, iron hoe, wheat seeds |
Modpacks usually replace these recipes so each manual needs the materials of the right stage of the pack. There is no other gate: if you can make the manual, you can teach the task.
Operators get no shortcut here (the command screen shows the same tasks for everyone). Use /ratworker skills <workers> learn <task> instead.
Open the SKILLS tab of the command screen. Each row shows the level as small squares, the XP cost of the next level, and a + button.
| Branch | Applies to | Max level | Effect per level |
|---|---|---|---|
| Health | the worker | 5 | +2 max health (one heart) |
| Strength | the worker | 5 | +1 attack damage |
| Hunger | one task | 5 | -10 % food loss while that task runs |
| Thirst | one task | 5 | -10 % water loss while that task runs (only with Thirst Was Taken) |
| Speed | crank, farm, script tasks that enable it | 6 | crank: -2 ticks between clicks; farm: -10 % time between actions |
- Health and Strength are shown at the top. The branches of the task selected in the list are shown below it.
- Cost of the next level = base cost x growth ^ current level. Health and Strength: 20 XP, then x1.5 per level. Task branches: 15 XP, then x1.5.
- All numbers are in the
[skills]section of the server config. - Hunger and Thirst only help while that task runs: a worker trained for the crank is still hungry while it farms.
Rat Worker is released under the MIT license. Author: Stefano Manca.
Guides & Reference
Scripting & Mod API
Version Overviews