Instalación
Dependencias, los archivos que escribe al primer arranque, la tabla del vestidor y qué cubre una actualización.
Instala los jars, arranca el servidor una vez y ExyliaArmorSkin escribe sus archivos y queda listo para dar skins. Son unos dos minutos.
Antes de empezar#
| Requisito | Notas |
|---|---|
| Paper 1.21.1 o superior | api-version: '1.21'. Compilado contra la API de Paper 1.21.4, y funciona desde 1.21.1 gracias a la capa de versiones de ExyliaLib. Folia necesita 1.21.4 o superior. |
| Java 21 | El jar está compilado para 21. |
| Paper, o Folia | Usa el evento de cambio de armadura de Paper y sendEquipmentChange. Folia está soportado (folia-supported: true). |
| ExyliaLib | Configuración, texto, objetos, efectos y tareas. |
| packetevents | Obligatorio. Los paquetes de equipamiento, de ranura y de inventario se reescriben con él. |
| PlaceholderAPI | Opcional. Para los %placeholders% del nombre y el lore de los objetos, y para los placeholders de caja del plugin. |
| ExyliaEconomy o Vault | Opcional. La moneda que cobra la tienda del vestidor. Sin ninguno, no hay nada a la venta. |
Pasos#
Mete los jars
ExyliaArmorSkin.jar, además de ExyliaLib y packetevents, en plugins/. PlaceholderAPI es
opcional: resuelve los %placeholders% que escribas en el nombre y el lore de los objetos, y
sirve los placeholders propios del plugin. ExyliaEconomy o
Vault también son opcionales: solo los necesita la
tienda.
Arranca el servidor
Escribe config.yml, skins.yml, animations.yml y la carpeta lang/ en
plugins/ExyliaArmorSkin/, y abre database.yml para la caja. Con el vestidor encendido crea
además la tabla del vestidor.
Date una skin
/armorskinsadmin give <tú> galaxy y arrastra el objeto sobre un peto en tu inventario.
Edita los archivos
Añade o cambia skins en skins.yml y animaciones en animations.yml, y luego /armorskinsadmin reload.
Está declarado como depend, así que el servidor se niega a activar el plugin sin él. Todo el plugin
es una reescritura de paquetes: sin él no hay nada que hacer. ExyliaLib está como softdepend por
orden de carga, pero el plugin está construido sobre ella y tampoco funciona sin ella.
Comprueba que funciona#
La consola muestra ExyliaArmorSkin activado sin errores, y plugins/ExyliaArmorSkin/ contiene config.yml, skins.yml y animations.yml. /armorskinsadmin list lista las skins. Después haz Tu primera skin.
Ir más lejos#
Actualizar#
Sustituye el jar y reinicia. /armorskinsadmin reload vuelve a leer esos archivos, reconstruye cada skin y redibuja a todos los conectados, así que un cambio de color se ve sin que nadie vuelva a equiparse.
Cambiar el idioma#
language en config.yml elige los archivos de lang/. default sigue el idioma de ExyliaLib; vienen inglés, español, portugués, francés, ruso y turco (en, es, pt, fr, ru, tr), y cualquier otro código parte de los archivos en inglés.
Archivos que escribe
| Archivo | Contenido |
|---|---|
config.yml | El idioma, cómo se dibujan los objetos, los interruptores de comportamiento, los efectos, los showcases, la caja y la tienda. |
skins.yml | Las skins, indexadas por id, con su rareza y su precio. |
animations.yml | Animaciones con nombre a las que una skin puede referirse. |
lang/<idioma>/messages.yml | Cada línea que envía el plugin, los nombres y lore de los objetos, el lore de la armadura y los textos del vestidor. |
lang/<idioma>/menus/wardrobe.yml | La pantalla del vestidor: la fila de armadura, la rejilla de skins, sus plantillas y botones. Solo se carga con el vestidor encendido. |
lang/<idioma>/menus/crate.yml · crate_open.yml | Las dos pantallas de la caja: cuántas abrir, y los rodillos. |
spatial/wardrobe.yml | Dónde está cada pieza del vestidor 3D. |
spatial/crate.yml · spatial/spots.yml | El aspecto de la apertura 3D de la caja, escrito por ExyliaLib; los vestidores 3D colocados. |
database.yml | Dónde se guardan las llaves de caja, los desbloqueos y los vestidores. H2 por defecto. |
<idioma> es language en config.yml: default sigue el idioma propio de ExyliaLib. Vienen
inglés, español, portugués, francés, ruso y turco (en, es, pt, fr, ru, tr); cualquier otro código
empieza desde los archivos en inglés.
1.0 guardaba su pantalla en menus/wardrobe.yml y todos los mensajes en config.yml. En el primer
arranque de 1.2 el menú viejo pasa a lang/custom/menus/ y language se pone en custom, así que el
servidor conserva la pantalla que había editado. Los nombres y lore de los objetos, las líneas de lore
de la armadura y los textos del vestidor pasan de config.yml a lang/custom/messages.yml con tus
valores. El bloque messages: viejo no se traslada: esas líneas vuelven a los valores por defecto, así
que copia las que hubieras cambiado. Pon language en default o en un código para pasar a las
traducciones incluidas.
Dónde se guardan los datos
armorskin_wardrobe, una fila por jugador: el uuid y una columna por pieza — helmet,
chestplate, leggings, boots — con un id de skin o nada.
Solo se lee y se escribe con el vestidor encendido (behaviour.mode en wardrobe o both). En un
servidor item, lo único que se escribe fuera de los archivos es el id de la skin en la propia
armadura.
Un id de skin en una columna que skins.yml ya no declara simplemente no dibuja nada: la fila se
queda como está, y el aspecto vuelve si la skin vuelve.
La caja guarda una fila por jugador en exylia_crate_players, la tabla de cajas de ExyliaLib, en la
base de datos de este plugin: las llaves que tiene y las skins que desbloqueó. Se usa en cualquier modo.
Los objetos de skin, removedores y llaves que no cupieron en un inventario esperan en la cola de recompensas de la misma base de datos y se entregan en la siguiente entrada del jugador.
¿Falta algo en esta página? Dínoslo en Discord