SF-Cargo

SF-Cargo предоставляет систему управления грузовыми сетями, вдохновленную механикой Slimefun, но работающую как независимый плагин.

SF-Cargo — это специализированный плагин для создания продвинутых систем транспортировки предметов, который служит альтернативой стандартным воронкам. Проект представляет собой независимую реализацию концепции грузовых сетей Slimefun, исключая из него системы машин, исследований, энергии и другие элементы экосистемы.

Плагин фокусируется на функционале грузовых сетей, предоставляя следующие ключевые элементы:

• Cargo Managers: обнаруживают и координируют подключенные грузовые сети.
• Cargo Connectors: расширяют сети до 6 блоков в длину по прямым линиям.
• Cargo Input Nodes: извлекают предметы из присоединенных инвентарей.
• Cargo Output Nodes: помещают предметы в поддерживаемые блоки хранения.

Каждая сеть поддерживает до 16 грузовых каналов. Плагин предлагает гибкие настройки для управления потоками ресурсов:

• Фильтры ввода: поддержка режимов белого и черного списков (whitelist/blacklist).
• Методы заполнения: возможность выбора между режимом Smart-fill и Round-robin.
• Безопасность данных: перед извлечением предметов узел ввода проверяет свободное место в пункте назначения. Перемещения фиксируются в журнале в оперативной памяти для обеспечения возможности отката при сбоях.

SF-Cargo оптимизирован для работы на платформах Folia и Paper. Логика грузовых сетей выполняется в собственном цикле воркеров. На серверах Folia доступ к инвентарям и миру безопасно планируется обратно в регион владельца, что соответствует правилам многопоточности. На серверах Paper работа с инвентарями выполняется в основном потоке сервера.

Для удобства управления администраторы могут использовать следующие команды:

/sfcargo give
/sfcargo reload
/sfcargo list
/sfcargo tps

Команда /sfcargo list отображает известные менеджеры грузовых сетей, их владельцев, UUID и местоположение с возможностью телепортации. Команда /sfcargo tps предоставляет данные о здоровье цикла грузовой системы, очередях перемещения, времени ожидания и статусе журнала.

Узлы вывода поддерживают стандартные контейнеры: сундуки, ловушки для предметов, бочки, шалкеровые ящики, воронки, дропперы и раздатчики. Внимание: шалкеровые ящики нельзя помещать внутрь других шалкеровых ящиков.

Данные о блоках грузовых сетей хранятся в файле plugins/SF-Cargo/blocks.yml. Размещенные головы грузовых сетей имеют маркер плагина: если файл YAML будет утерян, при разрушении блока выпадет соответствующий предмет SF-Cargo для повторной регистрации.