Moonlight Lib

Moonlight Lib: библиотека для создания динамических модов

Moonlight Lib — это универсальная библиотека для модов Minecraft, поддерживающая загрузчики Fabric, Forge и NeoForge. Она предоставляет набор инструментов для решения задач, которые сложно реализовать стандартными методами: от динамической регистрации наборов блоков (например, пород дерева) до создания собственных систем жидкостей и анимаций предметов. Библиотека активно используется сообществом и доступна на нескольких языках, включая русский.

Динамическая регистрация блоков и ресурсов

Одной из ключевых возможностей библиотеки является упрощение динамической регистрации блоков. В отличие от традиционных методов, Moonlight Lib позволяет модам определять наборы блоков (например, типы дерева), автоматически сканируя уже зарегистрированные блоки и заполняя эти наборы. Это критически важно, когда логика регистрации зависит от наличия конкретных блоков в мире. Библиотека также включает утилиты для создания динамических пакетов ресурсов и datapacks, а также инструменты для перекраски существующих текстур, что особенно полезно для добавления новых блоков, имитирующих дерево.

Расширенная система жидкостей и контейнеров

Библиотека реализует собственную систему виртуальных жидостей, которая работает поверх стандартной системы Forge, но адаптирована под ванильный Minecraft. Основная особенность — базовая единица измерения составляет 1 бутылку майнкрафта (250 мБ), что упрощает создание рецептов. Система поддерживает хранение жидкостей в различных контейнерах: бутылках, мисках, ведрах, а также в супах и напитках, которые можно пить напрямую из резервуара. Все жидкости виртуальны и существуют только внутри модифицированных контейнеров, созданных специально для них. Разработчики могут легко добавлять новые жидкости или переопределять существующие, используя Data Driven подход.

Инструменты для предметов и интерфейса

Для создания предметов с уникальным поведением библиотека предлагает простой интерфейс для реализации кастомных анимаций в первой и третьей лицах. Это позволяет, например, добавить уникальную анимацию перезарядки для лука или другого оружия. Кроме того, предоставляется механизм для отрисовки предметов напрямую в классе предмета (аналогично прицелу штурмового стекла). В модуль также включена система триггеров достижений: при взаимодействии с точилом срабатывает кастомное событие, которое можно использовать в JSON-файлах достижений.

Картография и искусственный интеллект

Moonlight Lib включает полноценную систему для создания маркеров на картах. Разработчики могут добавлять декорации, контролировать их отрисовку и даже хранить простые данные внутри карт, которые затем могут отображаться в подсказках предметов. Система построена по принципу Data Driven, что позволяет регистрировать новые типы маркеров через datapacks без изменения кода. Отдельно реализована помощь для работы с ИИ жителей: библиотека позволяет динамически добавлять задачи и менять расписание жителей, не переопределяя весь существующий искусственный интеллект, а также добавляет поддержку новых типов памяти.

Утилиты для диспенсеров

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

Связанные материалы

• Cloth Config API — похожий мод
• YetAnotherConfigLib (YACL) — похожий мод
• Fabric Language Kotlin — похожий мод
• Architectury API — похожий мод
• Just Enough Items (JEI) — похожий мод