О плагине

В ванильном Minecraft, когда ты открываешь верстак или печь, никто вокруг не видит, что ты там делаешь. Вроде бы логично, что предметы должны отображаться на столе, как в реальной жизни? С InteractionVisualizer это стало реальностью! Теперь предметы, которые игроки кладут в GUI, буквально появляются на соответствующих блоках в мире. И это далеко не всё.

Возможности

1. Визуализация блоков и сущностей

Плагин умеет показывать анимации для множества блоков: верстаки, печи, столы зачарования, кузнечные столы, картографические столы и другие. Всё работает через пакеты (packets) - никаких лишних сущностей на сервере.

Смотрите галерею с GIF-анимациями почти для каждого блока!

2. Клиентская сторона - без нагрузки на сервер

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

3. Гибкая настройка

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

Зависимости

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

Поддержка других плагинов

• OpenInv - при включённом silent chest анимации сундуков отключаются.
• SuperVanish и PremiumVanish - все анимации отключаются в режиме невидимости.
• CMI - то же самое, анимации отключаются при ванише.
• Essentials - аналогично.

Установка

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

Сборочные версии (Development Builds)

Доступны на Jenkins.

Демо-сервер

Хочешь попробовать плагин в деле? Заходи на сервер:

IP: mc.loohpjames.com

Важно знать

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

Команда /iv toggle имеет три режима, которые включают или отключают определённые механики отображения:

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

Данные о настройках игрока сохраняются в базе данных.

Ошибка с blockdata.json - что делать?

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

Плейсхолдеры (PlaceholderAPI)

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

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

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

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

InteractionVisualizer предоставляет API для создания аддонов. Подробности на вики GitHub: https://github.com/LOOHP/InteractionVisualizer/wiki/Developer-API

Команды

• /interactionvisualizer reload - перезагрузить плагин.
• /interactionvisualizer refresh - обновить все отображения предметов для игрока.
• /interactionvisualizer update - проверить обновления.
• /interactionvisualizer toggle - переключить опции отображения.

Сокращённый вариант: /iv.

Права (Permissions)

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

Конфиг по умолчанию

Актуальный конфиг с описаниями можно найти в репозитории.

Ограничения

• Плагин может не работать на Minecraft версии 1.10.2 и ниже.

Использование данных

Статистика использования отправляется на bStats (https://bstats.org/plugin/bukkit/InteractiveChat) - никакой приватной информации сервера не передаётся. Также выполняется проверка обновлений через https://api.loohpjames.com, чтобы уведомлять о новых версиях.

Зачем это нужно?

Если ты собираешь сервер, где важна атмосфера и погружение - InteractionVisualizer просто must-have. Игроки перестанут чувствовать, что они в изоляции, когда открывают интерфейс. Визуализация делает взаимодействие с блоками наглядным и живым. Особенно круто это работает на серверах с мини-играми или RPG, где крафт и зачарование - часть процесса. Да и просто приятно видеть, как предметы появляются на верстаке, когда ты что-то мастеришь.

Скачай InteractionVisualizer и добавь немного магии в свой Minecraft!