Villager API

Villager API

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

Что он делает?

Этот мод позволяет создавать полностью собственных жителей с:

• Профессиями — новые работы с собственными рабочими местами и списками торговли
• Типами — разные внешности жителей, привязанные к конкретным биомам
• Торговлей — полный контроль над тем, что жители покупают и продают на каждом уровне
• Подарками героя — собственные таблицы добычи для наград после рейда

Всё управляется через JSON-файлы в папке villagerpacks. Никакого кода, никакой сложной настройки — просто создай файлы и запускай игру.

Быстрый пример

Хочешь жителя-алхимика, который использует блок плачущего обсидиана как рабочее место?

1. Создай villagerpacks/my_pack/villagers/poi_types/alchemist.json и villagerpacks/my_pack/villagerapi_config.json
2. Определи блок рабочего места
3. Добавь файл профессии со ссылкой на этот тип POI
4. Настрой торговлю
5. Закинь текстуры для оверлея профессии

Вот и всё. Мод сам занимается регистрацией, механикой торговли и всем остальным.

Что можно настроить?

• Рабочие места — любой блок может быть рабочим местом
• Пул торговли — точно определи, что жители предлагают на каждом уровне опыта (от Новичка до Мастера)
• Компоненты предметов — полная поддержка зачарований, кастомных названий, зелий и всех компонентов данных, которые использует Minecraft
• Карты сокровищ — продавай карты к структурам из модов или ванили с кастомными метками
• Внешность по биомам — сделай так, чтобы жители выглядели по-разному в зависимости от места появления
• Торговля по биомам — одна профессия, разный ассортимент в зависимости от типа биома жителя

Для кого и для чего это?

Если ты когда-нибудь хотел добавить жителей в свой модпак или мод, не разбираясь с Java-кодом, — это для тебя. Он создан для сборщиков модпаков и моддеров, которые хотят контент с жителями без головной боли от изучения и написания Java-кода.

Работает и как обычный ресурспак вроде villager packs, и как часть модов — достаточно положить папку villagers в главную директорию мода. Несколько паков могут работать одновременно — более поздние переопределяют более ранние там, где есть пересечения.

Полная документация

Смотри полную документацию с примерами и всеми доступными опциями здесь:
https://github.com/frikinjay/villagerapi/blob/main/DOCUMENTATION.md

Можешь сгенерировать пак онлайн, чтобы не создавать все файлы вручную: Villager Pack Generator

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