Плагин VillagerInfo 4.3.2 +4.2.0

VillagerInfo — серверный плагин для удобного доступа к полезной информации из внутренних данных жителей без разбора избыточного стандартного вывода. Проект относится к категориям management, mobs и utility. Авторы — Peashooter101 и Rhythmic; лицензия — MIT. Серверная сторона обязательна, клиентская установка не поддерживается.

Назначение и границы функции​

VillagerInfo предназначен для просмотра, а не редактирования данных жителей. Он помогает проверять уже существующую информацию, однако официальный текст не перечисляет все отображаемые поля. Поэтому наличие конкретного параметра заранее не гарантируется. Проект не заявлен как средство изменения профессий, сделок, расписания или искусственного интеллекта мобов.

Скриншоты и внешний вид​

Аудитория и сценарии выбора​

VillagerInfo подходит администраторам и игрокам серверов, где активно используются жители. Практические сценарии:

• проверка жителей в торговом зале;
• поиск или визуальное подтверждение рабочего места;
• предоставление игрокам ограниченного диагностического доступа;
• анализ единичной проблемы без просмотра полного набора внутренних данных;
• использование серверной утилиты без клиентского мода.

Для массового управления жителями, изменения торговли или автоматического исправления привязок нужен другой класс инструментов.

Взаимодействие с жителем​

Базовый сценарий — взаимодействие с жителем в приседе. Право villagerinfo.output разрешает вывод и по умолчанию отмечено как включённое. Предусмотрены также подсветка рабочего места и звук, управляемые личными переключателями.

Проверять работу удобно так:

• Выбрать жителя в доступной зоне.
• Взаимодействовать с ним в приседе.
• Оценить текстовый вывод, подсветку и звук.
• Отключить один личный параметр.
• Повторить действие и убедиться, что изменился только выбранный элемент.

Команды и разрешения​

Административная команда villreload перезагружает конфигурацию VillagerInfo. Она требует villagerinfo.reload, которое по умолчанию предназначено только для операторов.

Основная команда — villagerinfo; подтверждённые псевдонимы: vinfo, villinfo и vi. Её доступ регулируется villagerinfo.commands. Также описаны:

• villagerinfo help с правом villagerinfo.commands.help;
• villagerinfo toggle с правом villagerinfo.commands.toggle;
• villagerinfo toggle highlight с правом villagerinfo.commands.toggle.highlight;
• villagerinfo toggle output с правом villagerinfo.commands.toggle.output;
• переключение звука с правом villagerinfo.commands.toggle.sound.

Пользовательские права отмечены как включённые по умолчанию, но итоговый доступ определяется системой прав сервера. villreload не заменяет перезапуск при смене JAR.

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

Подтверждённые платформы — Paper и Purpur. Поддерживаются Minecraft 1.20.5, 1.20.6, 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 и 26.2.

Статус сторон: client=unsupported, server=required. JAR размещается только на сервере. Совместимость с Bukkit, Spigot, Folia и иными платформами в предоставленных данных не подтверждена.

Обязательные project dependencies в выбранных метаданных не указаны. Это не означает совместимость с любым ядром или набором плагинов.

Установка​

Порядок установки на совместимый сервер:

• Сверить версию Minecraft и тип ядра.
• Остановить сервер.
• Сохранить резервную копию папки плагинов и данных VillagerInfo.
• Поместить один выбранный JAR в папку plugins.
• Запустить сервер и просмотреть журнал.
• Проверить команду справки и взаимодействие с жителем.
• Настроить права для нужных групп.

Не следует оставлять одновременно две версии VillagerInfo. При обновлении старый JAR заменяют новым после резервного копирования.

Проверка результата​

После загрузки стоит проверить:

• распознавание основной команды;
• доступ к ней у роли с нужными разрешениями;
• вывод при взаимодействии в приседе;
• отдельную работу подсветки и звука;
• сохранение личных переключателей;
• недоступность административной перезагрузки для обычного игрока.

