Plugin de skins para Paper 1.21.x y 26.x con soporte para servidores Yggdrasil (authlib-injector), skins personalizadas por URL mediante MineSkin y persistencia en SQLite, MySQL/MariaDB o PostgreSQL.
Requiere JDK 21. En NixOS:
nix shell nixpkgs#jdk21
./gradlew buildEl artefacto queda en build/libs/YggSkins-1.0.0.jar y funciona tanto en Paper 1.21.x (Java 21)
como en Paper 26.x (Java 25), porque solo usa APIs presentes en ambas versiones.
- Copia el JAR en
plugins/. - Arranca el servidor: se generan
config.yml,messages_es.yml,messages_en.ymlyhardcoded_skins.json. - Si usas authlib-injector, no hace falta configurar nada: el API Root se detecta desde el
argumento
-javaagent:authlib-injector.jar=<url>. Si el agente solo está cargado en el proxy, defineyggdrasil.api-roota mano.
| Comando | Permiso |
|---|---|
/skin help |
yggskins.command |
/skin set <nombre> [classic|slim] |
yggskins.command.set |
/skin <nombre> |
yggskins.command.set |
/skin clear /skin reset |
yggskins.command.clear |
/skin update /skin refresh |
yggskins.command.update |
/skin url <url> [classic|slim] |
yggskins.command.url |
/skin info |
yggskins.command |
/yggskins reload |
yggskins.admin.reload |
/yggskins status |
yggskins.admin.status |
/yggskins info <jugador> |
yggskins.admin.info |
/yggskins applyskin <jugador> |
yggskins.admin.applyskin |
/yggskins drop <jugador> |
yggskins.admin.drop |
/yggskins createcustom <nombre> <url|player:nombre> [variant] |
yggskins.admin.createcustom |
/yggskins setcustomname <nombre> <texto> |
yggskins.admin.createcustom |
/yggskins purgeolddata <dias> |
yggskins.admin.purge |
/skin se registra por código para poder desactivarlo con commands.register-skin-command: false
si convive con otro plugin de skins. El alias /skins se controla con commands.register-skins-alias.
Con PlaceholderAPI instalado: %yggskins_skin%, %yggskins_source%, %yggskins_variant%,
%yggskins_texture%, %yggskins_signed% y %yggskins_has_skin%.
- Al entrar, se guarda la propiedad
texturesoriginal del jugador (la que entrega authlib-injector). - Si hay una skin guardada, se aplica un tick después del join con
Player#setPlayerProfile. /skin clearborra la selección y restaura la propiedad original; si no existe, la consulta al sessionserver por UUID y, si tampoco hay, elimina la propiedad.- Las skins se deduplican por
(source, source_key, variant)y se cachean en memoria con TTL. - Las URLs pasan por un validador que bloquea esquemas no HTTP, IPs privadas, loopback y enlaces locales.
Las skins que entrega un servidor de autenticacion de terceros (LittleSkin, Ely.by, etc.) van firmadas con la clave de ese servidor, no con la de Mojang. Un cliente vanilla solo acepta firmas de Mojang, asi que la skin se aplica y se guarda, pero no se renderiza.
Dos formas de resolverlo:
- Lanzar el cliente con authlib-injector apuntando al mismo servidor de autenticacion (lo normal en servidores que ya usan authlib-injector).
- Activar la re-firma automatica con MineSkin:
providers:
mineskin:
resign-yggdrasil: trueCon esa opcion el plugin descarga la textura original y la sube a MineSkin, que devuelve la misma skin firmada por Mojang, de modo que tambien se ve en clientes vanilla. Descargar la imagen desde el propio servidor evita el fallo de MineSkin cuando el servidor de autenticacion bloquea peticiones de terceros. Consume una generacion de MineSkin por textura y variante (con cache en memoria), asi que la textura debe ser accesible publicamente desde el servidor.
- Solo Paper: no hay Spigot, proxy ni mods en esta versión.
- Las skins de MineSkin dependen de un servicio externo (límites de tasa y disponibilidad).
- Si MineSkin devuelve una propiedad sin firma y
allow-unsigned-fallbackesfalse, la skin se rechaza. org.sqliteno se reubica en el JAR porque su librería nativa se enlaza por nombre de clase.
./gradlew testIncluye pruebas del cliente Yggdrasil contra un servidor HTTP local, verificación de firmas RSA, parseo de texturas, validación de URLs, MineSkin (bloqueo de SSRF) y almacenamiento SQLite.