🧍 Skin Restorer

Skin Restorer stahuje a aplikuje reálné Minecraft skiny pro hráče na offline-mode serverech. Skiny se injektují při připojení (bez nutnosti relogu) a cachují se lokálně pro snížení volání Mojang API.

Pro zapnutí: nastavte enableSkinRestorer: true v general.json. Automaticky vypnutý v online-mode.

Rychlá navigace

⚙️Jak to funguje

Stažení, injekce, cache

📝Konfigurace

TTL cache, manuální refresh

⌨️Příkazy

Manuální refresh skinu

⚙️ Jak to funguje

Hráč se připojí — Voidium zkontroluje, zda má hráč cachovaný skin
Cache hit — Pokud je skin cachovaný a nevypršel, aplikuje se okamžitě
Cache miss — Voidium se dotáže Mojang API:
- Nejprve: přeloží jméno hráče → oficiální UUID přes api.mojang.com
- Pak: stáhne skin texture data (value + signature) přes sessionserver.mojang.com
Injekce — Skin se aplikuje na game profil hráče při loginu (early join injekce — bez nutnosti relogu)
Uložení cache — Skin data se uloží do skin-cache.json s časovým razítkem

Chytré funkce

Auto-vypnutí v online mode — Když server běží v online mode, reálné skiny jsou již dostupné
Webhook integrace — Když chat bridge používá webhooky, správný skin avatar se rozpozná i pro offline-mode hráče

📝 Konfigurace

Skin Restorer se konfiguruje přes general.json:

Pole	Typ	Výchozí	Popis
`enableSkinRestorer`	boolean	`true`	Hlavní přepínač
`skinCacheHours`	int	`24`	Jak dlouho uchovávat cachované skiny před opětovným stažením (hodiny, min 1)

Cache soubor

Skiny se cachují v config/voidium/storage/skin-cache.json. Každý záznam obsahuje:

Jméno hráče → skin texture value + signature + timestamp
Záznamy starší než skinCacheHours se znovu stáhnou při dalším připojení

Tip: Nastavte skinCacheHours výš (např. 48) pro snížení volání Mojang API, nebo níž (např. 6) pokud hráči často mění skiny.

⌨️ Příkazy

Příkaz	Oprávnění	Popis
`/voidium skin <player>`	OP	Vynutí refresh skinu online hráče

Příkaz ihned znovu stáhne skin z Mojang API a aktualizuje jak cache, tak vzhled hráče ve hře.