BlueMapSkinSupport: корректные скины игроков на карте BlueMap
Когда сервер Minecraft использует BlueMap для создания интерактивной веб-карты мира, одна из первых деталей, которую замечают игроки, — это отображение их голов на карте. Стандартный загрузчик скинов BlueMap отлично работает в обычном онлайн-режиме, но как только на сервере появляются кастомные скины через плагины вроде SkinsRestorer или сервер запущен в оффлайн-режиме, головы игроков превращаются в безликие кубы. Плагин BlueMapSkinSupport решает эту проблему, заставляя BlueMap корректно получать и отображать скины из сторонних источников.
Что такое BlueMapSkinSupport и зачем он нужен
BlueMapSkinSupport — это небольшой Bukkit-плагин, который расширяет возможности BlueMap по работе с игровыми скинами. По умолчанию BlueMap запрашивает скины напрямую у серверов Mojang, но если сервер использует оффлайн-режим или плагины для смены скинов, стандартный механизм не справляется. BlueMapSkinSupport перехватывает процесс генерации голов игроков и подставляет правильные текстуры, полученные от установленных скин-провайдеров. В результате на веб-карте отображаются именно те скины, которые видят игроки в самой игре.
Плагин генерирует головы игроков точно таким же способом, как это делает встроенный загрузчик BlueMap, поэтому качество и производительность остаются на прежнем уровне. Это особенно важно для серверов с большим количеством игроков, где каждая лишняя задержка может быть заметна.
Поддерживаемые плагины для скинов
BlueMapSkinSupport официально поддерживает два популярных плагина для управления скинами:
- SkinsRestorer / SkinsRestorerX — версии 15.x и выше, а также 14.x (минимальная 14.1). Это рекомендуемый вариант, так как проект активно развивается.
- CustomSkinsManager — устаревший плагин, разработка которого прекращена. Поддержка добавлена по запросу сообщества, но использовать его стоит только в исключительных случаях.
Важно понимать, что наличие этих плагинов не является обязательным. BlueMapSkinSupport способен работать даже без них, если по какой-то причине серверу нужна только коррекция скинов для оффлайн-режима. Гибкость настройки позволяет администратору выбрать именно ту конфигурацию, которая подходит под его сборку.
Установка на сервер Minecraft
Процесс установки прост и не требует глубоких технических знаний, но важно соблюдать последовательность шагов. Ниже приведена инструкция для Paper, Spigot или CraftBukkit версии 1.8 и выше. Плагин также работает на любых форках, способных загружать Bukkit-плагины. Если используется BungeeCord или Waterfall, BlueMapSkinSupport необходимо установить на каждый бекенд-сервер отдельно.
Требования
- Серверное ядро: Paper (рекомендуется), Spigot или CraftBukkit для Minecraft 1.8+.
- BlueMap версии 3.8 или выше (требуется BlueMapAPI 2.3.0+). При желании можно адаптировать плагин для старых версий BlueMap вплоть до 2.1, но для этого потребуется небольшая правка исходного кода.
- Опционально: один из поддерживаемых плагинов для скинов (SkinsRestorer или CustomSkinsManager).
Пошаговая установка
- Полностью остановите сервер командой /stop.
- Скачайте последний .jar-файл со страницы релизов GitHub. Никаких внешних ссылок не требуется — просто найдите репозиторий BlueMapSkinSupport на GitHub.
- Скопируйте скачанный файл в папку /plugins/ вашего сервера.
- При необходимости настройте поведение плагина через конфигурационный файл /plugins/BlueMapSkinSupport/config.yml. По умолчанию параметры уже оптимальны, но вы можете изменить их под свои нужды.
- Откройте файл plugin.conf самого BlueMap и отключите встроенный загрузчик скинов. Это предотвратит конфликт и перезапись сгенерированных голов.
- Запустите сервер и проверьте веб-интерфейс BlueMap — головы игроков должны отображаться корректно.
Кстати, если вы играете на нескольких серверах и вам надоело вручную управлять модами и версиями, присмотритесь к лаунчеру foxygame.net. Он позволяет устанавливать моды прямо из меню, гибко настраивать сборки и быстро переключаться между серверами — удобный инструмент для тех, кто ценит современный подход к игре.
Сборка плагина из исходников
Если вы предпочитаете собрать плагин самостоятельно, процесс также не вызовет трудностей. Для компиляции потребуется JDK 8 (Adoptium Temurin 8 LTS OpenJDK) и Maven. Хотя более новые версии JDK тоже подходят, цель на JDK 8 выбрана для максимальной совместимости со старыми серверами.
Сборка в IntelliJ IDEA
- Клонируйте Git-репозиторий:
git clone https://github.com/akemin-dayo/BlueMapSkinSupport.git. - Откройте проект в IntelliJ IDEA (Community Edition бесплатна).
- Перейдите на панель Maven справа, раскройте раздел «Lifecycle» и дважды кликните по package.
- Готовый JAR-файл появится в папке /target/.
Сборка через командную строку
- Выполните
git clone https://github.com/akemin-dayo/BlueMapSkinSupport.git. - Перейдите в директорию проекта:
cd BlueMapSkinSupport. - Запустите сборку:
mvn package. - Найдите собранный JAR в папке /target/.
Для установки Maven на macOS используйте brew install maven, на Debian-подобных Linux — sudo apt install maven. Пользователям Windows проще воспользоваться IntelliJ IDEA, так как настройка Maven в командной строке может потребовать дополнительных шагов.
Заключение
BlueMapSkinSupport — это небольшой, но крайне полезный плагин, который устраняет досадный разрыв между тем, что видят игроки в клиенте, и тем, что отображается на веб-карте BlueMap. Благодаря поддержке SkinsRestorer и возможности работы в оффлайн-режиме, он становится незаменимым инструментом для администраторов серверов, ценящих визуальную целостность своего проекта. Простая установка, минимальное потребление ресурсов и совместимость с большинством популярных ядер делают его отличным дополнением к любой серверной сборке. Попробуйте BlueMapSkinSupport, и ваша карта мира заиграет новыми красками, отражая индивидуальность каждого игрока.