Обзор библиотеки Bookshelf для Minecraft: функции и команды

Модификация Bookshelf — это системная библиотека (mod-core) от разработчика Darkhax, которая упрощает разработку и оптимизирует работу других модификаций. Она не добавляет новых декоративных книжных полок или других блоков в игру. Вместо этого библиотека предлагает общий каркас кода, функции регистрации контента и кросс-платформенные события. Использование общего кода снижает количество ошибок в совместимых модах и уменьшает нагрузку на систему во время игры.

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

Библиотека Bookshelf содержит набор инструментов, которые упрощают создание модификаций для разных загрузчиков:

• Кросс-платформенные события (Events): Позволяют разработчикам писать код один раз и запускать его на Forge, NeoForge, Fabric или Quilt без необходимости переписывать обработчики событий под каждый загрузчик.

• Расширенные кодеки (Codecs): Облегчают сериализацию и десериализацию сложных объектов данных в игре.

• Упрощённая регистрация: Сокращает объём кода для регистрации новых блоков, предметов, звуков и сущностей. Вместо написания отдельных методов инициализации для каждого загрузчика (например, Forge RegistryEvents или Fabric Registry), библиотека предоставляет единый метод регистрации, который самостоятельно адаптируется под выбранную среду выполнения.

• Математические вычисления: Предлагает готовые формулы для расчёта опыта игрока, обработки цветов и манипулирования шрифтами.

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

Хотя Bookshelf разрабатывался преимущественно как системная библиотека, он содержит несколько полезных функций для администраторов серверов и авторов датапаков:

Debug-команды

• /bookshelf hand: Показывает подробную информацию о предмете, который ты держишь в руке. Эта команда выводит техническое название, уровень прочности, теги и NBT-данные предмета непосредственно в чат. Она также автоматически копирует сгенерированный JSON-код предмета в буфер обмена, что позволяет авторам датапаков мгновенно вставлять его в рецепты крафта или таблицы лута без ручного ввода длинных строк кода.

• /bookshelf font: Позволяет настраивать и изменять шрифты для текстовых элементов игры. Ты можешь применять разные стили отображения для книг, табличек или пользовательских интерфейсов, что помогает создавать уникальную атмосферу на серверах или в картах приключений.

Расширение возможностей рецептов

Библиотека позволяет использовать уникальные условия для крафта в датапаках. Например, ты можешь создавать рецепты, которые тратят прочность инструментов вместо полного уничтожения предмета (например, использование молота для дробления материалов).