Мод Villager API 1.26.7.1 +2

Villager API — мод-библиотека для Minecraft, предназначенный для создания пользовательских профессий жителей, типов жителей и торговых предложений на основе данных без написания программного кода. Согласно официальному описанию, работа строится вокруг JSON-файлов, позволяющих описывать необходимые элементы и загружать их в игру.

Проект относится одновременно к категориям library, mobs и utility. Он предназначен как для клиентской, так и для серверной стороны, а его основная цель заключается в предоставлении инфраструктуры для настройки жителей через структуру данных, а не через изменение исходного кода модификаций.

Назначение мода​

Основная задача Villager API — предоставить универсальный механизм создания и регистрации пользовательского содержимого, связанного с жителями Minecraft.

Согласно опубликованному описанию, мод позволяет создавать:

• новые профессии жителей;

• собственные типы жителей;

• индивидуальные торговые предложения;

• пользовательские награды Hero Gifts после рейдов.

Все перечисленные элементы описываются с помощью JSON-файлов. В официальной документации подчёркивается, что создание такого содержимого не требует написания Java-кода.

Для кого предназначен проект​

В описании проекта отдельно указано, что мод ориентирован прежде всего на:

• авторов модпаков;

• разработчиков модификаций;

• пользователей, желающих создавать собственных жителей без программирования.

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

Скриншоты и внешний вид​

Принцип работы​

Villager API использует подход, основанный на описании данных.

На высоком уровне пользователь создаёт необходимые JSON-файлы, после чего мод обрабатывает их и выполняет регистрацию соответствующих элементов. Согласно официальному описанию, именно мод отвечает за регистрацию профессий, механику торговли и связанные внутренние процессы.

При этом документация не раскрывает внутренние алгоритмы обработки данных. Поэтому нельзя утверждать, каким образом реализованы регистрация объектов, обработка файлов или взаимодействие с игровыми системами на уровне исходного кода.

Какие элементы можно описывать​

Согласно опубликованной информации, через JSON могут задаваться:

• профессии жителей;

• рабочие места;

• типы жителей;

• торговые списки;

• внешний вид жителей для различных биомов;

• торговые предложения для разных биомов;

• таблицы наград Hero Gifts;

• карты сокровищ;

• компоненты предметов, включая поддерживаемые игрой компоненты данных.

Все эти возможности относятся именно к декларативному описанию содержимого. Документация не утверждает наличие визуального редактора или встроенного графического интерфейса.

Совместимость​

Для рассматриваемых файлов подтверждены следующие версии Minecraft:

• 26.1;

• 26.1.1;

• 26.1.2;

• 26.2;

• 26.3-snapshot-1;

• 26.3-snapshot-2;

• 26.3-snapshot-3;

• 26.3-snapshot-4;

• 26.3-snapshot-5;

• 26.3-snapshot-6;

• 26.3-snapshot-7;

• 1.21.11;

• 1.21.1.

Поддерживаемая платформа:

• NeoForge.

Распространять сведения о совместимости на другие версии Minecraft или другие загрузчики нельзя, поскольку такие данные отсутствуют в предоставленной фактической основе.

Клиент и сервер​

Метаданные проекта содержат следующие требования:

• client = required;

• server = required.

Следовательно, мод рассчитан на использование как на стороне клиента, так и на стороне сервера.

Зависимости​

В метаданных выбранных версий отсутствуют обязательные project dependencies.

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

Также не следует самостоятельно добавлять перечень библиотек или модификаций, поскольку они отсутствуют в предоставленной основе.

Версии​

Для проекта опубликованы несколько файлов, соответствующих различным версиям Minecraft.

Среди них:

• Villager-API-26.1.x-neoforge-1.26.7.1.jar — версия 1.26.7.1;

• Villager-API-1.21.11-neoforge-1.26.1.3.jar — версия 1.26.1.3;

• Villager-API-1.21.1-neoforge-1.26.1.3.jar — версия 1.26.1.3.

При выборе рекомендуется использовать файл, соответствующий установленной версии Minecraft и загрузчику NeoForge.

Установка​

Установка выполняется стандартным способом для модификаций NeoForge.

Общий порядок действий​

• Выберите файл, соответствующий версии Minecraft.

• Убедитесь, что используется совместимый загрузчик NeoForge.

• Поместите файл мода в папку mods.

• Запустите игру.

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

Настройка​

Основная настройка Villager API основана на использовании JSON-файлов.

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

Что можно настраивать​

Документация сообщает о возможности описывать:

• рабочие станции профессий;

• списки торговли;

• уровни торговых предложений;

• внешний вид жителей;

• биомные варианты;

• пользовательские награды;

• компоненты предметов;

• карты сокровищ.

При этом руководство не приводит полный формат JSON и не описывает структуру каждого файла. Следовательно, воспроизводить такие сведения без дополнительных подтверждённых материалов нельзя.

Также официальное описание упоминает возможность использования нескольких пакетов одновременно. Если между ними возникает пересечение данных, более поздние пакеты имеют приоритет над ранее загруженными.

Ограничения​

При использовании Villager API необходимо учитывать несколько ограничений.

Во-первых, опубликованное описание содержит только общий обзор возможностей. Оно не включает полный перечень поддерживаемых параметров и форматов.

Во-вторых, отсутствуют сведения о поддержке других загрузчиков помимо NeoForge.

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

Кроме того, не следует делать выводы о совместимости с любыми сторонними модификациями, если такие сведения прямо не опубликованы.

Лицензия​

Villager API распространяется по лицензии LGPL-3.0-only.

Предоставленная информация не содержит дополнительных условий использования, поэтому руководство ограничивается указанием опубликованной лицензии без её расширительного толкования.

Безопасность​

Для опубликованных файлов приводятся контрольные суммы SHA-1 и SHA-512, позволяющие проверить целостность архива после загрузки.

Файлы этой карточки загружены с официального HTTPS-источника; размеры и опубликованные SHA-1/SHA-512 сверены, целостность и безопасные пути внутри архивов проверены статически. Файлы не запускались, поэтому динамическое поведение не заявляется как протестированное.

• выполнять статическую проверку архивов.

При этом скачиваемые файлы не запускались. Следовательно, руководство не утверждает прохождение динамического тестирования и не делает выводов о поведении мода во время выполнения.

FAQ​

Для чего предназначен Villager API?​

Мод предоставляет инфраструктуру для создания пользовательских профессий жителей, типов жителей и торговых предложений с использованием JSON-файлов без написания Java-кода.

Требуется ли программирование для создания содержимого?​

Согласно официальному описанию, мод предназначен именно для создания такого содержимого без написания программного кода.

Какие элементы можно создавать?​

Поддерживаются профессии, типы жителей, торговые предложения, Hero Gifts, рабочие станции, биомные варианты жителей, карты сокровищ и другие элементы, перечисленные в официальном описании.

Какие загрузчики поддерживаются?​

Для опубликованных файлов подтверждена поддержка только NeoForge.

Есть ли обязательные зависимости?​

В метаданных рассматриваемых версий обязательные project dependencies отсутствуют.

Нужно ли устанавливать мод на сервер?​

Да. Метаданные указывают, что мод требуется как на стороне клиента, так и на стороне сервера.

Можно ли использовать несколько пакетов одновременно?​

Да. Согласно официальному описанию, допускается одновременное использование нескольких пакетов, при этом более поздние перекрывают предыдущие при совпадении данных.

Подтверждено ли динамическое тестирование файлов?​