Cooldown Coordinator

Библиотека-помощник для разработчиков модов, позволяющая создавать согласованные сети передачи предметов, где задержки (cooldown) синхронизируются между стандартными хопперами и модовыми блоками.

Суть работы библиотеки

Главная цель Cooldown Coordinator — обеспечить предсказуемое поведение в гетерогенных сетях, состоящих из стандартных хопперов и модифицированных блоков переноса предметов. Мод решает проблему несовместимости логики задержек: позволяет системам сортировки, включающим смесь ванильных и модовых компонентов (например, трубы или специализированные конвейеры), работать как единое целое. Благодаря этому предметы перемещаются по сети последовательно и плавно, избегая ситуаций, когда несколько механизмов пытаются захватить один и тот же предмет одновременно.

Техническая реализация

Проект предоставляет разработчикам интерфейс для реализации и метод вызова, который срабатывает при необходимости применить задержку. Вызов метода безопасен для любого объекта BlockEntity. Если целевой блок реализует этот интерфейс, он получает уведомление о наступлении момента задержки и может выполнить необходимые действия. При установке библиотеки все наследники класса HopperBlockEntity, которые не переопределяют методы insert() и innermost transfer(), автоматически начинают реализовывать интерфейс и участвовать в координации с другими блоками.

Инструкция для разработчиков

Для корректной работы координации реализаторам модов необходимо уделить особое внимание деталям, в частности, определить точный момент, когда должна срабатывать задержка. Ошибки в этой логике могут привести к сбою всей системы передачи. Для получения подробной информации о том, как правильно внедрить библиотеку в свой проект, рекомендуется изучить официальную документацию (javadocs) проекта или обратиться к документации на вики.

Планы развития проекта

Автор проекта, gniftygnome, выразил желание видеть эту библиотеку или её аналог в составе Fabric API. На текущий момент проект находится в стадии разработки (WIP) и рассматривается как проект для предварительного обсуждения (RFC). Если библиотека продемонстрирует ожидаемую эффективность и получит интерес со стороны сообщества Fabric, автор планирует поддерживать её разработку до момента интеграции в основной API или появления более подходящего решения.