- Документация
- https://modrinth.com/plugin/imagemaps
ImageMaps — декоративный плагин для Paper и Folia, создающий карты Minecraft из изображений. Отдельный клиентский компонент не заявлен: клиентская сторона указана как unsupported, серверная — как required.
Проект относится к категории decoration. Подтверждено преобразование изображения в карту; многочастные панно, редактор, анимация и коллекции в данных не описаны.
ImageMaps подходит для переноса внешней графики в игровой мир. Практические сценарии:
• декоративные картины в интерьерах;
• эмблемы и символика игровых зон;
• информационные стенды;
• иллюстрации для выставок и тематических построек;
• тестовые изображения при подготовке оформления.
Плагин подходит администраторам и строителям. Масштабирование, разбиение на несколько карт, подписи и библиотека требуют отдельного подтверждения.
Подтверждены Minecraft 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 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.
Заявлены Paper и Folia. Bukkit и Spigot в списке отсутствуют, поэтому совместимость с ними предполагать нельзя. Поддержка Folia не гарантирует безошибочную работу в любой комбинации ядра, Java и плагинов.
Рассматриваемая сборка называется ImageMaps-1.0.jar. Размер — 15099 байт, версия — 1.0. Контрольные суммы:
• SHA-512: f73a18c3126f8e5dd1396ac60540f18def1b6071593ed2358c87c21c83db360a3b9e95e067745332f44ac5264115f52e1526eae744f9caf9ca2f5a854b3f6aaf;
• SHA-1: 4a0146459bebf2bbf3e360f069bf0cbb24e62e4e.
Файл получен по официальному HTTPS и локально сверён по опубликованным хешам. Архив прошёл статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому подтверждена целостность проверенного экземпляра, но не его фактическая работа на конкретном сервере.
В выбранных метаданных обязательные project dependencies не указаны. Это не доказывает совместимость с любыми форками Paper, плагинами карт или нестандартными хранилищами.
Требования к Java, сетевым тайм-аутам и внешним запросам не приведены. Следует учитывать требования Paper или Folia и фактический журнал ImageMaps.
JAR помещают в папку plugins совместимого сервера:
• Полностью остановить Paper- или Folia-сервер.
• Создать резервную копию мира и папки плагинов.
• При обновлении отдельно сохранить прежний JAR и данные ImageMaps.
• Проверить имя, размер и при необходимости хеш файла.
• Поместить ImageMaps-1.0.jar в plugins.
• Запустить сервер и изучить журнал загрузки.
JAR не следует заменять при работающем сервере: горячая перезагрузка может оставить старое состояние в памяти.
В официальном тексте приведена команда:
/imagemaps:createmap (url to image)
Команда принимает адрес изображения и создаёт карту. Без адреса, согласно описанию, генерируется случайная картинка с котом; её источник и сетевые условия не раскрыты.
Команду следует проверить с нейтральным изображением. Права доступа не описаны, поэтому круг пользователей определяют по фактическому поведению версии.
Сначала нужно убедиться, что сервер распознал JAR и включил ImageMaps без связанного исключения. Затем выполняют функциональную проверку:
• создать карту из доступного тестового изображения;
• убедиться, что предмет или результат действительно создан;
• проверить отображение изображения в игровом мире;
• перезапустить сервер и проверить сохранность карты;
• отдельно вызвать функцию без адреса;
• проверить доступ от учётной записи без административных прав;
• просмотреть журнал на предмет ошибок загрузки и обработки.
Алгоритм преобразования не описан, поэтому точность цветов, масштаб и кадрирование гарантировать нельзя.
Не указаны форматы, максимальный размер, разрешение, соотношение сторон, прозрачность, анимация, перенаправления, кэширование, удаление данных, частотные лимиты и предел числа карт.
Не подтверждены масштабирование, обрезка, разбиение на панно, размещение в рамках и восстановление недоступного источника. Критичные функции проверяют на копии сервера.
Команда принимает адрес, поэтому сервер может обращаться к внешнему источнику. Сетевой механизм и фильтрация не раскрыты. Общие меры:
• использовать ожидаемые и доверенные источники;
• не передавать адреса с секретами или временными токенами;
• не разрешать массовое создание до проверки нагрузки;
• отслеживать задержки и сетевые ошибки в журнале;
• учитывать права на публикуемые изображения;
• отделять техническую загрузку от разрешения на распространение контента.
Это общие меры, а не утверждение о конкретной уязвимости.
Перед заменой версии следует:
• записать версии Minecraft, ядра и ImageMaps;
• сохранить старый JAR и связанные данные;
• сделать копию мира;
• остановить сервер;
• установить новую сборку;
• проверить загрузку и создание тестовой карты;
• выполнить полный рестарт и проверить старые карты.
Формат данных и межверсионная совместимость не описаны, поэтому обновление сначала проверяют на копии окружения.
При сбое сервер останавливают и восстанавливают прежний JAR вместе с копией данных. Одного файла может быть мало, если обновление изменило хранилище или идентификаторы карт.
Затем проверяют журнал, тестовую карту, существующие объекты и сохранность после рестарта. Обратная совместимость не подтверждена, поэтому откат без копии рискован.
Проверку удобно вести последовательно:
• Убедиться, что используется Paper или Folia.
• Сверить версию Minecraft с подтверждённым списком.
• Исключить наличие нескольких JAR ImageMaps.
• Проверить размер и контрольную сумму файла.
• Найти в журнале первую ошибку плагина.
• Повторить официальный вызов с простым доступным изображением.
• Отдельно проверить вызов без адреса.
• Провести опыт на копии сервера с минимальным набором плагинов.
Если команда не распознаётся, вероятна проблема загрузки или регистрации. Если она доступна, различают сетевой сбой, неподдерживаемые данные и внутреннее исключение. Важен связанный фрагмент журнала без секретов.
Подтверждённые авторы — Saltzus и RealDoggoHitman. Лицензия и SPDX-идентификатор — MIT; использование, изменение и распространение допускаются при её соблюдении.
Локализация разрешена, но нужно сохранить название ImageMaps, авторство и лицензию. Независимые выводы нельзя представлять как гарантии авторов.
Нет отдельного клиентского компонента. В метаданных клиентская сторона указана как unsupported, серверная — как required. JAR устанавливает администратор в папку plugins.
Подтверждены Paper и Folia. Совместимость с Bukkit, Spigot и другими платформами в предоставленной основе не заявлена.
По официальному описанию создаётся случайная картинка с котом. Источник и сетевые условия этого режима не указаны, поэтому результат следует проверить в тестовом окружении.
Совпадение хешей подтверждает целостность файла относительно опубликованных значений. Статическая проверка оценивает структуру архива, но динамический запуск не проводился и работоспособность не подтверждает.
Проект относится к категории decoration. Подтверждено преобразование изображения в карту; многочастные панно, редактор, анимация и коллекции в данных не описаны.
Назначение и возможные сценарии
ImageMaps подходит для переноса внешней графики в игровой мир. Практические сценарии:
• декоративные картины в интерьерах;
• эмблемы и символика игровых зон;
• информационные стенды;
• иллюстрации для выставок и тематических построек;
• тестовые изображения при подготовке оформления.
Плагин подходит администраторам и строителям. Масштабирование, разбиение на несколько карт, подписи и библиотека требуют отдельного подтверждения.
Скриншоты и внешний вид
Совместимость с Minecraft
Подтверждены Minecraft 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 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.
Заявлены Paper и Folia. Bukkit и Spigot в списке отсутствуют, поэтому совместимость с ними предполагать нельзя. Поддержка Folia не гарантирует безошибочную работу в любой комбинации ядра, Java и плагинов.
Файл версии 1.0
Рассматриваемая сборка называется ImageMaps-1.0.jar. Размер — 15099 байт, версия — 1.0. Контрольные суммы:
• SHA-512: f73a18c3126f8e5dd1396ac60540f18def1b6071593ed2358c87c21c83db360a3b9e95e067745332f44ac5264115f52e1526eae744f9caf9ca2f5a854b3f6aaf;
• SHA-1: 4a0146459bebf2bbf3e360f069bf0cbb24e62e4e.
Файл получен по официальному HTTPS и локально сверён по опубликованным хешам. Архив прошёл статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому подтверждена целостность проверенного экземпляра, но не его фактическая работа на конкретном сервере.
Зависимости и серверная среда
В выбранных метаданных обязательные project dependencies не указаны. Это не доказывает совместимость с любыми форками Paper, плагинами карт или нестандартными хранилищами.
Требования к Java, сетевым тайм-аутам и внешним запросам не приведены. Следует учитывать требования Paper или Folia и фактический журнал ImageMaps.
Установка ImageMaps
JAR помещают в папку plugins совместимого сервера:
• Полностью остановить Paper- или Folia-сервер.
• Создать резервную копию мира и папки плагинов.
• При обновлении отдельно сохранить прежний JAR и данные ImageMaps.
• Проверить имя, размер и при необходимости хеш файла.
• Поместить ImageMaps-1.0.jar в plugins.
• Запустить сервер и изучить журнал загрузки.
JAR не следует заменять при работающем сервере: горячая перезагрузка может оставить старое состояние в памяти.
Создание карты
В официальном тексте приведена команда:
/imagemaps:createmap (url to image)
Команда принимает адрес изображения и создаёт карту. Без адреса, согласно описанию, генерируется случайная картинка с котом; её источник и сетевые условия не раскрыты.
Команду следует проверить с нейтральным изображением. Права доступа не описаны, поэтому круг пользователей определяют по фактическому поведению версии.
Проверка результата
Сначала нужно убедиться, что сервер распознал JAR и включил ImageMaps без связанного исключения. Затем выполняют функциональную проверку:
• создать карту из доступного тестового изображения;
• убедиться, что предмет или результат действительно создан;
• проверить отображение изображения в игровом мире;
• перезапустить сервер и проверить сохранность карты;
• отдельно вызвать функцию без адреса;
• проверить доступ от учётной записи без административных прав;
• просмотреть журнал на предмет ошибок загрузки и обработки.
Алгоритм преобразования не описан, поэтому точность цветов, масштаб и кадрирование гарантировать нельзя.
Ограничения подтверждённых данных
Не указаны форматы, максимальный размер, разрешение, соотношение сторон, прозрачность, анимация, перенаправления, кэширование, удаление данных, частотные лимиты и предел числа карт.
Не подтверждены масштабирование, обрезка, разбиение на панно, размещение в рамках и восстановление недоступного источника. Критичные функции проверяют на копии сервера.
Внешние изображения и безопасность
Команда принимает адрес, поэтому сервер может обращаться к внешнему источнику. Сетевой механизм и фильтрация не раскрыты. Общие меры:
• использовать ожидаемые и доверенные источники;
• не передавать адреса с секретами или временными токенами;
• не разрешать массовое создание до проверки нагрузки;
• отслеживать задержки и сетевые ошибки в журнале;
• учитывать права на публикуемые изображения;
• отделять техническую загрузку от разрешения на распространение контента.
Это общие меры, а не утверждение о конкретной уязвимости.
Безопасное обновление
Перед заменой версии следует:
• записать версии Minecraft, ядра и ImageMaps;
• сохранить старый JAR и связанные данные;
• сделать копию мира;
• остановить сервер;
• установить новую сборку;
• проверить загрузку и создание тестовой карты;
• выполнить полный рестарт и проверить старые карты.
Формат данных и межверсионная совместимость не описаны, поэтому обновление сначала проверяют на копии окружения.
Откат
При сбое сервер останавливают и восстанавливают прежний JAR вместе с копией данных. Одного файла может быть мало, если обновление изменило хранилище или идентификаторы карт.
Затем проверяют журнал, тестовую карту, существующие объекты и сохранность после рестарта. Обратная совместимость не подтверждена, поэтому откат без копии рискован.
Диагностика неполадок
Проверку удобно вести последовательно:
• Убедиться, что используется Paper или Folia.
• Сверить версию Minecraft с подтверждённым списком.
• Исключить наличие нескольких JAR ImageMaps.
• Проверить размер и контрольную сумму файла.
• Найти в журнале первую ошибку плагина.
• Повторить официальный вызов с простым доступным изображением.
• Отдельно проверить вызов без адреса.
• Провести опыт на копии сервера с минимальным набором плагинов.
Если команда не распознаётся, вероятна проблема загрузки или регистрации. Если она доступна, различают сетевой сбой, неподдерживаемые данные и внутреннее исключение. Важен связанный фрагмент журнала без секретов.
Лицензия и авторство
Подтверждённые авторы — Saltzus и RealDoggoHitman. Лицензия и SPDX-идентификатор — MIT; использование, изменение и распространение допускаются при её соблюдении.
Локализация разрешена, но нужно сохранить название ImageMaps, авторство и лицензию. Независимые выводы нельзя представлять как гарантии авторов.
FAQ
Нужен ли плагин на клиенте?
Нет отдельного клиентского компонента. В метаданных клиентская сторона указана как unsupported, серверная — как required. JAR устанавливает администратор в папку plugins.
Какие платформы подтверждены?
Подтверждены Paper и Folia. Совместимость с Bukkit, Spigot и другими платформами в предоставленной основе не заявлена.
Что будет без адреса изображения?
По официальному описанию создаётся случайная картинка с котом. Источник и сетевые условия этого режима не указаны, поэтому результат следует проверить в тестовом окружении.
Что доказывает проверка хешей?
Совпадение хешей подтверждает целостность файла относительно опубликованных значений. Статическая проверка оценивает структуру архива, но динамический запуск не проводился и работоспособность не подтверждает.
