SkinLibrary

🎭 SkinLibrary

Серверная библиотека скинов для Fabric — игроки выбирают скин из кликабельного списка в чате.

Кидаешь .png файлы в папку; игроки заходят с ванильным клиентом и пишут /skin. Им ничего не нужно ставить, не нужно хостить веб-сервис, не нужны API-ключи.

Что оно делает

FabricTailor делает саму подмену скина и загрузку на MineSkin; SkinLibrary добавляет поверх него готовую библиотеку и браузер в чате.

Возможности

• 🖱️ Кликабельный список в чате — постранично, с группировкой по автору, навигацией «◀ Назад / Далее ▶» и ярлыками 🎲 Случайный / ↺ Оригинал.
• ⌨️ Автодополнение по Tab для имён скинов — никому не придётся запоминать библиотеку.
• 📁 Библиотека — это просто папка — имя файла становится именем скина, потом /skin reload.
• 🌐 Скины вне библиотеки — `/skin player и/skin url `, оба переключаются в конфиге.
• 🧠 Кэш текстур — текстура, полученная один раз, больше не отправляется на MineSkin.
• 🗣️ Переводы — en_us и pl_pl из коробки, свой язык без пересборки.
• 📦 Один jar для 1.21+ — без миксинов, без сборок под каждую версию.
• 🔌 Опциональный HTTP-каталог (libraryUrl) — если у тебя уже есть свой сервис скинов.

Требования

Fabric-сервер на 1.21 или новее, Java 21 и в mods/: Fabric API и FabricTailor.

Только для сервера — игроки заходят с ванильным клиентом и им ничего ставить не нужно.

Быстрый старт

1. Положи fabric-api, fabrictailor и skinlibrary в папку mods/ своего сервера.
2. Запусти сервер один раз — он создаст config/skinlibrary/.
3. Кидай .png скины (64×64 или 64×32) в config/skinlibrary/skins/.
4. /skin reload, и они в деле.

Имя файла становится именем скина: pirate.png → /skin pirate.

Конфигурация

config/skinlibrary/config.json, создаётся при первом запуске:

{
  "language": "en_us",
  "allowPlayerSkins": true,
  "allowUrlSkins": true,
  "cooldownSeconds": 5,
  "requireOperator": false,
  "pageSize": 8,
  "slimByDefault": false,
  "libraryUrl": "",
  "commandAliases": ["skin", "skins"]
}

Здесь ничего не обязательно — дефолты работают. Заметные опции:

• commandAliases — переименовать команду, если /skin уже занят другим модом.
• slimByDefault — считать файловые скины моделью slim (Alex).
• libraryUrl — опциональный HTTP-каталог, если у тебя уже есть свой. Он должен отвечать {"skins": [{"name": "...", "value": "...", "signature": "...", "author": "..."}]}; записи могут использовать url вместо value.

Более богатые записи

Для всего, что выходит за рамки «PNG в папке», добавь config/skinlibrary/skins.json:

{
  "notch":  { "player": "Notch",                      "author": "mojang" },
  "banner": { "url": "https://example.com/skin.png",  "author": "alice"  },
  "alex":   { "file": "alex.png", "slim": true,       "author": "bob"    }
}

Записи в браузере группируются по `author`, так что на общем сервере видно, кто что добавил.

### Переводы

Встроены: `en_us`, `pl_pl`. Задаётся через `language` в конфиге.

Чтобы добавить свой, положи `config/skinlibrary/lang/<code>.json` с теми же ключами, что и
[`en_us.json`](https://github.com/PiotrKajor/skinlibrary/blob/master/src/main/resources/assets/skinlibrary/lang/en_us.json) — пересборка не нужна.

## Версии Minecraft

Один jar покрывает **1.21 и выше**. В моде нет миксинов, и он не трогает те части API, которые
меняются от релиза к релизу, так что пересобирать под каждый минорный релиз не нужно.

Единственное исключение — кликабельный чат: в Minecraft 1.21.5 заменили API событий клика и наведения.
На 1.21.5+ список кликабельный; на более старых версиях тот же список выводится без поддержки кликов,
а всё остальное работает без изменений.

## Исходники и лицензия

[github.com/PiotrKajor/skinlibrary](https://github.com/PiotrKajor/skinlibrary) — MIT.
В репозитории есть README на польском ([README.md](https://github.com/PiotrKajor/skinlibrary/blob/master/README.md)).