Luminance Block Entities - Fabric
Представьте сундук, который начинает мягко светиться, когда вы кладёте в него факел, или печь, чьё свечение плавно затухает по мере остывания. Именно такие сценарии открывает Luminance Block Entities - Fabric — утилитарный API, который позволяет блочным сущностям излучать свет в мир так же, как это делают блок светокамня или редстоун-лампа. Но есть важное отличие: в отличие от ванильных источников света, этот мод полностью отказывается от блокстейтов, что делает его идеальным для проектов с множеством состояний блоков и тонким контролем освещения.
Что даёт мод и кому он нужен
По сути перед нами не обычное дополнение с новыми блоками, а инструмент для разработчиков и сборок, где важна динамика освещения. Если вы играете и встретили мод, который требует эту библиотеку как зависимость, ничего настраивать вручную не придётся — достаточно положить jar-файл в папку mods рядом с остальными модами. Всё остальное сделает загрузчик.
Главная фишка в том, что свет привязывается к блочной сущности, а не к состоянию блока. Это значит, что вы можете менять яркость на лету, не переключая десятки блокстейтов и не вызывая лишних обновлений чанков. Для модов с механизмами, машинами, лампами с регулировкой или магическими алтарями это настоящая находка.
Поддерживаемые версии и загрузчик
Как понятно из названия, Luminance Block Entities - Fabric работает исключительно на загрузчике Fabric. Автор прямо просит прощения у поклонников Forge, но поддержки этой платформы нет. Что касается версий Minecraft, мод ориентирован на актуальные сборки Fabric в линейке 1.20.x и смежных релизах — перед установкой всегда сверяйте совместимость на странице проекта, так как API обновляется вместе с игрой.
Как установить
Установка максимально простая и не требует глубоких знаний. Вот пошаговый порядок действий:
- Убедитесь, что у вас установлен Fabric Loader и Fabric API подходящей версии.
- Скачайте Luminance Block Entities - Fabric с официальной страницы проекта или из проверенного каталога.
- Откройте папку mods в директории вашего профиля Minecraft.
- Переместите скачанный jar-файл в эту папку.
- Запустите игру через профиль Fabric и проверьте, что мод загрузился без ошибок.
Если вы не хотите возиться с ручным переносом файлов и поиском совместимых версий, обратите внимание на лаунчер foxygame.net: в его каталоге дополнений Luminance Block Entities - Fabric можно поставить в один клик, а лаунчер сам подберёт корректную сборку Fabric под вашу версию игры.
Тем, кто хочет скачать Luminance Block Entities - Fabric для Minecraft в составе крупной сборки, стоит помнить: библиотека не конфликтует с другими модами на освещение, если те не переопределяют ту же логику блочных сущностей. В спорных случаях проверяйте порядок загрузки и логи.
Для разработчиков: как использовать API
Если вы пишете собственный мод, интеграция выглядит логично и не требует сложных костылей. Сначала поместите jar в среду разработки Fabric и добавьте в build.gradle репозиторий flatDir с путём к файлу, а в зависимости — строку modImplementation с координатами библиотеки. Не забудьте заменить номер версии на актуальный.
Класс LuminanceBlockEntity и поведение света
Вместо наследования от обычного BlockEntity ваша сущность должна расширять LuminanceBlockEntity. Конструктор потребует параметр LuminanceBehavior — перечисление с тремя режимами:
- IGNORE — используется только свет от блочной сущности, блокстейт игнорируется. Чаще всего нужен именно этот вариант.
- FALLBACK — приоритет у сущности, но если её яркость равна нулю, берётся освещение от состояния блока.
- PRIORITY — наоборот: сначала смотрится блокстейт, а сущность выступает запасным вариантом.
Далее реализуйте метод getLuminance, возвращающий нужное значение. Когда яркость действительно изменилась, вызовите updateLuminance — метод обновит освещение мира. Делать это стоит только при реальных изменениях, поскольку операция довольно затратная. Для быстрой проверки можно вызвать LuminanceBlockEntitiesMod.initializeExample() и получить тестовый блок, который каждую секунду выдаёт случайную яркость от 0 до 15.
Стоит ли ставить
Если вы разработчик, которому нужен гибкий контроль света без раздувания блокстейтов, — однозначно да. Если вы обычный игрок и мод-зависимость требует эту библиотеку, просто установите её и забудьте: она тихо работает в фоне. А тем, кто ценит удобство, лаунчер foxygame.net пригодится ещё и тем, что автоматически обновляет Luminance Block Entities - Fabric вместе с остальными дополнениями сборки, избавляя от ручной сверки версий.
В итоге Luminance Block Entities - Fabric — узкоспециализированный, но крайне полезный инструмент. Он не добавит десятки новых блоков, зато даст мододелам прочную основу для динамического освещения, а игрокам — стабильные сборки, где свет ведёт себя предсказуемо и красиво.