Kobase Traders

kobasetraders · автор dkosin · лицензия MIT

v1.0.2Minecraft от 1.20.1 до 1.21 (не включая)Forge 47.2 и новееклиент + сервер

Торговцы такие, какими вы их хотите видеть: любая внешность – существо, скин игрока или крестьянин, свои предложения, зоны лавки, пути и часы работы. Всё настраивается прямо в игре жезлом торговца.

⬇ Скачать v1.0.2 · 360 KB

Обзор

Жезлом торговца вы ставите торговцев где угодно и настраиваете их в редакторе с четырьмя вкладками: Внешность, Предложения, Поведение и Пресеты. Справа вращается 3D-превью; любое изменение видно сразу – и в превью, и на торговце в мире.

Торговля идёт в обычном окне торговли Minecraft: оплата, Shift-клик и полный инвентарь работают точно так же, как с крестьянами.

Любая внешность

Любое существо из ванилы и модов (с поиском и живым превью, окрасами и вариантами для многих животных), скин игрока по нику или UUID либо крестьянин с биомом, профессией и значком. Плюс размер 0,5–2, имя и строка титула.

Свои предложения

Цена, вторая цена и товар выбираются свободно – с количеством и NBT (чары, названия). Для каждого предложения: запас или без ограничений, опыт торговца, множитель цены, спрос, особая цена и уровень.

Пополнение и уровни

Запасы не пополняются вовсе, пополняются ежедневно в заданное время, каждые n минут или как у крестьян. По желанию предложения открываются уровень за уровнем.

Поведение

Стоять и смотреть на игроков, бродить по зоне вокруг дома или ходить по пути из точек (по кругу или туда и обратно, с паузами).

Часы работы

С–по, в том числе через полночь. В нерабочее время торговец показывает «Закрыто · откроется в 08:00», идёт домой или идёт домой спать. Приветствие до 4 строк – карточкой, в чат или и так, и так.

Пресеты и шаблоны

Сохраняйте, загружайте и делитесь своими пресетами в JSON. Готовые шаблоны ролей: кузнец, пекарь, фермер, библиотекарь, картограф, банк, ювелир, торговец животными, набор странствующего торговца и Kobase Shop.

Безопасно для серверов

Неуязвим и не исчезает (настраивается), его нельзя толкать. Сервер проверяет любой ввод: права, лимиты, чёрные списки предметов и моделей, размер NBT.

Изображения

Торговцы в мире – крестьянин-кузнец, лошадь, железный голем, скин игрока, снежная лиса, закрытый и спящий торговцы – у к — **Торговцы в мире** – крестьянин-кузнец, лошадь, железный голем, скин игрока, снежная лиса, закрытый и спящий торговцы – у каждого имя и титул.Настоящий скриншот из версии в разработке (язык игры — английский)

Внешность: крестьянин – тип биома, профессия и значок; справа вращаемое 3D-превью с именем, титулом и размером. — **Внешность: крестьянин** – тип биома, профессия и значок; справа вращаемое 3D-превью с именем, титулом и размером.Настоящий скриншот из версии в разработке (язык игры — английский)

Внешность: существо – поиск по всем существам (ванила и моды) и готовые варианты, здесь окрас и отметины лошади. — **Внешность: существо** – поиск по всем существам (ванила и моды) и готовые варианты, здесь окрас и отметины лошади.Настоящий скриншот из версии в разработке (язык игры — английский)

Предложения – цена, вторая цена и товар, запас, опыт, множитель цены, спрос, уровень и тестовая покупка; сверху пополнен — **Предложения** – цена, вторая цена и товар, запас, опыт, множитель цены, спрос, уровень и тестовая покупка; сверху пополнение и уровни.Настоящий скриншот из версии в разработке (язык игры — английский)

Поведение – стоит, зона или путь с точками, дом, часы работы, приветствие и свойства. — **Поведение** – стоит, зона или путь с точками, дом, часы работы, приветствие и свойства.Настоящий скриншот из версии в разработке (язык игры — английский)

Пресеты – шаблоны ролей вроде кузнеца, банка или торговца животными, свои пресеты как JSON-файлы, которыми легко поделит — **Пресеты** – шаблоны ролей вроде кузнеца, банка или торговца животными, свои пресеты как JSON-файлы, которыми легко поделиться.Настоящий скриншот из версии в разработке (язык игры — английский)

Торговля в обычном окне торговли Minecraft, над ним – карточка приветствия торговца. — **Торговля** в обычном окне торговли Minecraft, над ним – карточка приветствия торговца.Настоящий скриншот из версии в разработке (язык игры — английский)

Конец рабочего дня – в нерабочее время этот торговец идёт домой и спит («Zzz»). — **Конец рабочего дня** – в нерабочее время этот торговец идёт домой и спит («Zzz»).Настоящий скриншот из версии в разработке (язык игры — английский)

Управление

Действие	Результат
ПКМ по блоку с жезлом торговца	поставить нового торговца и открыть редактор (нужны права)
`Красться` + ПКМ по торговцу с жезлом	открыть редактор
ПКМ по торговцу	торговать
Редактор → Поведение → Путь → Запись	редактор закрывается; ПКМ по блокам добавляет точки пути, `Красться` + ПКМ в воздух завершает запись
Редактор → Поведение → Дом Жезлом	следующий блок, по которому вы кликнете, станет домом
Редактор: Применить / Готово / Отмена	отправить на сервер / отправить и закрыть / отменить

Кто может ставить и изменять торговцев, решает сервер (по умолчанию операторы и игроки в творческом режиме; тот, кто поставил торговца, всегда может его изменять). Неуязвимого торговца можно убрать только в редакторе или командой /kill.

Предметы и рецепты

Рецепты

