SkinsRestorer: как поставить скин на сервере

Установка на сервер и в сеть

1. Скачайте jar с Modrinth. Нужна Java 17 или новее.
2. Положите SkinsRestorer.jar в plugins и перезапустите сервер через /stop или /restart. /reload и PlugMan ломают плагин.
3. Проверьте /plugins: SkinsRestorer должен быть зелёным. Для проверки скина выполните /skin Notch.

В сети на BungeeCord, Waterfall или Velocity плагин ставится на прокси и на каждый бэкенд. Бэкенды сами включают Proxy Mode: команды и данные о скинах обслуживает прокси. Для BungeeCord на бэкендах нужны bungeecord: true в spigot.yml и online-mode=false в server.properties, для Velocity настроенный forwarding. Версии под Fabric и NeoForge поддерживают только последнюю версию Minecraft.

Как поставить скин: /skin set и /skin url

Скин любого лицензионного ника:

/skin Notch
/skin set Notch
/skin set Notch Steve123

Последняя строка ставит скин другому игроку, для этого нужно право skinsrestorer.command.set.other. Скин по прямой ссылке на PNG, ссылка в кавычках:

/skin url "https://example.com/myskin.png"
/skin url "https://example.com/myskin.png" slim

slim это тонкие руки как у Alex, classic обычные. Без варианта плагин определяет его по файлу. Вернуть исходный скин: /skin clear, откатить последнюю смену: /skin undo. Между сменами скина по умолчанию 30 секунд.

Свой скин из файла: skinsrestorer.net/upload

1. Откройте skinsrestorer.net/upload.
2. Перетащите PNG со скином или нажмите Choose file.
3. Нажмите Generate /skin url и скопируйте команду.
4. Вставьте её в чат игры или в консоль. Кавычки вокруг ссылки не убирайте.

Требования к файлу: PNG размером 64x64 или 64x32, меньше 3 МБ, переименованный JPG не подойдёт. Скин обрабатывает сервис MineSkin, свой хостинг картинок не нужен. Команда /skin upload в игре показывает ту же инструкцию. Если пишет, что превышен лимит, подождите несколько минут или добавьте ключ MineSkin API в config.yml.

Права игроков и админов

Опция forceDefaultPermissions: true включена по умолчанию и выдаёт всем игрокам skinsrestorer.player, то есть все команды /skin. Без неё выдайте права через LuckPerms:

/lp group default permission set skinsrestorer.player true
/lp group staff permission set skinsrestorer.admin true

Право работает, только если у игрока есть и родительские: для skinsrestorer.command.set.other нужны ещё skinsrestorer.command.set и skinsrestorer.command. skinsrestorer.bypasscooldown снимает кулдаун, например для VIP.

Скины по умолчанию и запреты

Игрокам без своего скина можно выдавать скин из списка, <random> берёт случайный рекомендованный:

storage:
  defaultSkins:
    enabled: true
    applyForPremium: false
    list:
      - "xknat"
      - "<random>"

Список commands.disabledSkins запрещает отдельные ники скинов, обойти его можно правом skinsrestorer.bypassdisabled. commands.restrictSkinUrls при enabled: true пускает ссылки только с разрешённых доменов: по умолчанию i.imgur.com, storage.googleapis.com, cdn.discordapp.com и textures.minecraft.net.

Почему скин не виден

• Лаунчер подменяет скины. В TLauncher снимите галку Use skins TLauncher в настройках аккаунта, в SKlauncher включите Compatibility Mode. Документация SkinsRestorer предупреждает, что TLauncher может содержать вредоносный код.
• В сети в логе бэкенда нет строки Proxy Mode: плагин не стоит на прокси или на бэкенде либо не настроен forwarding.
• /sr status на прокси или сервере показывает, доступны ли сервисы Mojang и MineSkin.
• /skin не работает из консоли бэкенда в Proxy Mode: так задумано, админские команды выполняются из консоли прокси.
• Для поддержки /sr dump загружает диагностику и выдаёт ссылку.