Repository navigation
1.20.1 Commands
Version: This guide applies to Minecraft 1.20.1 (Forge).
<workers> is an entity selector, for example @e[type=ratworker:worker,distance=..8]. Operators can target any worker; other players only workers they can command, and only for the commands marked "players" (when general.allowCommands is on).
| Command | Who | Effect |
|---|---|---|
/ratworker task <workers> <task> |
players | Starts a task. Players need the task to be known by the worker. |
/ratworker stop <workers> |
players | Stops the current task. |
/ratworker needs get <workers> |
players | Shows food and water. |
/ratworker needs set <workers> <food> <water> |
op | Sets both meters (0 to 20). |
/ratworker supply <workers> set <pos> / clear
|
players | Links or clears the supply container. |
/ratworker skills <workers> get |
op | XP, learned tasks and upgrade levels. |
/ratworker skills <workers> xp <amount> |
op | Adds XP (negative removes). |
/ratworker skills <workers> learn <task> / forget <task>
|
op | Teaches or removes a task. |
/ratworker skills <workers> node <node> <level> |
op | Sets an upgrade level. Nodes: health, strength, <task>#hunger, <task>#thirst, <task>#speed. |
/ratworker spawn [name] |
op | A worker owned by you at your position. |
/ratworker list |
players | Your workers, also unloaded ones, with position. |
/ratworker unlock <players> <task or stage> / lock ...
|
op | STAGES mode unlock record. A task id stores its stage; any other text is stored as a stage (for example ratworker_recruit). |
/ratworker config get <key> |
op | Shows a value; preset keys also show the resolved value. |
/ratworker config set <key> <value> |
op | Changes a value and saves the file. Applies at once. |
/ratworker config reload |
op | Re-reads the file from disk. |
Task ids without a namespace mean ratworker:<id> (follow, crank). Config keys use dots: needs.drainMultiplier, tasks.crank.holdInterval.
Quick test: /give @s ratworker:contract, use it on the ground, then /ratworker skills @e[type=ratworker:worker,distance=..5] xp 100 and /give @s ratworker:tome{Task:"ratworker:crank"}.
FTB Quests command rewards (run as the server, @p = the player):
- give a manual:
/give @p ratworker:tome{Task:"ratworker:farm"} - give a named contract:
/give @p ratworker:contract{WorkerName:"Nick"} - give XP to the workers nearby:
/ratworker skills @e[type=ratworker:worker,distance=..8] xp 50
Rat Worker is released under the MIT license. Author: Stefano Manca.
Guides & Reference
Scripting & Mod API
Version Overviews