NPC Logistics
厌倦了自己来回跑动搬运物品了吗? NPC Logistics 允许你雇佣工人 NPC 并让他们工作——在可编程的路线上收集、制作和运送物品,或者给他们一把工具和几个令牌,让他们承担一个自主的角色(Role),例如完全独立地耕种一块农田。
工作原理
路线和角色都由**位置令牌(Location Tokens)**构建而成——这些是可以制作的小物品,放置在你关心的地点。每个令牌标记了在该地点应执行的操作:
| 令牌 |
颜色 |
用途 |
| 收集令牌 (Collect Token) |
? 蓝色 |
从此容器中拾取物品 |
| 制作令牌 (Craft Token) |
? 琥珀色 |
在此工作台制作配方 |
| 存入令牌 (Deposit Token) |
? 绿色 |
将物品投入此容器 |
| 工作地点令牌 (Jobsite Token) |
? 紫色 |
角色工人的作业区域中心点 |
| 床令牌 (Bed Token) |
? 浅蓝色 |
指定角色工人夜间睡觉的位置 |
将**工单卷轴 (Work Order Scroll)**交给工人 NPC,在其图形用户界面(GUI)中配置路线,他们就会自动行走循环——无需你任何额外输入即可进行收集、处理和存入。或者,给工人配备工具、工作地点令牌和存入令牌,他们将持续执行角色任务,完全不需要工单卷轴。
功能特性
- 可编程配送路线 —— 组合任意数量的 收集 → 制作 → 存入 站点,支持按物品数量筛选(全部 / 满组 / 部分)
- 自主角色 (Autonomous Roles) —— 给工人配备工具 + 工作地点令牌 + 存入令牌,他们便会接管一块作业区域自行工作
- 农夫角色 —— 翻土、种植、收获,并从关联的箱子中补充种子,设置好后无需任何干预
- 牧羊人角色 —— 剪切工作地点/围栏范围内绵羊身上的羊毛,并自动存入
- 工作护目镜 (Work Goggles) —— 一种头盔,可在世界中叠加显示工人的路线(绿色 = 收集,红色 = 交付,金色 = 两者兼有)
- 夜间睡眠 —— 角色工人在天黑后会找到分配的床令牌(或庇护所);如果你希望他们全天候工作,可以针对单个工人关闭此功能
- 五标签工人 GUI —— 装备、工单、货物、角色和任务,全部在一个屏幕中管理
- 制作任务 (Crafting Tasks) —— 完整的 采集 → 制作 → 存入 流水线,每名工人最多支持 8 行
- 无需管道,无需动力 —— 物流依靠 NPC 劳动力运行;适合类原版整合包
入门指南
对于配送路线:
- 制作工单卷轴 —— 这将作为工人的指令表
- 为路线上的每个站点制作位置令牌(收集、制作或存入)
- 将令牌放置在每个箱子、制作台或存储方块旁
- 右键点击工人 NPC 打开其 GUI,在“工单”标签页中添加卷轴
- 关闭 GUI —— 工人立即开始执行路线
对于自主角色(例如农夫):
- 制作工作地点令牌 并将其放置在作业区域的中心
- 制作存入令牌 并将其放置在用于收获/输出的箱子旁
- 右键点击工人 NPC,打开“角色”标签页,填入工具、工作地点令牌和存入令牌的槽位
- 关闭 GUI —— 套件激活,工人开始自行执行角色任务
工人是持久化的,会保留服务器重启前的状态,并在加载时恢复其最后一个活跃的工单或角色。
工人 GUI
| 标签页 |
此处操作内容 |
| 装备 (Equipment) |
盔甲、工具、工单卷轴槽位、重命名、自定义皮肤 URL |
| 工单 (Orders) |
查看和管理活跃的工单卷轴及其站点 |
| 货物 (Cargo) |
仅查看模式,显示工人携带的所有物品的 18 格视图 |
| 角色 (Role) |
3 格套件(工具 / 工作地点令牌 / 存入令牌),授予自主角色,以及“夜间睡眠”开关 |
| 任务 (Tasks) |
最多 8 行制作任务行 —— 每行包含收集、配方、制作和存入槽位 |
位置令牌与配方
| 物品 |
配方 |
| 工单卷轴 (Work Order Scroll) |
纸 + 纸 + 羽毛 + 墨囊 |
| 收集令牌 (Collect Token) |
金锭 + 青金石 |
| 制作令牌 (Craft Token) |
金锭 + 烈焰粉 |
| 存入令牌 (Deposit Token) |
金锭 + 绿宝石 |
| 工作地点令牌 (Jobsite Token) |
金锭 + 指南针 |
| 床令牌 (Bed Token) |
金锭 + 羽毛 |
| 工作护目镜 (Work Goggles) |
玻璃板 ×2 + 铁锭 + 金锭 |
管理员命令
| 命令 |
效果 |
/workorder spawn [x y z] |
生成一名物流工人 |
/workorder addstop <worker> <x y z> collect|deliver|both |
向工人的路线添加一个站点 |
/workorder startorder <worker> "Route Name" |
启动一条命名的路线 |
/workorder cancel <worker> |
取消工人的当前工单 |
/workorder status <worker> |
报告工人的当前状态 |
/workorder setrepeating <worker> true|false |
切换路线是否重复执行 |
需求
- Minecraft 1.20.1
- Fabric Loader ≥ 0.15.0
- Fabric API 0.92.6+1.20.1
- Java 17+(运行时)—— 从源代码构建需要 JDK 21
兼容性
NPC Logistics 对存储方式无特定要求——工人可以与任何暴露标准库存接口的方块交互。它与存储模组(如 Tom's Simple Storage、Refined Storage、AE2)共存且无冲突。
路线图
- 新增角色:矿工、伐木工、渔夫
- 多维度寻路
- 脚步声和工作完成音效
- 在放置位置显示位置令牌的视觉光束
- 双层箱子支持
- 第三方存储方块兼容性
MIT 许可证 · GitHub 源码 · 问题反馈请前往 Issue Tracker
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:
| Token |
Colour |
Purpose |
| 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 |
| Jobsite Token |
? Purple |
Centre point of a Role worker's job area |
| Bed Token |
? Light blue |
Assigns where a Role worker sleeps at night |
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:
- Craft a Work Order Scroll — this becomes the worker's instruction sheet
- Craft Location Tokens for each stop on the route (Collect, Craft, or Deposit)
- Place the tokens at each chest, crafting station, or storage block
- Right-click a Worker NPC to open their GUI, add the Scroll in the Orders tab
- Close the GUI — the worker starts their route immediately
For an autonomous Role (e.g. Farmer):
- Craft a Jobsite Token and place it at the centre of the work area
- Craft a Deposit Token and place it at a chest for the harvest/output
- Right-click a Worker NPC, open the Role tab, and fill the Tool, Jobsite Token, and Deposit Token slots
- 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
| Tab |
What you do here |
| Equipment |
Armour, tools, Work Order Scroll slots, rename, custom skin URL |
| Orders |
View and manage active Work Order Scrolls and their stops |
| Cargo |
Take-only 18-slot view of everything the worker is carrying |
| Role |
3-slot kit (Tool / Jobsite Token / Deposit Token) that grants an autonomous Role, plus a Sleep at Night toggle |
| Tasks |
Up to 8 crafting task rows — Collect, Recipe, Craft, and Deposit slots per row |
Location Tokens & Recipes
| Item |
Recipe |
| Work Order Scroll |
Paper + Paper + Feather + Ink Sac |
| Collect Token |
Gold Ingot + Lapis Lazuli |
| Craft Token |
Gold Ingot + Blaze Powder |
| Deposit Token |
Gold Ingot + Emerald |
| Jobsite Token |
Gold Ingot + Compass |
| Bed Token |
Gold Ingot + Feather |
| Work Goggles |
2× Glass Pane + Iron Ingot + Gold Ingot |
Admin commands
| Command |
Effect |
/workorder spawn [x y z] |
Spawn a Logistics Worker |
/workorder addstop <worker> <x y z> collect|deliver|both |
Add a stop to a worker's route |
/workorder startorder <worker> "Route Name" |
Start a named route |
/workorder cancel <worker> |
Cancel the worker's current order |
/workorder status <worker> |
Report a worker's current status |
/workorder setrepeating <worker> true|false |
Toggle whether a route repeats |
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