Contenido generado con IA — puede contener errores.

ExyliaArmorSkin/EmpezarActualizada en v1.4.1

Instalación

Dependencias, los archivos que escribe al primer arranque, la tabla del vestidor y qué cubre una actualización.

Página 2 de 215 min de lectura

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#

RequisitoNotas
Paper 1.21.1 o superiorapi-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 21El jar está compilado para 21.
Paper, o FoliaUsa el evento de cambio de armadura de Paper y sendEquipmentChange. Folia está soportado (folia-supported: true).
ExyliaLibConfiguración, texto, objetos, efectos y tareas.
packeteventsObligatorio. Los paquetes de equipamiento, de ranura y de inventario se reescriben con él.
PlaceholderAPIOpcional. Para los %placeholders% del nombre y el lore de los objetos, y para los placeholders de caja del plugin.
ExyliaEconomy o VaultOpcional. 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.

packetevents es dependencia obligatoria

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
ArchivoContenido
config.ymlEl idioma, cómo se dibujan los objetos, los interruptores de comportamiento, los efectos, los showcases, la caja y la tienda.
skins.ymlLas skins, indexadas por id, con su rareza y su precio.
animations.ymlAnimaciones con nombre a las que una skin puede referirse.
lang/<idioma>/messages.ymlCada 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.ymlLa 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.ymlLas dos pantallas de la caja: cuántas abrir, y los rodillos.
spatial/wardrobe.ymlDónde está cada pieza del vestidor 3D.
spatial/crate.yml · spatial/spots.ymlEl aspecto de la apertura 3D de la caja, escrito por ExyliaLib; los vestidores 3D colocados.
database.ymlDó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.

Si vienes de 1.0

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