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

Все моды на этой странице ставятся по желанию.

Подсказки и рецепты

Jade и WTHIT показывают владельца, товар, цену и остаток у торговых автоматов и прилавков, список нужного у торгового ящика и предмет в витрине. На колоколе видна деревня: название, уровень, процветание, специализация, покровитель, казна и на что она копит. Пока стоит один из этих модов, собственные подсказки Tradery вверху экрана выключены, иначе одно и то же было бы написано дважды. Вернуть их можно строкой vending.hint: ON в client.json5.

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

EMI пока не поддерживается.

Веб-карты

На BlueMap и squaremap появляются два слоя. На первом деревни: уровень, процветание, казна, специализация и покровитель. На втором лавки игроков с владельцем и товаром: автоматы, прилавки и торговые ящики. На squaremap лавка отмечена золотой монетой, на BlueMap булавкой.

Слои пересобираются раз в 60 секунд (integrations.maps.updateSeconds). Деревня попадает на карту после того, как её колокол хоть раз загрузился при работающем моде. Рынки принадлежат серверу, булавок у них нет.

Моды на деревни

• ChoiceTheorem's Overhauled Village: рынки генерируются и в его деревнях. Рынок берёт самый близкий из пяти ванильных стилей.
• VillagersPlus: алхимики, садоводы, шахтёры, оккультисты и океанографы из этого мода покупают у автоматов и носят товар на скупку.
• Guard Villagers: проект «Сторожевой пост» приводит вместе с железным големом двух стражников. В README это указано для NeoForge (26.3, 1.21.1) и Forge (1.20.1).

Для серверов

• LuckPerms и другие моды на права: все права tradery.* со страницы команд.
• Text Placeholder API (Fabric): %tradery:balance%, %tradery:balance_short% (вида 1.2K), %tradery:balance_raw% (число без пробелов и символа), %tradery:top_name N% и %tradery:top_balance N% для места N в /baltop, %tradery:currency% для символа валюты.
• Common Economy API (Fabric, встроен): другие моды на экономику, которые на нём работают, читают и меняют балансы Tradery. В /tradery history такая операция подписана «Другой мод».

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

Что не проверено и что не работает

• Create и Mekanism: монетная руда не помечена тегами руды, так что их машины не должны её умножать. На 26.3 в игре я такого не проверял.
• Автомат или прилавок, товар которого был из удалённого мода, сохраняет цену и настройки и теряет только образец.

Economy API

Другие моды работают с деньгами Tradery через dev.eliasnvx:tradery-api:1.2.0+26.3 (для других версий игры +1.21.1 и +1.20.1). Классы лежат в самом файле мода и одинаковы на всех загрузчиках.

TraderyEconomy.get() вызывается в серверном потоке. Через него доступны счета игроков по UUID, собственные системные счета мода и операции transfer, deposit и withdraw. Каждая возвращает успех или отказ с причиной. Суммы хранятся в long в минимальных единицах: 500 при двух знаках означает 5.00. У каждого движения денег есть причина вроде tradery:vending/sale, она попадает в события и в лог транзакций. События есть на транзакции, изменение баланса, покупку в автомате, установку и настройку автомата, добычу монетной руды, подбор монет и награды; большинство можно отменить.

Полное руководство лежит в репозитории. Адреса Maven-репозитория в нём пока нет.