NPC Logistics

NPC Logistics

Tired of running between chests yourself? NPC Logistics lets you hire worker NPCs and put them to work — collecting, crafting, and delivering items along programmable routes while you get on with the rest of your build.

---

How it works

You define a route using Location Tokens — small items you craft and place at the spots you care about. Each token marks what the worker should do there:

Token	Colour	Action
Collect Token	🔵 Blue	Pick up items from this container
Craft Token	🟡 Amber	Craft a recipe at this station
Deposit Token	🟢 Green	Drop off items into this container

Hand a Work Order Scroll to a worker NPC, configure the route in their GUI, and they'll walk the loop autonomously — collecting, processing, and depositing without any further input from you.

---

Features

• Programmable delivery routes — chain any combination of Collect → Craft → Deposit stops
• Worker NPC entities — hire them, equip them, and assign multiple orders per worker
• Work Order Scroll — the single item that defines and stores a route
• Three-tab worker GUI — manage Equipment, Orders, and active Tasks from one screen
• Stackable orders — one worker can carry multiple work orders and cycle through them
• No pipes, no power — logistics run on NPC labour; fits vanilla-adjacent modpacks

---

Getting started

1. Craft a Work Order Scroll — this becomes the worker's instruction sheet
2. Craft Location Tokens for each stop on the route (Collect, Craft, or Deposit)
3. Place the tokens at each chest, crafting station, or storage block
4. Right-click a Worker NPC to open their GUI
5. Add the Scroll in the Orders tab and link your tokens in order
6. Close the GUI — the worker starts their route immediately

Workers are persistent, survive server restarts, and resume their last active order on load.

---

Worker GUI

Tab	What you do here
Equipment	Armour and tool slots — keep your worker safe and efficient
Orders	Add, remove, and reorder Work Order Scrolls
Tasks	Live view of the worker's current step and inventory

---

Admin commands

Command	Effect
/npclogistics list	List all active workers and their current order
/npclogistics stop <id>	Pause a specific worker
/npclogistics reset <id>	Clear a worker's active task
/npclogistics reload	Reload config without restarting

---

Requirements

• Minecraft 1.20.1
• Fabric Loader ≥ 0.15.0
• Fabric API
• Java 17+

---

Compatibility

NPC Logistics is storage-agnostic — workers interact with any block that exposes a standard inventory. It works alongside storage mods (Tom's Simple Storage, Refined Storage, AE2) without conflict.

---

Roadmap

• Fluid transport support
• Multi-worker route sharing
• Route visualiser (in-world overlay)
• Configurable worker speed and carry capacity
• GUI improvements

---

MIT licensed · Source on GitHub · Report issues on the issue tracker