ImageFrame

Плагин ImageFrame для Minecraft — отображение изображений на картах и предметах

Основное назначение и визуализация

Плагин ImageFrame предназначен для администраторов серверов, желающих визуально улучшить оформление базы, информационных стендов или игровых локаций. Основная функция заключается в загрузке изображений из внешних URL-адресов и их размещении на обычных картах мира (Vanilla Maps) или непосредственно на предметах-рамках (Item Frames). Поддерживаются форматы PNG, JPEG, WEBP и GIF. Картинки автоматически подстраиваются под размер рамки, избегая искажений, что позволяет создавать четкие и эстетичные вывески или декоративные элементы без необходимости ручной настройки пропорций. Это решение идеально подходит для создания анимированных экранов телевизоров в домашних базах или сложных вывесок, таких как табло на станциях метро, которые можно разместить на стене с помощью нескольких рамок.

Работа с анимацией и масштабирование

Одной из ключевых особенностей является поддержка анимированных GIF-изображений. Анимация воспроизводится асинхронно с частотой до 1/20 секунды, что обеспечивает плавность без нагрузки на основной поток сервера. Пользователи могут задать произвольную ширину и высоту для изображения, позволяя ему занимать несколько карт одновременно. Это особенно полезно для создания крупных вывесок, таких как табло на станциях метро, которые можно разместить на стене с помощью нескольких рамок. Автоматическое подгоняние размера гарантирует корректное отображение независимо от выбранного разрешения.

Интеграция с картами и наложения

Плагин предлагает уникальный способ наложения пользовательского изображения поверх стандартной карты мира. Администратор может создать карту с наложением, держа в руке обычную карту из мира, либо выбрать несколько рамок для размещения многослойной карты. Также доступна функция создания объединенной карты (Combined ImageMap), которая собирает разрозненные части изображения в один предмет. Это упрощает управление и размещение: при разрушении такой рамки возвращается единый объект, а система автоматически ищет подходящее место на стене, полу или потолке для установки. Система уважает защиты рамок других плагинов, вызывая соответствующие события Bukkit.

Управление и обновление контента

Для поддержания актуальности контента предусмотрена функция обновления карт по ссылке. Администратор может запустить команду для обновления всех копий одной и той же карты, скачанных с исходного URL, без необходимости вручную заменять каждый предмет в инвентарях игроков. Это идеально подходит для информационных стендов, где данные меняются регулярно. Кроме того, в карты можно добавлять маркеры, используя стандартные иконки из карт мира (например, иконки манора или храма) с возможностью добавления подписи. Количество маркеров на одной карте настраивается в конфигурации.

Система прав доступа и команд

Плагин предоставляет разграничение прав доступа для управления созданными картами. Игроки могут назначать права другим пользователям: например, разрешить просматривать список карт, создавать их для других игроков или удалять чужие карты. Команды делятся на административные (перезагрузка, миграция данных, обновление) и игровые (создание, копирование, удаление, установка прав). Для модерации предусмотрен доступ к списку карт конкретного игрока, а также возможность изменения создателя карты или удаления её по ID. Система также поддерживает миграцию данных из сторонних плагинов, таких как ImageMap, ImageOnMap и DrMap.

Поддержка выживания и невидимые рамки

Для серверов в режиме выживания (Survival) реализована система невидимых рамок предметов. Игроки могут получить такие рамки, используя зелья невидимости. Плагин автоматически управляет этими предметами, позволяя размещать изображения на невидимых рамках, что создает эффект «плавающих» картин или скрытых вывесок. Также доступна настройка ограничения количества создаваемых карт на игрока и максимального размера рамки, что помогает администраторам контролировать нагрузку на инвентарь и сервер. Для создания карт игрокам в режиме выживания требуется наличие пустых карт в инвентаре.

Мульти-серверная поддержка и язык

С помощью поддержки хранилища MySQL можно синхронизировать созданные карты между несколькими серверами в сети. Это позволяет администратору создать изображение на одном сервере и автоматически получить его доступность на других узлах сети без повторной установки. Плагин не требует установки на прокси-серверы типа Bungeecord или Velocity. Сообщество может способствовать развитию проекта, добавляя переводы сообщений на другие языки через платформу Crowdin, так как текущая версия не содержит полных локализаций.

Дополнительные интеграции и данные

Для просмотра изображений в высоком разрешении и цвете рекомендуется использовать дополнительный клиентский мод ImageFrame Client, который интегрируется с плагин. Сами данные о количестве скачиваний и статистике использования передаются на сервис bStats для аналитики, при этом конфиденциальная информация о сервере не отправляется. Проверка на наличие обновлений также выполняется через внешний API. Плагин разработан автором LOOHP и распространяется под лицензией GPL-3.0-only.

Команды администратора

/imageframe reload — Перезагружает плагин.
/imageframe update — Проверяет наличие обновлений.
/imageframe storagemigrate — Перемещение типа хранилища данных.

Команды для игроков

/imageframe select — Выбор рамок для размещения карт.
/imageframe create — Создание новой карты.
/imageframe create selection — Создание карты и установка на выбранные рамки.
/imageframe create combined — Создание карты и получение объединенного предмета.
/imageframe overlay — Создание карты с наложением на карту в руке.
/imageframe overlay selection — Создание карты с наложением на карты в выбранных рамках.
/imageframe clone — Создание копии карты с теми же свойствами.
/imageframe clone selection — Копирование карты на выбранные рамки.
/imageframe clone combined — Копирование карты в виде объединенного предмета.
/imageframe playback pause — Включение/выключение паузы для анимации.
/imageframe playback jumpto — Переход к конкретной секунде воспроизведения.
/imageframe refresh [имя] [новый_url] — Обновление карты по источнику.
/imageframe info — Получение информации о карте в руке.
/imageframe get — Получение созданной ранее карты.
/imageframe get selection — Установка созданной карты на выбранные рамки.
/imageframe get combined — Получение созданной карты в виде объединенного предмета.
/imageframe delete — Удаление созданной карты.
/imageframe rename — Переименование карты.
/imageframe list — Список всех созданных карт.
/imageframe marker add [подпись] — Добавление маркера.
/imageframe marker remove — Удаление маркера.
/imageframe marker clear — Очистка всех маркеров.
/imageframe setaccess — Установить права доступа для других игроков.

Команды модерации

/imageframe list — Список карт конкретного игрока.
/imageframe giveinvisibleframe [кол-во] [игрок] — Выдача невидимых рамок.
/imageframe adminsetcreator — Изменение создателя карты.
/imageframe adminmigrate — Миграция данных из стороннего плагина.