Посібник з кастомних скінів (Ely.by / LittleSkin)

Цей посібник пояснює, чому кастомні скіни (від таких сервісів, як Ely.by або LittleSkin) можуть не відображатися за замовчуванням в XMCL порівняно з іншими лаунчерами, як працює система скінів у Minecraft Java, та як правильно її налаштувати.

---

Як працює відображення скінів у Minecraft Java

Зазвичай Minecraft Java отримує ваш скін з офіційного сервера сесій Mojang. Процес виглядає наступним чином:

---

Чому скіни не відображаються в XMCL за замовчуванням

В інших лаунчерах, таких як Legacy Launcher або ElyPrism:

• Legacy Launcher автоматично змінює внутрішній файл гри authlib.jar або запускає фоновий Java-агент. Він запитує скіни з Ely.by для будь-яких локальних (офлайн) акаунтів просто за ніком, обходячи перевірки безпеки.
• ElyPrism — це форк Prism Launcher, який заздалегідь налаштований спеціально для екосистеми Ely.by.

XMCL — це чистий лаунчер з відкритим вихідним кодом. Він ніколи не змінює файли вашої гри та не перенаправляє трафік на сторонні сервери скінів без вашого дозволу.

---

Як налаштувати кастомні скіни в XMCL

Ви можете налаштувати кастомні скіни одним із двох способів нижче.

Спосіб 1: Додавання стороннього акаунта (Рекомендовано)

Замість використання простого локального (офлайн) нікнейму, додайте свій офіційний акаунт Ely.by або LittleSkin у лаунчер. Це автоматично активує Authlib-Injector:

1. Натисніть на іконку Акаунти на бічній панелі лаунчера.
2. Натисніть Додати акаунт.
3. Оберіть Ely.by або Yggdrasil (для LittleSkin введіть адресу їхнього Yggdrasil API: https://littleskin.cn/api/yggdrasil).
4. Увійдіть за допомогою своїх облікових даних.
5. У налаштуваннях вашої збірки переконайтеся, що опція «Вимкнути Authlib Injector» вимкнена.

Як це працює зсередини

При запуску гри XMCL автоматично додає Java-агент authlib-injector з посиланням на кастомне API:

java -javaagent:authlib-injector.jar=https://authserver.ely.by/api/ -jar ...

---

Спосіб 2: Використання моду CustomSkinLoader

Якщо ви бажаєте грати під локальним (офлайн) нікнеймом, але хочете, щоб ваша гра завантажувала скіни з Ely.by або LittleSkin, вам потрібно встановити мод CustomSkinLoader.

1. Встановіть завантажувач модів (Forge, Fabric або Quilt) у вашій збірці.
2. Знайдіть та завантажте мод CustomSkinLoader через вкладку завантаження модів в XMCL.
3. Запустіть гру один раз. Вона створить конфігураційний файл за шляхом minecraft/CustomSkinLoader/CustomSkinLoader.json.
4. Відкрийте цей файл та налаштуйте сервери скінів:

{
  "enable": true,
  "loadTypes": ["Mojang", "ElyBy", "LittleSkin"],
  "skinList": [
    { "type": "Mojang" },
    { "type": "Yggdrasil", "apiRoot": "https://authserver.ely.by/api/" },
    { "type": "Yggdrasil", "apiRoot": "https://littleskin.cn/api/yggdrasil/" }
  ]
}

5. CustomSkinLoader буде запитувати ці мережі скінів за вашим нікнеймом та відображатиме скіни для вас та всіх інших гравців, які налаштували цей мод!