InteractionVisualizer - живые анимации крафта и плавки на сервере

InteractionVisualizer - серверный плагин для Minecraft, который закрывает давнюю странность ванильной игры. Открываете верстак, раскладываете в нём алмазы и палки, а для окружающих это выглядит так: человек просто стоит и смотрит в блок. Что он крафтит, что жарится в его печке, какие чары листает - никому не видно. С этим плагином видно всё: предметы буквально появляются на верстаке в тот момент, когда игрок кладёт их в сетку, над печкой висит голограмма с прогрессом плавки, а стол зачарований показывает выбранное зачарование ещё до нажатия кнопки.

Вся магия работает через пакеты, то есть сервер ничего лишнего не спавнит и мир не засоряется. Плагин чисто декоративный и очень бережно дополняет ваниль, поэтому лучше всего раскрывается на выживании, уютных SMP и спавнах с магазинами - там, где атмосферу решают мелочи. Если держите сервер на BungeeHost, InteractionVisualizer ставится там в один клик из панели, так что проверить его вживую можно буквально за пару минут.

Что именно визуализирует плагин

Список внушительный, и автор постоянно его расширяет. Вот основное:

• Верстак - все предметы из сетки крафта лежат прямо на столе, а готовый результат отображается над ним.
• Печка, плавильня и коптильня - видно, что внутри, плюс плавающий текст с прогрессом и топливом.
• Стол зачарований - над столом показываются доступные чары и их уровни.
• Картографический стол - карта лежит в рамке прямо на блоке.
• Наковальня, точило, кузнечный стол, камнерез, ткацкий станок - вложенные предметы видны всем проходящим мимо.
• Варочная стойка - зелья и ингредиенты на виду.
• Проигрыватель, нотный блок, компостер, котёл, ульи и другие интерактивные блоки тоже получили свои анимации.

В галерее собраны GIF-анимации почти для каждого блока - тут правда лучше один раз увидеть, чем читать описания.

Клиентская сторона: почему это не лагает

Это главная фишка плагина, так что объясню подробнее.

• Все предметы и голограммы существуют только на клиенте. На сервере их физически нет.
• Их нельзя убить командой /kill и нельзя подобрать.
• Они никак не влияют на мир: не вызывают дюпов, не ломают физику, не грузят тик.

По факту сервер просто отправляет игрокам пакеты вида "нарисуй тут предмет", а дальше всё делает клиент. Из-за этого даже на слабом железе просадки минимальны, а TPS сервера вообще не страдает.

Настройка под себя

• Каждый тип визуализации отключается в конфиге отдельно. Не нравится голограмма над печкой - выключаете только её.
• Игроки тоже могут переключать часть опций под себя командой /iv toggle.
• Данные переключателей сохраняются в SQLite (по умолчанию) или в MySQL, если у вас целая сеть серверов.
• Текст голограмм автоматически подстраивается под язык клиента каждого игрока: русскому покажет по-русски, англоязычному - по-английски.
• Переводов от сообщества накопилось много, есть из чего выбрать.

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

Плагин работает на Bukkit, Spigot, Paper, Purpur и Folia. Поддерживаются версии Майнкрафт от 1.13 и новее, включая самые свежие релизы игры - проект активно обновляется, и под актуальные версии апдейты выходят оперативно. Для старых версий есть отдельные ветки.

Зависимости нужны только на старых версиях:

• ProtocolLib - только если сервер на 1.12.2 или ниже (ставьте последнюю версию, совместимую с вашей сборкой).
• LightAPI Fork - только для 1.16.5 и ниже. Важный нюанс: нужен именно форк, оригинальный LightAPI не подойдёт.

На современных версиях плагин вообще ничего не требует - закинул в папку и работает.

Интеграции с другими плагинами

• OpenInv - если открыть чужой сундук в тихом режиме (silent chest), анимации отключаются.
• SuperVanish и PremiumVanish - в ванише все анимации выключаются, вас не выдаст парящий предмет.
• CMI - то же самое при ванише.
• EssentialsX - анимации отключаются в ванише.

Для админов, которые следят за игроками из ваниша, это прям must-have деталь: никакая случайная голограмма не спалит ваше присутствие рядом с чужой печкой.

Установка

1. Положите InteractionVisualizer.jar и все нужные зависимости в папку plugins.
2. Запустите сервер.
3. Отредактируйте конфиг под себя.
4. Перезапустите сервер.

Если арендуете хостинг серверов Майнкрафт на BungeeHost, всё ещё проще: плагин устанавливается в один клик, и запустить сервер с ним можно за пару минут, даже если вы впервые создаёте свой проект.

Команды

/interactionvisualizer reload - перезагружает плагин
/interactionvisualizer refresh - обновляет все отображения предметов для выполнившего команду
/interactionvisualizer update - проверяет наличие обновлений
/interactionvisualizer toggle - переключает опции отображения
(короткий вариант - /iv)

Права

interactionvisualizer.reload - перезагрузка плагина [по умолчанию: op]
interactionvisualizer.refresh - обновление отображений [по умолчанию: true]
interactionvisualizer.toggle - переключение модулей [по умолчанию: true]
interactionvisualizer.toggle.others - переключение модулей для других игроков [по умолчанию: op]
interactionvisualizer.update - получение сообщений об обновлениях [по умолчанию: op]

Плейсхолдеры

Если на сервере стоит PlaceholderAPI, статус переключателей игрока можно вытаскивать через плейсхолдеры:

%interactionvisualizer_itemstand_<entry>%
%interactionvisualizer_itemdrop_<entry>%
%interactionvisualizer_hologram_<entry>%

Например, если игрок включил модуль itemstand для верстака, то %interactionvisualizer_itemstand_crafting_table% вернёт enabled, а если выключил - disabled. Удобно для меню, скорбордов и всяких кастомных интерфейсов.

Важно знать

Как работает /iv toggle

В команде /iv toggle три режима, каждый отвечает за свою механику отображения:

• itemstand - визуальные предметы, созданные через стойки для брони (те, что лежат плашмя на блоках, а не болтаются, как обычный дроп), и рамки (например, карта на картографическом столе).
• itemdrop - всё, что отображается в виде выброшенного предмета.
• hologram - весь плавающий текст (полоса прогресса печки и тому подобное).

Настройки хранятся в базе данных, так что после перезахода на сервер ничего не слетает.

Ошибка сохранения blockdata.json

Если в консоли появилась ошибка о проблемах при сохранении blockdata.json - скорее всего, сервер был некорректно выключен. Лечится просто: зайдите в папку плагина InteractionVisualizer и замените blockdata.json одной из резервных копий из папки backup. Совет на будущее - всегда останавливайте сервер командой stop, а не закрытием окна консоли.

API для разработчиков

У плагина есть открытый API, так что сторонние разработчики могут писать аддоны и подключать собственные визуализации.

Ограничения и сбор данных

• На версиях 1.10.2 и ниже плагин может не работать.
• Плагин отправляет анонимную статистику использования в bStats (публичные графики, никаких приватных данных сервера не передаётся) и проверяет обновления через API автора, чтобы уведомлять о новых версиях.

Стоит ли ставить

InteractionVisualizer - один из тех плагинов, после которых сервер без него кажется пустым. Крафтовая зона на спавне, плавильня, комната зачарований - всё это вдруг оживает, а игроки начинают подглядывать, что там варится у соседа. Производительность при этом почти не страдает, ведь вся нагрузка ложится на клиент, а не на сервер. Скачать плагин InteractionVisualizer стоит каждому, кто держит выживание или SMP на Paper или Purpur и хочет добавить миру живых деталей без единого мода на стороне игроков.