- Документация
- https://modrinth.com/plugin/villagertradeedit
VillagerTradeEdit — серверный плагин для изменения сделок жителей непосредственно в Minecraft. Пользователь с необходимыми правами получает внутриигровой интерфейс, через который можно работать с торговыми предложениями выбранного жителя. Проект относится к категориям экономики и игровых механик.
Плагин предназначен для Folia, Paper и Purpur. Клиентская установка не поддерживается, серверная сторона обязательна. В официальном описании его сопоставляют с Shopkeepers, но подчёркивают отличие: изменения применяются прямо к любому жителю. Не заявленные функции приписывать проекту не следует.
Основная задача VillagerTradeEdit — дать администратору или другому уполномоченному пользователю удобный способ редактировать торговлю без внешнего редактора. Подтверждены следующие возможности:
• открытие редактора взаимодействием с жителем;
• изменение сделок через графическое меню в игре;
• работа с любым выбранным жителем;
• изменение профессий, заявленное в кратком описании;
• создание большого количества торговых предложений;
• поддержка Folia наряду с Paper и Purpur.
Формулировка Unlimited-Trade не доказывает отсутствие ограничений Minecraft и сервера. Не описаны формат хранения, миграция сделок и обработка нестандартных предметов.
Официально указан простой способ открытия меню: Shift-клик правой кнопкой мыши по жителю. Доступ связан с разрешением villagertradeedit.open, поэтому возможность редактирования можно отделить от обычной торговли игроков.
Практический порядок работы:
• установить плагин на совместимый сервер;
• выдать нужной роли разрешение на открытие меню;
• выполнить Shift-клик правой кнопкой по выбранному жителю;
• изменить предложения через внутриигровой интерфейс;
• проверить результат обычным открытием торговли;
• отдельно проверить сохранение после планового перезапуска.
Последний шаг — рекомендуемая проверка, а не гарантия. Состав полей меню и способ отмены изменений не раскрыты.
Подтверждены две команды. /vte reload повторно загружает конфигурационный файл, а /vte summon призывает статичного жителя. Другие команды в фактической основе не указаны.
Проект перечисляет такие разрешения:
• villagertradeedit.command — доступ к командам плагина;
• villagertradeedit.open — открытие редактора торговли;
• villagertradeedit.command.reload — использование команды перезагрузки;
• villagertradeedit.command.summon — использование призыва статичного жителя.
Разделение прав позволяет не выдавать редактору торговли доступ к перезагрузке или призыву жителей. Значения прав по умолчанию и их наследование не описаны.
Подтверждены платформы Folia, Paper и Purpur. Заявленные версии Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, а также 26.1, 26.1.1 и 26.1.2.
Перечень не заменяет проверку конкретного JAR на конкретной сборке. Результат на Paper или Purpur нельзя автоматически переносить на Folia.
Распределение по сторонам однозначно:
• сервер — требуется;
• клиент — не поддерживается;
• отдельный клиентский компонент VillagerTradeEdit не указан.
В метаданных обязательные project dependencies не перечислены, но официальный текст отдельно называет Ysklib. Поэтому считать плагин безусловно автономным нельзя.
Перед установкой разумно:
• сверить сведения именно для выбранного выпуска;
• проверить наличие требования Ysklib в описании версии;
• запустить копию сервера в тестовой среде;
• изучить журнал на сообщения об отсутствующей библиотеке.
Версия Ysklib и её соответствие выпускам VillagerTradeEdit не приведены.
JAR помещается в папку plugins совместимого сервера. Официальная инструкция после копирования файла предусматривает перезапуск сервера, чтобы плагин был загружен.
Практическая последовательность установки:
• остановить тестовый экземпляр;
• выбрать нужный файл VillagerTradeEdit;
• сверить размер и контрольную сумму;
• поместить JAR в plugins;
• учесть возможную зависимость Ysklib;
• запустить сервер и проверить журнал;
• выдать минимально необходимые разрешения;
• испытать редактор на отдельном жителе.
/vte reload не заменяет первоначальный запуск. Порядок обновления между версиями не подтверждён.
В фактической основе указаны два JAR:
• VillagerTradeEdit-2.2.0.jar — версия 2.2.0, 104877 байт, SHA-1 2e929afdeb5d31e39f3cab2ef50b0a4eb2da1f2a;
• VillagerTradeEdit-1.4.10.jar — версия 1.4.10, 87475 байт, SHA-1 226c92fc216babefdb0df963a96874d6c0fe788d.
SHA-512 версии 2.2.0: 0ec65d307951536c84176d4da9aacc508d0b009a9e116187d56cd78350c511da37200f35dc9437c59bc8d7cb45524398ca7e3a48984752d922c5f5a430a9a48b.
SHA-512 версии 1.4.10: a6783bc0b491a42f9fa6988b92097da4e475299c5a3f32ad2670e9208d42a0a13b39935469b2bc62b21bcb6f5a85d114db85d3e576b9b1947d41fef4ca0c7e8b.
Хеши позволяют сверить локальную копию, но не определяют соответствие каждого выпуска отдельной версии Minecraft.
Файлы получены по официальному HTTPS и локально сверены по опубликованным хешам. Архивы прошли статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому фактическое поведение кода, нагрузка и совместимость с конкретным набором плагинов не проверены.
Перед рабочим внедрением полезно проконтролировать:
• загрузку без ошибок;
• реакцию на наличие или отсутствие Ysklib;
• доступ к меню и командам только у нужных ролей;
• сохранение изменённой торговли;
• совместимость с плагинами NPC и экономики.
Не подтверждены встроенное резервное копирование, аудит действий редакторов, автоматическая защита от несбалансированных обменов и гарантии производительности.
VillagerTradeEdit распространяется по GPL-3.0-only. Это точное обозначение лицензии проекта, которое следует учитывать при распространении изменённых копий. Открытая лицензия сама по себе не расширяет список поддерживаемых платформ и не гарантирует поддержку сторонних модификаций.
Нет. Для VillagerTradeEdit указано client=unsupported и server=required: JAR устанавливается на сервер.
Подтверждённый способ — Shift-клик правой кнопкой мыши по жителю. Пользователю требуется разрешение villagertradeedit.open.
Официальное описание заявляет прямое редактирование любого жителя. Фактический доступ всё равно зависит от прав и корректной загрузки плагина.
Метаданные не перечисляют обязательные project dependencies, но официальный текст называет Ysklib. Вопрос следует проверять для выбранного выпуска на тестовом сервере.
Проект заявляет Unlimited-Trade, но не приводит технический предел. Из этой формулировки нельзя выводить отсутствие ограничений среды.
Нет. Проведены получение по официальному HTTPS, сверка хешей и статическая проверка структуры и путей; динамический запуск не выполнялся.
Плагин предназначен для Folia, Paper и Purpur. Клиентская установка не поддерживается, серверная сторона обязательна. В официальном описании его сопоставляют с Shopkeepers, но подчёркивают отличие: изменения применяются прямо к любому жителю. Не заявленные функции приписывать проекту не следует.
Назначение плагина
Основная задача VillagerTradeEdit — дать администратору или другому уполномоченному пользователю удобный способ редактировать торговлю без внешнего редактора. Подтверждены следующие возможности:
• открытие редактора взаимодействием с жителем;
• изменение сделок через графическое меню в игре;
• работа с любым выбранным жителем;
• изменение профессий, заявленное в кратком описании;
• создание большого количества торговых предложений;
• поддержка Folia наряду с Paper и Purpur.
Формулировка Unlimited-Trade не доказывает отсутствие ограничений Minecraft и сервера. Не описаны формат хранения, миграция сделок и обработка нестандартных предметов.
Скриншоты и внешний вид
Механика редактирования
Официально указан простой способ открытия меню: Shift-клик правой кнопкой мыши по жителю. Доступ связан с разрешением villagertradeedit.open, поэтому возможность редактирования можно отделить от обычной торговли игроков.
Практический порядок работы:
• установить плагин на совместимый сервер;
• выдать нужной роли разрешение на открытие меню;
• выполнить Shift-клик правой кнопкой по выбранному жителю;
• изменить предложения через внутриигровой интерфейс;
• проверить результат обычным открытием торговли;
• отдельно проверить сохранение после планового перезапуска.
Последний шаг — рекомендуемая проверка, а не гарантия. Состав полей меню и способ отмены изменений не раскрыты.
Команды и разрешения
Подтверждены две команды. /vte reload повторно загружает конфигурационный файл, а /vte summon призывает статичного жителя. Другие команды в фактической основе не указаны.
Проект перечисляет такие разрешения:
• villagertradeedit.command — доступ к командам плагина;
• villagertradeedit.open — открытие редактора торговли;
• villagertradeedit.command.reload — использование команды перезагрузки;
• villagertradeedit.command.summon — использование призыва статичного жителя.
Разделение прав позволяет не выдавать редактору торговли доступ к перезагрузке или призыву жителей. Значения прав по умолчанию и их наследование не описаны.
Совместимые версии и платформы
Подтверждены платформы Folia, Paper и Purpur. Заявленные версии Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, а также 26.1, 26.1.1 и 26.1.2.
Перечень не заменяет проверку конкретного JAR на конкретной сборке. Результат на Paper или Purpur нельзя автоматически переносить на Folia.
Распределение по сторонам однозначно:
• сервер — требуется;
• клиент — не поддерживается;
• отдельный клиентский компонент VillagerTradeEdit не указан.
Зависимости и расхождение в данных
В метаданных обязательные project dependencies не перечислены, но официальный текст отдельно называет Ysklib. Поэтому считать плагин безусловно автономным нельзя.
Перед установкой разумно:
• сверить сведения именно для выбранного выпуска;
• проверить наличие требования Ysklib в описании версии;
• запустить копию сервера в тестовой среде;
• изучить журнал на сообщения об отсутствующей библиотеке.
Версия Ysklib и её соответствие выпускам VillagerTradeEdit не приведены.
Установка
JAR помещается в папку plugins совместимого сервера. Официальная инструкция после копирования файла предусматривает перезапуск сервера, чтобы плагин был загружен.
Практическая последовательность установки:
• остановить тестовый экземпляр;
• выбрать нужный файл VillagerTradeEdit;
• сверить размер и контрольную сумму;
• поместить JAR в plugins;
• учесть возможную зависимость Ysklib;
• запустить сервер и проверить журнал;
• выдать минимально необходимые разрешения;
• испытать редактор на отдельном жителе.
/vte reload не заменяет первоначальный запуск. Порядок обновления между версиями не подтверждён.
Доступные файлы
В фактической основе указаны два JAR:
• VillagerTradeEdit-2.2.0.jar — версия 2.2.0, 104877 байт, SHA-1 2e929afdeb5d31e39f3cab2ef50b0a4eb2da1f2a;
• VillagerTradeEdit-1.4.10.jar — версия 1.4.10, 87475 байт, SHA-1 226c92fc216babefdb0df963a96874d6c0fe788d.
SHA-512 версии 2.2.0: 0ec65d307951536c84176d4da9aacc508d0b009a9e116187d56cd78350c511da37200f35dc9437c59bc8d7cb45524398ca7e3a48984752d922c5f5a430a9a48b.
SHA-512 версии 1.4.10: a6783bc0b491a42f9fa6988b92097da4e475299c5a3f32ad2670e9208d42a0a13b39935469b2bc62b21bcb6f5a85d114db85d3e576b9b1947d41fef4ca0c7e8b.
Хеши позволяют сверить локальную копию, но не определяют соответствие каждого выпуска отдельной версии Minecraft.
Безопасность и ограничения проверки
Файлы получены по официальному HTTPS и локально сверены по опубликованным хешам. Архивы прошли статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому фактическое поведение кода, нагрузка и совместимость с конкретным набором плагинов не проверены.
Перед рабочим внедрением полезно проконтролировать:
• загрузку без ошибок;
• реакцию на наличие или отсутствие Ysklib;
• доступ к меню и командам только у нужных ролей;
• сохранение изменённой торговли;
• совместимость с плагинами NPC и экономики.
Не подтверждены встроенное резервное копирование, аудит действий редакторов, автоматическая защита от несбалансированных обменов и гарантии производительности.
Лицензия
VillagerTradeEdit распространяется по GPL-3.0-only. Это точное обозначение лицензии проекта, которое следует учитывать при распространении изменённых копий. Открытая лицензия сама по себе не расширяет список поддерживаемых платформ и не гарантирует поддержку сторонних модификаций.
FAQ
Нужно ли устанавливать плагин игрокам?
Нет. Для VillagerTradeEdit указано client=unsupported и server=required: JAR устанавливается на сервер.
Как открыть меню редактирования?
Подтверждённый способ — Shift-клик правой кнопкой мыши по жителю. Пользователю требуется разрешение villagertradeedit.open.
Можно ли менять любого жителя?
Официальное описание заявляет прямое редактирование любого жителя. Фактический доступ всё равно зависит от прав и корректной загрузки плагина.
Обязателен ли Ysklib?
Метаданные не перечисляют обязательные project dependencies, но официальный текст называет Ysklib. Вопрос следует проверять для выбранного выпуска на тестовом сервере.
Есть ли гарантированный предел числа сделок?
Проект заявляет Unlimited-Trade, но не приводит технический предел. Из этой формулировки нельзя выводить отсутствие ограничений среды.
Выполнялся ли запуск проверенных файлов?
Нет. Проведены получение по официальному HTTPS, сверка хешей и статическая проверка структуры и путей; динамический запуск не выполнялся.
