Repository navigation
1.20.1 Getting Started
Version: This guide applies to Minecraft 1.20.1 (Forge).
The Work Contract has a default shapeless recipe: paper, ink sac, feather. (Pack makers may have replaced it or hand contracts out from quests; check JEI.)
Use the contract on a block. The worker appears on that spot (or on top of it if the block is solid) and is bound to you.
- Its name comes from a pool of first names. Rename the contract on an anvil first to choose the name (default
nameMode). - On some servers the contract only works on special spots (for example beds), or only after a story stage. The message tells you why it failed.
- You can own a limited number of workers (3 by default), and a chunk holds only a few.
Right-click the worker to open the command screen:
- Left: the tasks this worker knows. Tasks it does not know are hidden, not greyed out.
- Right, STATUS tab: hearts, food and water (classic HUD icons), current task, status line, why it last stopped, and the linked supply container.
- Under the selected task: what it does and, if it cannot start now, the reason (for example "No hand crank within 16 blocks").
- INVENTORY (bottom left) opens the worker's inventory.
- START, STOP, and SUPPLY (link or unlink a supply container, see Needs & Supply).
- SKILLS tab: the worker's XP and its upgrades, see Training.
Every new worker knows Follow and Hold position. Other tasks are learned from training manuals.
Sneak + right-click (or INVENTORY in the command screen) opens the inventory: armor, main hand and off hand on top with small hearts, food and water rows beside them, then 27 storage slots. Put food and drink here; the worker eats and drinks on its own when it gets hungry or thirsty. Tools for its tasks go here too (a hoe for farming).
Work costs food and water. A worker that is low on either works slower; at zero it stops and says so. A well-fed worker heals over time, like a player. Link a supply container and it fetches food and drink by itself.
While it works it earns XP. Use XP and a training manual to teach new tasks, and XP alone to buy upgrades.
- You log out: by default your workers pause until you are back.
- The chunk unloads: the worker does nothing; nothing is force-loaded.
- It dies: by default it is gone for good and drops its items. Servers can switch to respawning after a cooldown.
- Someone else right-clicks it: only you (and, with FTB Teams, your teammates) can command it. You and your teammates cannot hurt it by accident.
Rat Worker is released under the MIT license. Author: Stefano Manca.
Guides & Reference
Scripting & Mod API
Version Overviews