При отказе одного элемента сначала проверяют его право и переключатель. Полное отсутствие реакции требует проверки платформы, JAR и журнала.

Файлы и хеши​

Версия 4.3.2 представлена файлом VillagerInfo-4.3.2.jar размером 85 415 байт. SHA-512: 68f501ba97545f317cf0fc594464e34a0b817be3942d545dc0999034e92c27f51ead17ccbb5c8235dc354b4ec04c0f38f83bfb75709a45070f95b0c3b419c8f3. SHA-1: 8047f4320743d1f3470fbe413df6adb8680fa402.

Версия 4.2.0 представлена файлом VillagerInfo-4.2.0.jar размером 74 234 байта. SHA-512: ac89f00ac0494b4ea8ac3fdb2ca18757721be32a859fe8136766d24378269d4a29d538cfe2ca5d26c0b777af5dc545f263f1b7eedf9aa27ea6baf4707308a8ca. SHA-1: 04375db78f99ee58e2dfa4e9e97a2dcbeb54c108.

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

Ограничения​

Основные ограничения:

• проект предоставляет доступ к информации, но не заявляет её редактирование;
• точный набор выводимых полей в исходной выдержке не перечислен;
• клиентская версия не поддерживается;
• подтверждены только Paper и Purpur;
• совместимость с плагинами, меняющими жителей или обработку взаимодействия, отдельно не установлена;
• статическая проверка не заменяет тестовый запуск.

Вывод также может быть отключён личной настройкой игрока.

Безопасное обновление и откат​

Перед переходом между 4.2.0 и 4.3.2 сохраняют старый JAR, конфигурацию и данные. Обновление желательно проверить на копии сервера с тем же ядром и системой прав.

Безопасная последовательность:

• Остановить тестовый сервер.
• Заменить только JAR VillagerInfo.
• Проверить запуск, команды и права.
• Протестировать несколько жителей.
• Сравнить личные настройки до и после замены.
• Лишь затем обновить основной экземпляр.

Для отката сервер останавливают и возвращают прежний JAR с согласованной копией данных. При изменении формата одной замены JAR может быть недостаточно. Две версии одновременно не запускают.

Диагностика​

Проблему лучше локализовать по признаку:

• плагин не загрузился — проверить платформу, версию сервера и целостность файла;
• команда неизвестна — проверить журнал и наличие единственного активного JAR;
• команда запрещена — проверить соответствующее разрешение;
• нет вывода — проверить villagerinfo.output и переключатель output;
• нет подсветки — проверить право и переключатель highlight;
• нет звука — проверить право и переключатель sound;
• ошибка появилась после обновления — вернуть резервную копию и сопоставить журналы.

Для чистого теста используют одного игрока, одну роль и одного жителя. Сторонние плагины исключают только на копии сервера.

Лицензия и авторство​

VillagerInfo распространяется по MIT, SPDX: MIT. При локализации сохраняют необходимые уведомления, название проекта и авторство Peashooter101 и Rhythmic. Редакционные выводы статьи не являются заявлениями авторов.

FAQ​

Нужен ли игрокам отдельный мод?​

Нет. Клиентская сторона отмечена как неподдерживаемая, а серверная — как обязательная. Установка выполняется в папку plugins сервера Paper или Purpur.

Можно ли менять данные жителей через VillagerInfo?​

Такое назначение не подтверждено. Плагин описан как средство удобного просмотра полезной информации.

Почему взаимодействие в приседе ничего не показывает?​

Нужно проверить загрузку плагина, право villagerinfo.output, личный переключатель output и отсутствие ошибки в журнале. Затем тест повторяют с другой ролью или другим жителем.

Обязательны ли сторонние зависимости?​

В выбранных метаданных обязательные project dependencies не указаны. Это не распространяет подтверждённую совместимость за пределы заявленных платформ.

Какую версию выбрать?​

Из двух перечисленных выпусков 4.3.2 новее 4.2.0. Практический выбор зависит от версии сервера и результата проверки на тестовой копии.