Villager API

Мод Villager API для Minecraft — библиотека для создания кастомных жителей

Villager API — это модуль-инструмент, который позволяет авторам модов и создателям модпаков добавлять уникальных жителей, новые профессии и кастомную торговлю, не прибегая к написанию Java-кода. Весь функционал реализуется через конфигурационные файлы JSON. Мод работает на платформах Fabric, NeoForge и Quilt, поддерживая актуальные версии игры, включая 1.21.11 и ветку 26.x. Он идеально подходит для тех, кто хочет расширить контент модпака, добавив, например, жителей с уникальными рабочими местами или специфическими торговыми предложениями, зависящими от биомов.

Основная концепция: работа с данными без кода

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

Что можно настроить: профессии и торговля

С помощью Villager API можно полностью пересобрать систему жителей. Вы можете создать новые профессии с уникальными рабочими местами (workstations) и списком торговли. Торговля контролируется на каждом уровне опыта — от новичка до мастера. Кроме того, поддерживается настройка лута для подарков героям после рейдов и возможность привязывать внешность жителей к конкретным биомам, чтобы торговые предложения менялись в зависимости от локации.

Пример настройки кастомного жителя

Для создания нового жителя, например, Алхимика, использующего плачущий обсидиан как рабочее место, необходимо создать структуру файлов в папке villagerpacks. Требуется создать файл конфигурации для типа точки интереса (POI type), файл профессии, связывающий её с этим типом, и настроить торговые предложения. После добавления текстур для оверлея профессии, мод автоматически обработает всё и зарегистрирует нового жителя в игре.

Универсальность и совместимость

Мод работает в двух режимах: как отдельный мод в папке mods или как часть ресурсного пака (villager pack). Это позволяет использовать его как в одиночной игре, так и в составе сложных модпаков. Система поддерживает множественные пакеты одновременно: если несколько пакетов содержат одинаковые профессии, более поздний в списке приоритетнее. Поддерживаются любые блоки как рабочие места, полные компоненты предметов (включая чары и зелья) и карты сокровищ с кастомными маркерами.

Документация и генератор

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

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

• Geckolib — похожий мод

Автор: frikinjay · Лицензия: LGPL-3.0-only