SFM-Flow

ВНИМАНИЕ: АЛЬФА-ВЕРСИЯ. ДОЛЖНА БЫТЬ БЕЗОПАСНА ДЛЯ ОБЫЧНЫХ СОХРАНЕНИЙ, НО НА ВСЯКИЙ СЛУЧАЙ ДЕЛАЙТЕ БЭКАПЫ. ИЗМЕНЕНИЯ API ВСЁ ЕЩЁ ВЕРОЯТНЫ.

SFM-Flow — это полноценный, модернизированный мод для автоматизации на основе визуальных блок-схем, созданный с нуля для NeoForge 1.21.1. Он позволяет проектировать, координировать и выполнять сложные логистические рутины с помощью интерактивного графического полотна блок-схем, специализированных кабелей, модульных карт и физических сетевых узлов.

Основные возможности

1. Интерактивное логическое полотно и меню

• Стандартизированные компактные узлы: Узлы полотна всегда остаются компактными для максимальной видимости рабочего пространства. Настраиваемая градиентная цветовая маркировка помогает организовать активные рутины с первого взгляда.
• Контекстные меню по правому клику: Правый клик по любому узлу открывает аккуратное выпадающее меню для переименования компонента, редактирования настроек, смены цвета узла, копирования или удаления.
• Симметрично центрированные панели настроек: Двойной клик по узлу открывает центрированную модальную панель. Основное полотно затемняется, выделяя ваши текущие задачи по настройке (например, установку периодов на триггере интервала или управление фильтрами на входе предметов).

2. Физические сетевые компоненты

Стройте свою логистическую инфраструктуру с помощью широкого набора физических блоков:

• Менеджер инвентарей машин: Ядро-компьютер сети. Он хранит логику блок-схемы, сканирует соседние кабели и компилирует ваши команды.
• Сетевые кабели (стандартные и укреплённые): Проводящая среда маршрутизации вашей системы. Укреплённые варианты устойчивы к взрывам, чтобы защитить соединения в опасных условиях.
• Кабели-наблюдатели: Электрически бесшумные направленные мониторы обновлений блоков, которые обнаруживают изменения состояния рядом, не испуская стандартных сигналов Redstone.
• Redstone-эмиттер и приёмник сети: Независимые многосторонние менеджеры аналоговых сигналов Redstone, способные обрабатывать уровни от 0 до 15 напрямую через инструкции вашей блок-схемы.
• Люки для предметов и жидкостей: Всасывающие и выбрасывающие люки, которые засасывают предметы с земли в пространстве 3x3x3, выбрасывают сущности предметов в мир или работают с блоками жидкостей в мире.
• Кластеры карт (стандартные и продвинутые): Модульные слоты-подшасси, позволяющие вставить до 9 (стандартные) или 18 (продвинутые) карт выполнения (например, карты всасывания, выброса и Redstone) для выполнения прокси-действий через определённые грани.

3. Симметричные 3D-превью блоков и раскладки слотов

• Вращаемое 3D-превью: При настройке передачи предметов или жидкостей вращайте и осматривайте 3D-превью целевого инвентаря мышью. Левый клик по любой из трёх видимых граней переключает доступ к стороне.
• Тематический конфигуратор слотов: Shift-левый клик по грани 3D-блока открывает кастомную раскладку, показывающую, как именно настроены слоты для этой стороны. Слоты оформлены в стиле печей, крафтеров, варочных стоек, раздатчиков, выбрасывателей или воронок в масштабе 50%, позволяя переключать доступ к каждому слоту с помощью неоново-зелёной (активен) и красной (неактивен) подсветки.

Под капотом: производительность и надёжность

SFM-Flow спроектирован так, чтобы предотвращать скачки тиков сервера и лаги:

• Асинхронное ядро планирования: Вычисления логики обрабатываются вне основного потока на выделенных пулах демон-потоков, не нагружая основной цикл тиков Minecraft.
• Кооперативный бюджет времени в 1 мс: Внепоточные операции разбиваются на небольшие срезы по 1 мс для безопасной координации сетевых задач.
• Обходы без мусора за O(1): Карты физической сети управляются через примитивные массивы ID и пространственную группировку чанков, устраняя лишнее выделение объектов и нагрузку на сборщик мусора.
• Физический автоматический выключатель: Если блок-схема входит в бесконечный цикл, ядро выполнения автоматически срабатывает при превышении порога в 1000 вычисленных узлов, чисто завершая запуск и записывая диагностические данные для отладки.
• Правила оптимизации сети: Пакеты синхронизации оптимизированы так, чтобы отправляться только при отдельных отпусканиях мыши или действиях колесом прокрутки, устраняя флуд пакетами при активном перетаскивании ползунков.

API для разработчиков аддонов (dta.sfmflow.api)

SFM-Flow построен на полностью развязанной, расширяемой архитектуре для создателей аддонов:

• Fluent-билдеры компонентов: Регистрируйте собственные компоненты в реестре sfmflow:flow_component_type с помощью чистого цепочечного FlowComponentBuilder.
• Динамические возможности: Избегайте жёстко прописанных интеграций. Используйте FlowCapabilityRegistry для регистрации расширяемых путей возможностей и колбэков выполнения для кастомных типов передачи предметов, жидкостей, энергии или химикатов.
• Безопасная для сторон система плагинов: Используйте точки входа ISFMFlowPlugin и ISFMFlowClientPlugin, чтобы безопасно отделить правила визуального отображения от серверной логики и избежать проблем с загрузкой классов.
• Адаптеры ванильного UI: Оборачивайте стандартные элементы управления Minecraft в ApiWidgetAdapter, чтобы согласовывать смещения при перетаскивании и сохранять правильный фокус кликов мыши.