Configura el vestidor
Deja que los jugadores elijan una skin para cada pieza desde /wardrobe, elige entre objetos, vestidor o ambos y compruébalo en el juego.
El vestidor es un menú donde los jugadores eligen una skin para cada pieza de armadura, o para las cuatro a la vez, y la llevan. Al final tienes /wardrobe funcionando como quieres: solo objetos, solo vestidor o ambos.
Un objeto de skin escribe en la armadura. El vestidor guarda la elección contra el jugador, así que sobrevive a la muerte, a los intercambios y a un cambio de equipo, y la armadura no se toca.
Antes de empezar#
Tienes al menos una skin, mira Crea y edita skins. Los jugadores necesitan exyliaarmorskin.wardrobe, que todos tienen por defecto.
Configúralo#
Elige de dónde salen las skins
En config.yml, pon behaviour.mode en item, wardrobe o both (el valor por defecto). Mira los tres modos más abajo.
Recarga
Ejecuta /armorskinsadmin reload.
Da skins a un jugador
Los operadores tienen todas. Los demás tienen una skin por su permiso (exyliaarmorskin.skin.<id>), con /armorskinsadmin unlocks grant <jugador> <skin>, por la caja o por la tienda.
Ábrelo
Ejecuta /wardrobe.
Con menu.style: SPATIAL en config.yml, /wardrobe abre el vestidor en el mundo: el jugador se prueba las skins en su propio cuerpo y guarda o compra ahí mismo. /wardrobe 3d y /wardrobe classic abren uno u otro. Mira Configura el vestidor 3D.
Comprueba que funciona#
/wardrobe abre una ventana de 54 huecos. La armadura de arriba es el aspecto actual del jugador; la rejilla de abajo son todas las skins. Haz clic izquierdo en una pieza, clic en una skin y la skin se dibuja en ti. Haz clic otra vez en la skin puesta para quitarla. Desvestir todo lo vacía todo.
Los tres modos#
behaviour.mode decide de dónde sale la skin de una pieza:
| Modo | De dónde sale | Qué implica |
|---|---|---|
item | Solo de lo que un objeto de skin escribió en la armadura. | La skin se comercia, se cae y se pierde con la pieza. Sin vestidor y sin base de datos. |
wardrobe | Solo de lo que el jugador eligió en /wardrobe. | Sigue al jugador y cae sobre lo que se equipe. Los objetos de skin no hacen nada. |
both | La skin propia de la armadura y, para la que no lleva ninguna, el vestidor. | El valor por defecto. |
En both gana la armadura: una pieza con skin se dibuja con la suya, y el vestidor solo cubre las piezas peladas.
Qué hacen los botones#
| Botón | Qué hace |
|---|---|
| Desvestir todo (hueco 45) | Lo quita todo. |
| Filtro (hueco 52) | Muestra solo las skins que el jugador tiene. Se recuerda como la pestaña. |
| Cerrar (hueco 49) | Cierra el menú. |
| Caja (hueco 53) | Abre la caja; muestra las llaves y las skins coleccionadas. |
| Botones de página (huecos 48 y 50) | Pasan la rejilla de skins. |
| Clic | Sobre | Resultado |
|---|---|---|
| Izquierdo | Una fila de armadura | La enfoca: la rejilla pasa a vestir esa pieza. |
| Derecho | Una fila de armadura | Le quita la skin. |
| Izquierdo | La fila SET COMPLETO | Enfoca las cuatro piezas a la vez. |
| Derecho | La fila SET COMPLETO | Vacía el vestidor entero. |
| Cualquiera | Una skin | La pone en lo enfocado, o la quita si ya es la que lleva. |
| Cualquiera | Una skin a la venta | Pide confirmar, cobra el precio y la desbloquea. Mira Comprar con moneda. |
Con el set enfocado, la skin se aplica a todas las piezas en las que el jugador puede llevarla, así que un rango que tiene una sola pieza de una skin se lleva esa pieza en vez de un rechazo entero.
Ir más lejos#
Cambia el aspecto del menú editando lang/<idioma>/menus/wardrobe.yml (mira Menús). Si el estilo de menú del servidor es SCREEN, /wardrobe se abre como pantalla nativa (screens/wardrobe.html, con la caja y sus ruletas) con un cuerpo real en una ventana que prueba la skin bajo el cursor. Si la pantalla no carga, se usa el menú de cofre.
Vaciar un vestidor no devuelve ningún objeto, porque nunca se consumió ninguno. Los objetos de skin y los removedores pertenecen a item y both.
Referencia técnica#
Para quien edita el archivo del menú.
Huecos y listas del menú
| Sección | Huecos | Qué contiene |
|---|---|---|
targets | 2,3,4,5,6 | Lo que se está vistiendo: el set completo y luego casco, peto, pantalones y botas. |
skins | 10-16,19-25,28-34,37-43 | Todas las skins, paginadas con los botones de los huecos 48 y 50. |
Desvestir todo está en el hueco 45 y lo quita todo; Filtro en el 52 muestra solo las skins que el jugador tiene (se recuerda como la pestaña); Cerrar en el 49; Caja en el 53 abre
la caja y muestra las llaves que tiene el jugador y cuántas skins ha
coleccionado.
Cada fila de armadura se dibuja con la pieza de cuero de su propia ranura, teñida con la skin que lleva ahí, así que la parte de arriba de la pantalla es el aspecto actual del jugador. Una fila de la rejilla se dibuja en la pieza que se está vistiendo, para que la skin se vea donde va a acabar; una skin que no encaja en la pieza enfocada se dibuja en una que sí.
Plantillas del menú del vestidor
| Sección | Plantilla | Cuándo se usa |
|---|---|---|
targets | item_template | Una ranura de armadura sin enfocar. |
focused_template | La ranura que se está vistiendo. | |
set_template | La fila del set completo, sin enfocar. | |
focused_set_template | La fila del set completo mientras está enfocada. | |
skins | item_template | Una skin que el jugador puede usar y que encaja. |
selected_template | La skin puesta en la pieza enfocada — o en todas las que la skin encaja, con el set enfocado. | |
unsupported_template | Una skin cuyas pieces no incluyen la ranura enfocada. | |
no_permissions_template | Una skin que el jugador no tiene. | |
purchasable_template | Una skin que el jugador no tiene y que la tienda vende, mientras shop.enabled está encendido. |
item_template es el estado normal y debe ir primera en cada lista. Las filas bloqueadas y las que no
encajan no llevan acción propia: hacer clic en ellas no hace nada. Un jugador tiene una skin por su
nodo o por un desbloqueo, de la caja o de la tienda.
Placeholders del vestidor
Son los tokens propios del vestidor, que se rellenan mientras se dibuja la pantalla. No son placeholders de PlaceholderAPI y solo funcionan dentro de este archivo.
La lista targets tiene dos tipos de fila — primero la del set completo y después una por pieza — y
cada tipo lleva sus propios tokens.
| Placeholder | Dónde | Qué dibuja |
|---|---|---|
%target% | targets | Qué viste la fila: la clave de una pieza, o set en la del set completo. |
%target_name% | targets | Su nombre según wardrobe: full-set, o el nombre de la pieza. |
%dressed% | targets, fila del set | Cuántas de las cuatro piezas llevan skin. |
%pieces% | targets, fila del set | Cuántas piezas hay en total — cuatro. |
%piece% | targets, filas de pieza | La clave de la pieza: helmet, chestplate, leggings o boots. |
%piece_material% | targets, filas de pieza | El material de cuero de esa ranura, para dibujar la fila. |
%skin_name% | targets, filas de pieza | La skin puesta en esa pieza, o wardrobe.empty. |
%skin_color% | targets, filas de pieza | El color hex de esa skin, o cuero sin teñir si no tiene. |
%skin_trim_pattern% | targets, filas de pieza | El patrón de trim de esa skin, vacío si no tiene trim. |
%skin_trim_material% | targets, filas de pieza | El metal de trim de esa skin, vacío si no tiene trim. |
%skin_id% | skins | El id de la skin. |
%skin_name% | skins | Su nombre visible. |
%skin_icon% | skins | Su icon, o el material del objeto de skin por defecto. |
%skin_preview% | skins | La pieza en la que se previsualiza — la que se está vistiendo cuando la skin encaja en ella. |
%skin_color% | skins | Su color hex, o cuero sin teñir si no tiene. |
%skin_trim_pattern% | skins | Su patrón de trim, vacío si no tiene trim. |
%skin_trim_material% | skins | Su metal de trim, vacío si no tiene trim. |
%skin_pieces% | skins | Las piezas en las que encaja. |
%skin_worn% | skins | Las piezas en las que el jugador la lleva puesta, vacío si ninguna. |
%skin_worn_name% | skins | Lo mismo, pero wardrobe.empty si ninguna. |
%price% | skins, purchasable_template | El precio, escrito como lo escribe su moneda. |
%keys% | en cualquier parte | Las llaves de caja que tiene el jugador. |
%unlocked_count% | en cualquier parte | Cuántas skins tiene, por desbloqueo o por permiso. |
%catalogue_count% | en cualquier parte | Cuántas skins declara el servidor. |
Acciones del menú
| Acción | Qué hace |
|---|---|
armorskin:wardrobe | Abre el vestidor que diga menu.style, tras comprobar exyliaarmorskin.wardrobe. |
armorskin:focus <objetivo> | Viste una pieza, o set para las cuatro. |
armorskin:wear <skin> | Pone una skin en el foco, o la quita si ya está puesta. |
armorskin:clear <objetivo> | Limpia una pieza, o set para el vestidor entero. |
armorskin:buy <skin> | Compra con moneda una skin bloqueada y vuelve a abrir el vestidor con el mismo foco. Necesita exyliaarmorskin.buy. |
armorskin:crate | Abre la caja. |
armorskin:equip <skin> | Pone una skin en cada pieza en la que el jugador puede llevarla, desde fuera del vestidor: lo que hace el ganador de un rodillo de la caja al pulsarlo. |
Textos en messages.yml
Las pocas cadenas que una plantilla dibuja para todas las filas viven bajo wardrobe en messages.yml:
wardrobe:
full-set: "{primary}&lFULL SET"
helmet: "{primary}&lHELMET"
chestplate: "{primary}&lCHESTPLATE"
leggings: "{primary}&lLEGGINGS"
boots: "{primary}&lBOOTS"
piece-names:
helmet: "Helmet"
chestplate: "Chestplate"
leggings: "Leggings"
boots: "Boots"
empty: "{muted}Nothing"piece-names es cómo se escribe una pieza dentro de una frase o una lista, como %skin_pieces%.
Dónde se guarda el vestidor
Una fila por jugador en armorskin_wardrobe: el uuid y una columna por pieza con un id de skin. Las
lecturas nunca bloquean — un vestidor que todavía viene de la base de datos responde "aún no hay
skin", y el jugador se redibuja en cuanto llega.
La tabla está clasificada para ExyliaLib, así que /exylialib resetplayer <jugador> ExyliaArmorSkin y
/exylialib wipe la vacían junto con las llaves y desbloqueos de la caja. Ver
Comandos de ExyliaLib.
Vaciar un vestidor no entrega ningún objeto, porque nunca se consumió ninguno: una elección de
vestidor es una fila, no un objeto. Los objetos de skin y los removedores son de item y both.
¿Falta algo en esta página? Dínoslo en Discord