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, or hand them a tool and a couple of tokens and they'll take on an autonomous Role, like farming a plot completely on their own.

How it works

Routes and roles are both built from Location Tokens — small craftable items you place at the spots you care about. Each token marks what should happen there:

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. Or equip a worker with a tool, a Jobsite Token, and a Deposit Token instead, and they'll work a Role continuously with no scroll required at all.

Features

• Programmable delivery routes — chain any combination of Collect → Craft → Deposit stops, with per-item quantity filters (All / Full Stacks / Partial)
• Autonomous Roles — equip a worker with a tool + Jobsite Token + Deposit Token and they take over a job area on their own
• Farmer role — tills, plants, harvests, and restocks seeds from a linked chest, no input needed once set up
• Shepherd role — shears sheep within range of a jobsite/pen and deposits the wool automatically
• Work Goggles — a helmet that overlays a worker's route in-world (green = collect, red = deliver, gold = both)
• Night-time sleep — Role workers find their assigned Bed Token (or shelter) after dark; toggle it off per-worker if you want them working around the clock
• Five-tab worker GUI — Equipment, Orders, Cargo, Role, and Tasks, all from one screen
• Crafting Tasks — full gather → craft → deposit pipelines, up to 8 rows per worker
• No pipes, no power — logistics run on NPC labour; fits vanilla-adjacent modpacks

Getting started

For delivery routes:

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, add the Scroll in the Orders tab
5. Close the GUI — the worker starts their route immediately

For an autonomous Role (e.g. Farmer):

1. Craft a Jobsite Token and place it at the centre of the work area
2. Craft a Deposit Token and place it at a chest for the harvest/output
3. Right-click a Worker NPC, open the Role tab, and fill the Tool, Jobsite Token, and Deposit Token slots
4. Close the GUI — the kit activates and the worker starts working the role on their own

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

Worker GUI

Location Tokens & Recipes

Admin commands

Requirements

• Minecraft 1.20.1
• Fabric Loader ≥ 0.15.0
• Fabric API 0.92.6+1.20.1
• Java 17+ (runtime) — building from source requires JDK 21

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

• Additional roles: Miner, Woodcutter, Fisher
• Multi-dimension pathfinding
• Footstep and work-complete sounds
• Location Token visual beam at stamped position
• Double-chest support
• 3rd-party storage block compatibility

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