Better Runtime Resource Pack (BRRP)

Мод Better Runtime Resource Pack (BRRP) для Minecraft 1.20.1

Better Runtime Resource Pack (BRRP) — это библиотековый мод для Minecraft, который генерирует ресурсы (блоки, предметы, таблицы лута) непосредственно во время запуска игры. Технология позволяет значительно уменьшить размер файлов модов, содержащих множество похожих блоков, исключая необходимость хранить сотни JSON-файлов в архиве. BRRP является независимой веткой ARRP (Advanced Runtime Resource Pack) с версии 1.0.0 и работает на загрузчиках Fabric и Forge.

Что такое runtime-ресурс-пак?

Runtime Resource Pack (RRP) — это механизм, при котором файлы ресурсов и данных создаются непосредственно во время работы Minecraft, чтобы избежать рутинной работы по их хранению в архиве. Для модов с огромным количеством похожих блоков и предметов RRP позволяет существенно уменьшить размер файла мода. Например, таблицы лута (loot tables) для большинства блоков описываются как «выпадение самого блока». Некоторые блоки выпадают только при использовании Silk Touch, а для блоков-половин (slabs) при разрушении двойного блока выпадает два блока. В обычных таблицах лута каждый блок требует отдельного JSON-файла, а также файлы состояний блока, моделей блоков и предметов. Если учитывать рецепты, то для полной реализации одного блока может потребоваться не менее пяти JSON-файлов. Runtime-ресурсы генерируются внутри экземпляра игры, а не хранятся в JAR-файле мода.

Как работает генерация и сериализация

По функциональности runtime-ресурсы не отличаются от обычных ресурс-паков: обычные пакеты могут переопределять их содержимое или иметь с ними взаимосвязи. Например, модели блоков могут быть определены в runtime-ресурсах, а файлы текстур хранятся в файлах мода как обычно, так как генерировать текстурные файлы в реальном времени нецелесообразно. По сравнению с традиционными ресурс-паками runtime-ресурсы уменьшают количество операций ввода-вывода (I/O), но добавляют этап сериализации объектов, что является их недостатком. При генерации ресурсы преобразуются в байтовую форму (обычно JSON) — это сериализация. При чтении игра анализирует эти байты и генерирует объекты — это десериализация. Традиционные пакеты требуют только десериализации при загрузке, тогда как runtime-ресурсы проходят оба процесса. В будущем планируется возможность использования объектов, сгенерированных в игре, без этапа десериализации и сериализации, но для этого требуется дальнейшее исследование, чтобы сохранить возможность переопределения традиционными ресурс-паками и data-packs.

Особенности BRRP и независимость от ARRP

BRRP (Better Runtime Resource Pack) изначально был веткой мода ARRP (Advanced Runtime Resource Pack), но с версии 1.0.0 стал полностью независимым. С этого момента мод больше не предоставляет функций ARRP, однако может работать совместно с ним. С версии 1.0.0 идентификатор мода был изменён с better_runtime_resource_pack на brrp_v1, а код был модифицирован без обратной совместимости со старыми версиями. Рекомендуется использовать актуальную версию, если это необходимо. Мод является открытым исходным кодом и распространяется по лицензии MPL-2.0.

Технические детали и структура архива

Файл мода brrp-fabric-1.0.4-1.20.6.jar содержит 113 записей и 80 классов Java. Размер архива составляет около 199 КБ, а распакованный вес — 440 КБ. Мод использует миксины (mixins). Поддерживаемые версии игры включают 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21 и 1.21.1. В архиве не обнаружено русскоязычных ресурсов. Доступны локализации на английском, китайском (континентальном, гонконгском и тайваньском) языках. Мод доступен для загрузки с официального источника (Modrinth), установка зеркал запрещена до предоставления исходного кода и соблюдения лицензии.

Важно для разработчиков

Мод работает как библиотека (library mod) и опционально может использоваться как на клиенте, так и на сервере. Для корректной работы на загрузчике Fabric требуется наличие Fabric API. В файле мода также указаны обязательные зависимости: mixinextras. Если вы планируете использовать BRRP для создания собственных модов с большим количеством повторяющихся блоков, эта библиотека позволит значительно оптимизировать размер итогового файла.

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

• YetAnotherConfigLib (YACL) — похожий мод
• Fabric Language Kotlin — похожий мод

Лицензия: MPL-2.0