Как настроить скины на сервере / Плагин SkinRestorer

На сервере без лицензии скины из аккаунта Mojang не загружаются. Плагин SkinsRestorer подгружает официальные скины и даёт игроку сменить скин прямо в игре.

Особенности

• смена скина командой /skin по нику или URL;
• кэширование скинов;
• поддержка BungeeCord / Velocity − скины на всех серверах из одного места;
• Paper, Spigot, Purpur, Bukkit;
• меняется только внешний вид.

Установка

1. Скачайте SkinRestorer с SpigotMC или с Modrinth.
2. Остановите сервер, откройте вкладку Files → папка plugins.
3. Загрузите .jar и запустите сервер. После первого старта появится папка plugins/SkinsRestorer.

Подробнее об установке плагинов − в статье Как установить плагины на сервер?

Сообщение про лаунчер при входе

После установки при заходе может появиться предупреждение для пользователей TLauncher: лаунчер сам подменяет скин. В настройках TLauncher поставьте Use skins OFF.

Подробнее об этом говорили и сами разработчики: Client and launcher skin overrides.

Команды для игроков

В игре − с /, в консоли − без. Список команд − /skin help:

• /skin set <skin> − сменить свой скин (ник игрока со скином).
• /skin set <target> <skin/url> − поставить скин другому игроку.
• /skin clear − сбросить свой скин.
• /skin clear <target> − сбросить скин другому игроку.
• /skin update − обновить свой скин.
• /skin update <target> − обновить скин другому игроку.
• /skin url <skinurl> − поставить скин по ссылке на PNG.
• /skin search <search> − найти скин по запросу.
• /skins − GUI с историей ранее использованных скинов.

Скин по ссылке: /skin url

/skin url <SkinUrl>

Пример, откуда взять скин: MineSkin. Скопируйте ссылку на изображение и вставьте в команду вместо <SkinUrl>.

Команды администратора

Список команд − /sr help:

• /sr drop <player|skin> <target> − удалить данные игрока или скина.
• /sr setskinall <Skin / Url> − поставить один скин всем игрокам.
• /sr purgeolddata <targetdaysold> − очистить старые данные скинов старше N дней.
• /sr createcustom <skinName> <skinUrl> − создать кастомный скин на весь сервер.
• /sr props <target> − показать свойства текущего скина игрока.
• /sr reload − перезагрузить конфиг.
• /sr applyskin <target> − заново применить скин игроку.
• /sr status − проверить API-сервисы плагина.

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

Файл − /home/container/plugins/SkinsRestorer/config.yml.

• Скины без привилегий − forceDefaultPermissions: true. Игроки могут менять скины без выдачи прав вручную.
• Кулдаун − skinChangeCooldown. Как часто можно менять скин (в секундах).
• Дефолтный скин − defaultSkins. При enabled: true заходящим ставится скин из списка list. Несколько скинов − выбирается случайный. applyForPremium: true − то же для лицензионных аккаунтов.
• Запрет скинов − disabledSkins. Названия скинов, недоступные обычным игрокам. Обход − право skinsrestorer.bypassdisabled.
• GUI-меню − раздел gui. Содержимое /skins: кастомные скины, скины игроков, рекомендации.
• База данных − раздел database. По умолчанию FILE. MySQL/PostgreSQL − если скины общие на нескольких серверах.
• Сайты для /skin url − restrictSkinUrls. Разрешить ссылки только с указанных доменов.
• Скин при перезаходе − disableOnJoinSkins. false − игрок заходит с прошлым скином; true − при входе скин плагином не ставится.

После правок сохраните файл и выполните /sr reload (или рестарт).

BungeeCord / Waterfall / Velocity

Плагин ставят и на прокси (BungeeCord / Velocity / Waterfall), и на все серверы, где нужны скины.

• На прокси − загрузка скинов с Mojang, кэш, база данных и полный config.yml.
• На бэкендах (Paper / Spigot / Purpur) − применение скина в мире и часть локальных команд.

Полная настройка − только на прокси. На бэкендах конфиг не трогают: там обычно появляется пометка proxy-mode.

Краткий чеклист

1. Скачать SkinsRestorer со SpigotMC / Modrinth в plugins и перезапустить сервер.
2. Проверить /skin help и при необходимости кулдаун / дефолтные скины в config.yml.
3. Игрокам на TLauncher − поставить Use skins OFF.
4. На связке с прокси − плагин на прокси и на всех бэкендах.