MapArt (Мапарт)

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

Возможности

• Поддерживает изображения PNG, JPG, GIF и BMP.
• Обрезает и масштабирует изображение под размер карты.
• Разбивает большие рисунки на несколько карт, из которых можно собрать мозаику.
• У каждого игрока отдельная папка с загруженными файлами: plugins/MapArt/images/<playerUUID>/.
• Поддерживает архитектуру Folia.

Команды

• /mapart или /mapart gui — открыть меню со своими изображениями.
• /mapart upload — получить ссылку для загрузки изображения.
• /mapart list — показать доступные игроку файлы.
• /mapart apply <image file> [scale|tile] — перенести изображение на карту.
• /mapart clear — очистить созданные картины на картах.
• /mapart info — показать число карт в инвентаре.

Режим scale используется по умолчанию: изображение приводится к размеру 128×128 пикселей и создаётся одна карта. В режиме tile файл сохраняет размер и делится на фрагменты 128×128 пикселей для мозаики. Для одной карты лучше подготовить изображение 128×128: карты Майнкрафт используют 128 цветов, поэтому контрастные и пиксельные рисунки выглядят точнее, чем изображения с плавными градиентами.

Права

• mapart.use — использование команд плагина.
• mapart.admin — права администратора.

Настройка

Основной файл настроек: plugins/MapArt/config.yml.

• web-server.enabled — включает встроенную загрузку через браузер.
• web-server.host, web-server.port и web-server.public-url — адрес, порт и ссылка, которую открывают игроки. Для прямого подключения public-url использует HTTP; HTTPS подходит при обратном прокси.
• max-image-width и max-image-height — максимальные размеры загружаемых файлов в пикселях.
• map-size — размер одной карты в пикселях.
• async-processing и max-concurrent-tasks — асинхронная обработка и число одновременных задач.

При отключённом веб-сервере изображения можно поместить вручную в plugins/MapArt/images/.

Требования

Плагину нужен сервер на Purpur или Paper и Java 21 или выше.