Bedrock Skin Restorer [GeyserMC/Floodgate]

О чём речь

Если у тебя на сервере стоят Geyser и Floodgate - ты знаешь эту беду. Bedrock-игроки заходят, а их скины превращаются в стандартные скины Java Edition. Вместо крутого пресета или своей аватарки - какой-то Стив или Алекс. Floodgate, по факту, ужасно справляется с этой задачей.

Плагин Bedrock Skin Restorer решает это раз и навсегда. Он просто показывает настоящий скин игрока Bedrock Edition на твоём сервере. Никаких клиентских модов, никаких ручных назначений. Всё работает из коробки.

Как это работает

Плагин стягивает сырой файл скина через глобальное API GeyserMC (раздел Skins) и подменяет дефолтный скин игрока на исправленную версию. Срабатывает при определённых событиях - например, при входе на сервер или при респавне. Все настройки гибко конфигурируются через config.yml.

Важно: плагин рассчитан на Paper (и всё, что на нём основано: Bukkit, Spigot, Purpur, Folia). Это не расширение Geyser, а отдельный плагин. 4D-геометрия и кастомные модели скинов не поддерживаются и не будут добавляться - это технически невозможно без серверных (Forge, NeoForge, Fabric, Quilt) или клиентских модов.

Почему стоит использовать именно его

• Лёгкий - совместим с экосистемой Paper, мультиверсионный, почти не нагружает сервер.
• Plug-and-play - поставил и забыл. Конфиг есть, но все "game-changer" опции отключены по умолчанию.
• Решает проблему - Floodgate не справляется, а конкуренты либо глючат, либо требуют лишних телодвижений.

А что с конкурентами?

• SkinsRestorer - нужно вручную назначать скины, таскать файлы. После перезахода игрока скин сбрасывается на дефолт.
• BedrockSkinUtility - показывает 4D-геометрию и аксессуары, но требует клиентский мод. То есть бесполезно для большинства игроков.
• GeyserSkinManager - когда-то работал на старых версиях, сейчас полностью сломан.
• GeyserExtras и опция Floodgate в конфиге Geyser - вообще не работают, хотя заявлено обратное.

Короче, Bedrock Skin Restorer - единственное рабочее решение "из коробки".

Совместимость

С DiscordSRV проблем нет - плагин работает, но обновлённый скин может не отображаться в чат-мостах. Это, скорее всего, не критично для игроков.

С SkinsRestorer могут быть конфликты: SkinsRestorer использует телепорт игрока в void для обновления скина, что может сломать процесс. Если такое случится - увеличь задержку применения скина в конфиге.

Настройки config.yml

Вот стандартный конфиг с пояснениями:

# ---------------------------------------------------------------------------------------------------------------------------

# Bedrock Skin Restorer

# ---------------------------------------------------------------------------------------------------------------------------

fetch-retries: 2
# ^ Сколько раз плагин пытается загрузить скин после первой неудачи.
#   Больше попыток - выше шанс успеха, но больше запросов к API.

fetch-on-join: true
# ^ Загружать скин при входе игрока.

fetch-on-join-delay-ticks: 15
# ^ Задержка перед загрузкой скина после входа. 20 тиков = 1 секунда.
#   Нужно, чтобы Geyser/Floodgate успели завершить инициализацию игрока.

fetch-on-character-refresh: false
# ^ Загружать/перезагружать скин при респавне, смене измерения или переходе между серверами.

fetch-on-character-refresh-delay-ticks: 15
# ^ Аналогичная задержка для обновлений.

compatibility-mode:
  skins-restorer: false
  bedrock-auto-auth: false
# ^ Включать только если есть проблемы. Экспериментальные патчи.
#   SkinsRestorer - пропускает автоматическую загрузку, если SkinsRestorer уже занят.
#   Bedrock Auto-Auth - проверяет, что сущность игрока всё ещё валидна для Bukkit.

# ---------------------------------------------------------------------------------------------------------------------------

manual-fetch: false
# ^ Разрешить ли Floodgate-игрокам вручную запрашивать скин.
#   Если false - команду может выполнять только OP.

manual-fetch-command: "/bedrockskin"
# ^ Команда для ручного запроса скина.

manual-fetch-command-java: "[Bedrock Skin Restorer] Вы не Floodgate-пользователь!"
# ^ Сообщение, если Java-игрок пытается выполнить команду.

manual-fetch-command-noperm: "[Bedrock Skin Restorer] У вас нет прав на эту команду!"
# ^ Сообщение при отсутствии прав.

manual-fetch-command-error: "[Bedrock Skin Restorer] Не удалось загрузить скин из API GeyserMC, попробуйте позже."
# ^ Общее сообщение об ошибке загрузки.

# ---------------------------------------------------------------------------------------------------------------------------

Что в итоге

Если на твоём сервере есть Bedrock-игроки и ты устал от того, что у них вместо скинов серые аватары - Bedrock Skin Restorer это то, что нужно. Скачай плагин, кинь в папку plugins, настрой под себя (или оставь как есть) - и скины начнут отображаться нормально. По факту, это самый простой и надёжный способ решить проблему скинов Bedrock на Java-сервере.