VillagersTradingPlus

Мод VillagersTradingPlus для Minecraft 1.20.1

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

Основная концепция работы библиотеки

VillagersTradingPlus работает как фундамент для создания кастомных торгов. Она заменяет стандартный движок торговли жители на свой, позволяя описывать сделки в формате JSON. Это означает, что вы не просто меняете цены, а полностью определяете логику взаимодействия. Библиотека поддерживает версии 1.20.1, 1.21.1 и 1.21.8 и работает на загрузчиках Fabric, Forge и NeoForge. Она совместима с другими модами, которые используют её для своих функций, например, с жителямиPlus, который является примером мода, построенного на этой библиотеке.

Расширенные типы сделок

Помимо стандартной покупки и продажи предметов, библиотека поддерживает 14 различных типов сделок, что открывает огромные возможности для создания уникальной экономики. Вы можете реализовать продажу затагованных предметов (когда villager выбирает случайный предмет из тега, например, разные саженцы), обработку предметов (превращение сырого корала в обработанный), продажу карт с указателями на структуры, продажу зелий и затагованных книг. Особый интерес представляет продажа затагованных предметов: villager выбирает конкретный предмет из тега в момент генерации предложения, а не при взаимодействии, что позволяет создавать динамический лут. Также доступны типы сделок с несколькими входными слотами, где один слот выступает валютой, а второй — дополнительным ресурсом для получения награды.

Система условий и логика появления

Одной из ключевых особенностей является возможность привязывать сделки к условиям (conditions). Вы можете настроить так, чтобы определенная сделка появлялась только в конкретном биоме, в определенное время суток (день или ночь), при определенной погоде (дождь, гроза), на определенной фазе луны или при наличии конкретного блока рабочего места. Логика условий поддерживает как AND (все условия должны быть выполнены), так и OR (достаточно выполнения хотя бы одного). Важно отметить, что условия проверяются один раз в момент генерации предложения, когда villager повышает уровень, а не постоянно при каждом взаимодействии. Это делает их надежными для стабильных условий, но требует внимания к моменту появления сделки для переменных факторов, таких как время суток.

Настройка валюты и цен

Библиотека позволяет полностью изменить валюту торговли. Вместо стандартных изумрудов жители могут требовать любые предметы, включая затагованные. Вы можете настроить множители цен, которые зависят от репутации игрока, статуса «Героя деревни» и спроса на товар. В настройках конфигурации можно регулировать масштаб колебаний цен (trade_price_multiplier_scale) и базовую стоимость всех сделок (trade_cost_scale). Также доступна функция привязки цены к времени суток (enable_time_of_day_pricing), которая случайным образом меняет стоимость сделок в зависимости от того, когда они были открыты, с возможностью задать диапазон отклонения цены.

Конфигурация и глобальные настройки

Библиотека предоставляет файл конфигурации config/villagertradingplus/villagertradingplus-1.0-config.json5, который управляет глобальным поведением. Здесь можно задать максимальное количество новых сделок, которые villager получает при повышении уровня (trade_offers_per_level), лимит сделок у бродячего торговца (trade_offers_wandering_trader) и включить/выключить проверку условий для сделок. Для серверов, ориентированных на креативное строительство или тестирование, доступны специальные опции, позволяющие игрокам перезапускать сделки (allow_trade_reroll), устанавливать уровень жители вручную (allow_set_villager_level) и просматривать полный каталог возможных сделок с весами и условиями (allow_view_all_trades). По умолчанию эти функции отключены.

Создание datapack: структура файлов

Для создания кастомной торговли необходимо разместить файлы JSON в datapack. Для обычных жители используются три папки в корне datapack: data/ /default_villager_trades для полной замены торговли профессии, data/ /villager_trades для добавления новых сделок к существующим и data/ /wandering_trader_trades для настройки бродячего торговца. Важно помнить, что для замены стандартной торговли нужно полностью прописать все уровни (novice, apprentice, journeyman, expert, master), так как стандартные сделки в JSON пока не включены в игру. Для бродячего торговца структура проще: достаточно указать уровни common и rare.

Примеры JSON-схем сделок

Каждая сделка описывается объектом JSON, который включает тип сделки (type), параметры покупки и продажи, условия и настройки цен. Например, для простой продажи используется тип villagertradingplus:sell_item, где указываются продаваемый предмет и цена в изумрудах. Для покупки — buy_item, где определяется, что villager покупает у вас и какую награду выдает. Сложные типы, такие как weighted_pool, позволяют создать пул из нескольких вариантов сделок, где вероятность выбора каждого варианта задается весом. Это идеально подходит для создания разнообразного лута у библиотекарей или других профессий.

Специальные возможности: затаги и кастомные предметы

Библиотека поддерживает продвинутые возможности описания предметов через NBT-подобные поля внутри JSON. Вы можете задать кастомное имя, описание (lore), заклинания, цвет для брони или даже вставить сырой NBT-код. Это позволяет создавать уникальные предметы, которые появляются в качестве награды или требуются для сделки. Например, можно настроить villager, который продает меч с именем "Excalibur" и заклинанием Sharpness V, или требует для покупки книгу с конкретным заголовком и страницами. Это открывает путь к созданию сложных квестовых систем и уникальных артефактов внутри деревни.

Ограничения и совместимость

Поскольку VillagersTradingPlus является библиотекой, она не добавляет новые сущности или блоки сама по себе. Её функционал полностью зависит от того, как её используют авторы datapacks или другие моды. Если вы не создадите файлы конфигурации или не подключите мод, использующий эту библиотеку, вы не увидите изменений в игре. Также стоит учитывать, что условия сделок, связанные с переменными мира (погода, время), фиксируются в момент появления сделки, что может влиять на доступность редких предложений в зависимости от того, когда villager повысил уровень. Библиотека использует миксины (mixins) для внедрения изменений, что требует корректной версии загрузчика и игры.

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

• YetAnotherConfigLib (YACL) — похожий мод
• Boat Item View — похожий мод

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