Жезл торговца – 1× Железный слиток, 2× ПалкаЖелезный слиток справа вверху, две палки по диагонали под ним. — **Жезл торговца** – 1× Железный слиток, 2× Палка
Железный слиток справа вверху, две палки по диагонали под ним.Верстак · отрисовано из текстур игры

Настройки

Все параметры меняются в игре: Моды → Kobase Traders → Config (через Kobase Core). Серверные параметры действуют для всех игроков; клиентские каждый задаёт сам – отмеченные можно заблокировать сервер может зафиксировать для всех.

Параметр	Описание	По умолчанию
Кто может изменять торговцев `permissions.edit` SERVER	Операторы: только операторы. Творческий: операторы и игроки в творческом режиме.	Творческий Операторы / Творческий
Владелец может изменять `permissions.allowOwnerEdit` SERVER	Игрок, создавший торговца, всегда может его изменять.	вкл.
Кто может создавать торговцев `permissions.spawn` SERVER	Операторы, творческий режим (операторы и игроки в творческом режиме) или все.	Творческий Операторы / Творческий / Все
Торговцев на игрока `spawn.maxPerPlayer` SERVER	Сколько торговцев может иметь один игрок без прав оператора (0 = без лимита).	0 от 0 до 1000
Начальный шаблон `spawn.defaultTemplate` SERVER	Шаблон роли для только что созданных торговцев.	Нет (без предложений) Нет (без предложений) / Кузнец / Пекарь / Фермер / Библиотекарь / Картограф / Банк / Ювелир / Зоолавка / Странник / Kobase Shop
Новые торговцы бессмертны `defaults.invulnerable` SERVER	Удалить их можно только через /kill.	вкл.
Новые торговцы не исчезают `defaults.persistent` SERVER	Они никогда не пропадают сами.	вкл.
Новых торговцев можно толкать `defaults.pushable` SERVER	Игроки и мобы могут их толкать.	выкл.
Пополнение по умолчанию `restock.defaultMode` SERVER	Никогда, ежедневно, через интервал или как у крестьян (дважды в день).	Как у крестьян Никогда / Ежедневно / Интервал / Как у крестьян
Интервал пополнения (мин.) `restock.defaultMinutes` SERVER	Минуты между пополнениями в режиме интервала.	20 от 1 до 1440
Час ежедневного пополнения `restock.defaultHour` SERVER	Игровой час ежедневного пополнения (6 = рассвет).	6 от 0 до 23
Макс. предложений `limits.maxTrades` SERVER	Наибольшее число предложений у одного торговца.	32 от 1 до 128
Макс. размер NBT `limits.maxNbtBytes` SERVER	Наибольший размер NBT (в байтах) товара или варианта модели.	8192 от 256 до 262144
Макс. точек маршрута `limits.maxWaypoints` SERVER	Наибольшее число точек в одном маршруте.	32 от 1 до 256
Макс. радиус зоны `limits.maxRadius` SERVER	Наибольший радиус зоны торговца в блоках.	32 от 1 до 128
Макс. дальность маршрута `limits.maxRouteDistance` SERVER	Наибольшее расстояние точки маршрута от дома.	128 от 8 до 1024
Запрещённые предметы `limits.itemDeny` SERVER	Предметы (ID или #tags), которые нельзя продавать.	minecraft:command_block, minecraft:chain_command_block, minecraft:repeating_command_block, minecraft:command_block_minecart, minecraft:structure_block, minecraft:structure_void, minecraft:jigsaw, minecraft:barrier, minecraft:light, minecraft:debug_stick, minecraft:spawner, minecraft:knowledge_book, minecraft:bedrock
Запрещённые модели `limits.appearanceDeny` SERVER	Типы сущностей (или modid:*), которые нельзя использовать как модель торговца.	minecraft:ender_dragon
Операторы обходят запреты `limits.opsBypassDeny` SERVER	Операторы могут использовать запрещённые предметы и модели.	вкл.
Разрешить яйца призыва `limits.allowSpawnEggs` SERVER	Редакторы без прав оператора могут продавать яйца призыва.	выкл.
Показывать титулы `display.showTitles` CLIENTможно заблокировать	Строка титула над именами торговцев.	вкл.
Табличка «Закрыто» `display.showClosedSign` CLIENTможно заблокировать	Над торговцами вне их часов работы.	вкл.
Карточка приветствия `display.greetingCard` CLIENTможно заблокировать	Показывать приветствие над окном торговли.	вкл.
Дальность имён `display.nameRange` CLIENTможно заблокировать	Расстояние, на котором видны имена торговцев.	24 от 4 до 64
Вращать превью `editor.autoRotate` CLIENT	Медленно вращать модель в редакторе.	вкл.

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

Minecraft	1.20.1
Загрузчик модов	Forge 47.2 и новее
Kobase Core	входит в jar мода (от 1.0.2 до 2.0.0 (не включая)) – ничего отдельно ставить не нужно
Установка	На сервере и у всех игроков (один jar для обеих сторон, Kobase Core встроен).
Сборки	CJ_SimpleMod · Modpack D+J

Для других модов: API (de.kobase.traders.api.TraderApi) создаёт и настраивает торговцев из кода или JSON и открывает редактор; TraderClientApi предоставляет редактор как диалог проектирования. Kobase Traders остаётся необязательной зависимостью.

Версии

v1.0.0 Первая версия: торговцы с любой внешностью, свои предложения, пополнение, уровни, зоны, пути, часы работы, пресеты и шаблоны ролей; настройки через Kobase Core; 12 языков.
v1.0.1 Переводы: все тексты мода и его настроек на 13 языках; с Kobase Core 1.0.3.
v1.0.2 Настройки: добавлены недостающие подсказки и названия на всех языках.