NPC Logistics

NPC Logistics

Устали сами бегать между сундуками? NPC Logistics позволяет нанимать рабочих NPC и загружать их делом — они собирают, крафтят и доставляют предметы по программируемым маршрутам, а если дать им инструмент и пару токенов, они возьмутся за автономную роль, например, будут полностью самостоятельно обрабатывать участок.

Как это работает

Маршруты и роли строятся из токенов локаций — небольших крафтящихся предметов, которые вы размещаете в нужных местах. Каждый токен отмечает, что должно происходить в этой точке:

Дайте рабочему NPC свиток рабочего задания, настройте маршрут в его интерфейсе, и он будет автономно ходить по циклу — собирать, обрабатывать и складывать без вашего дальнейшего участия. Или вместо этого снабдите рабочего инструментом, Jobsite Token и Deposit Token, и он будет непрерывно выполнять роль вообще без свитка.

Возможности

• Программируемые маршруты доставки — соединяйте любые комбинации остановок Collect → Craft → Deposit с фильтрами количества по предметам (All / Full Stacks / Partial)
• Автономные роли — снабдите рабочего инструментом + Jobsite Token + Deposit Token, и он сам возьмётся за рабочую зону
• Роль фермера — вспахивает, сажает, собирает урожай и пополняет запасы семян из привязанного сундука, после настройки участие не требуется
• Роль пастуха — стрижёт овец в радиусе рабочей зоны/загона и автоматически складывает шерсть
• Work Goggles — шлем, который отображает маршрут рабочего в мире (зелёный = сбор, красный = доставка, золотой = и то и другое)
• Ночной сон — роль-рабочие после наступления темноты находят назначенный Bed Token (или укрытие); можно отключить это для каждого рабочего отдельно, если хотите, чтобы они работали круглосуточно
• Интерфейс рабочего с пятью вкладками — Equipment, Orders, Cargo, Role и Tasks, всё на одном экране
• Задачи крафта — полные цепочки собрать → скрафтить → сложить, до 8 строк на рабочего
• Без труб, без энергии — логистика работает на труде NPC; подходит для модпаков, близких к ваниле

С чего начать

Для маршрутов доставки:

1. Скрафтите свиток рабочего задания — он станет инструкцией для рабочего
2. Скрафтите токены локаций для каждой остановки маршрута (Collect, Craft или Deposit)
3. Разместите токены у каждого сундука, станции крафта или блока хранения
4. Нажмите ПКМ по рабочему NPC, чтобы открыть его интерфейс, добавьте свиток во вкладке Orders
5. Закройте интерфейс — рабочий сразу начнёт маршрут Для автономной роли (например, фермера):
6. Скрафтите Jobsite Token и разместите его в центре рабочей зоны
7. Скрафтите Deposit Token и разместите его у сундука для урожая/результата
8. Нажмите ПКМ по рабочему NPC, откройте вкладку Role и заполните слоты Tool, Jobsite Token и Deposit Token
9. Закройте интерфейс — набор активируется, и рабочий сам начнёт выполнять роль Рабочие сохраняются, переживают перезапуски сервера и возобновляют последнее активное задание или роль при загрузке.

Интерфейс рабочего

Токены локаций и рецепты

Команды администратора

Требования

• 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 · Сообщайте о проблемах в трекере задач