Configuración
config.yml al completo: el idioma, cómo se dibujan los objetos, los interruptores de comportamiento, los efectos, los showcases, la caja, la tienda y el estilo del vestidor; y después cada línea de messages.yml.
config.yml contiene todos los ajustes salvo las skins. Lo que lee un jugador (nombres y lore de objetos, el lore de la armadura, los textos del vestidor y cada mensaje) vive en lang/<idioma>/messages.yml. Casi siempre cambiarás tres cosas:
- Idioma:
language(por defectodefault, que sigue el idioma de ExyliaLib). Mira Instalación. - De dónde salen las skins:
behaviour.modeesitem,wardrobeoboth(por defecto). Mira Configura el vestidor. - Dónde no hay skins:
behaviour.disabled-worldses una lista de nombres de mundo.
Tras editar, ejecuta /armorskinsadmin reload. Las secciones de abajo listan todas las claves.
El config.yml por defecto
language: default
skin-item:
material: ARMS_UP_POTTERY_SHERD
glow: true
remover-item:
material: SCRAPE_POTTERY_SHERD
glow: true
armor-lore:
enabled: true
behaviour:
mode: both
consume-remover: true
consume-skin-item: true
hide-without-permission: true
disabled-worlds: []
defaults:
helmet: []
chestplate: []
leggings: []
boots: []
effects:
on-apply:
sound:
name: ITEM_ARMOR_EQUIP_LEATHER
volume: 0.7
pitch: 1.2
category: PLAYERS
on-remove:
sound:
name: ITEM_BUNDLE_REMOVE_ONE
volume: 0.7
pitch: 1.0
category: PLAYERS
showcase:
locations: []
pause-seconds: 3.0
radius: 24.0
only: []
crate:
enabled: true
# ... ver La caja
shop:
enabled: true
tier-prices:
common: 500
rare: 1500
epic: 4000
legendary: 10000
menu:
style: CLASSICClaves de language#
Claves de language
De qué carpeta de lang/ se leen los menús y mensajes de este plugin.
| Valor | Qué significa |
|---|---|
default | Sigue el idioma puesto en el config.yml de ExyliaLib. Es lo que escribe una instalación nueva. |
en, es, pt, fr, ru, tr | Este plugin solo, en ese idioma. Los seis vienen incluidos. |
custom | Los archivos que tenía el servidor antes de que existieran los idiomas; ver Instalación. |
Cualquier otro código empieza desde los archivos en inglés y queda en tus manos. Una línea que una
traducción no tenga llega en inglés. /armorskinsadmin reload aplica un idioma cambiado sin
reiniciar.
Claves de skin-item y remover-item#
Claves de skin-item y remover-item
Cómo se dibujan los dos objetos del sistema. Su nombre y lore están en messages.yml.
| Clave | Qué hace |
|---|---|
material | El material del objeto. En el objeto de skin solo se usa cuando la skin no define icon. |
glow | Si el objeto tiene el brillo de encantamiento. Los atributos siempre se ocultan. |
Claves de armor-lore#
Claves de armor-lore
| Clave | Por defecto | Qué hace |
|---|---|---|
enabled | true | Apágalo y la armadura con skin solo muestra su propio lore. |
Las líneas son armor-lore en messages.yml; %skin% es el nombre de la skin. Se muestran después
del lore propio de la armadura, separadas por una línea en blanco.
Se escriben sobre la copia que sale del servidor, en cada paquete que lleva la pieza: puesta, en la
hotbar, en un cofre o en el cursor. Cualquier plugin que lea el lore de la armadura encuentra
exactamente lo que tenía, y /data get no muestra nada extra.
Claves de behaviour#
Claves de behaviour
| Clave | Por defecto | Qué hace |
|---|---|---|
mode | both | item, wardrobe o both. Ver Configura el vestidor. |
consume-skin-item | true | Si el objeto de skin se gasta al aplicarlo. Apagado, un objeto pone la skin en cualquier número de piezas. |
consume-remover | true | Si el removedor se gasta al quitar una skin. |
hide-without-permission | true | Si la armadura cuya skin el portador ya no puede usar (sin nodo y sin desbloqueo) se dibuja como la pieza real. Se comprueba al equipar la pieza y con /armorskinsadmin refresh. |
disabled-worlds | [] | Mundos donde no se muestran skins: la armadura se dibuja como la pieza real. Los nombres se comparan sin distinguir mayúsculas. |
Ningún interruptor de gasto actúa cuando la operación falla: un removedor usado por un jugador con el
inventario lleno se queda en el cursor. Ver Permisos para lo que
significa hide-without-permission en la práctica.
Claves de defaults#
Claves de defaults
defaults:
helmet:
- {permission: group.vip, cosmetic: galaxy}
- {permission: '', cosmetic: ocean}La skin que lleva un jugador en una pieza para la que nunca eligió, según su rango. Cada una de
helmet, chestplate, leggings y boots es una lista que se lee de arriba abajo: gana la primera
línea para la que el jugador cumple, un permission vacío significa todos (déjala la última) y la skin
none no da nada a ese grupo. Una skin por defecto no necesita permiso ni desbloqueo y nunca se guarda
como del jugador. En el vestidor se dibuja como puesta, con el default-marker del vestidor; quien se
quita una skin la mantiene quitada, también la de por defecto. Solo se usa en los modos wardrobe y
both. Una skin no puede llamarse none.
Claves de effects#
Claves de effects
Dos momentos que pertenecen al sistema y no a una skin. Los dos son efectos completos de ExyliaLib — título, action bar, boss bar, sonido, partícula y firework — y los dos se reproducen para el jugador que lo hizo.
| Clave | Por defecto | Cuándo |
|---|---|---|
on-apply | ITEM_ARMOR_EQUIP_LEATHER, volumen 0.7, tono 1.2, categoría PLAYERS | Se arrastró una skin sobre la armadura con éxito, o se guardó el vestidor 3D. |
on-remove | ITEM_BUNDLE_REMOVE_ONE, volumen 0.7, tono 1.0, categoría PLAYERS | Se quitó una skin con un removedor con éxito. |
Estos sonidos más suaves son los que escribe la 1.4 en una instalación nueva; un config.yml escrito por
una versión anterior conserva los que tiene.
Un intento rechazado no suena, y una skin aplicada por la API tampoco.
Los efectos que declara una skin — equipar, desequipar, ambiente y bonus de set — viven en
skins.yml.
Claves de showcase#
Claves de showcase
Sitios que exponen skins solos, una detrás de otra, para quien pase: una pieza central de lobby. Nadie tiene que tener nada ni hacer nada.
| Clave | Por defecto | Qué hace |
|---|---|---|
locations | [] | Dónde están los showcases, como server,world,x,y,z,yaw,pitch. Se ponen con /armorskinsadmin showcase add, que guarda dónde estás y hacia dónde miras. |
pause-seconds | 3.0 | El descanso entre una skin y la siguiente. |
radius | 24.0 | A cuántos bloques tiene que estar un jugador para que un showcase se reproduzca y lo vea. |
only | [] | Los ids de skin entre los que elige un showcase. Vacío elige entre todas. |
En cada turno aparece un maniquí con la skin de piel de un jugador que mira, vestido con una skin en todas las piezas en las que encaja (sobre cuero simple, lleve lo que lleve de verdad quien mira) y con el nombre de la skin flotando sobre la cabeza. Da una vuelta lenta de seis segundos para que la skin se vea por todos lados y acaba mirando hacia donde se colocó el showcase. Una skin animada sigue animando y sus partículas de ambiente se dibujan alrededor; sus sonidos, títulos y mensajes de set se omiten, porque un showcase no tiene portador al que hablarle.
Sin nadie dentro de radius no se reproduce nada, así que un lobby vacío cuesta una comprobación de
distancia por segundo. Un jugador cuyos cosméticos están ocultos (staff de servicio, por ejemplo) ni
hace de maniquí ni lo ve.
Claves de crate y shop#
Claves de crate y shop
Las llaves, rarezas, rodillos y bloques de la caja, y los precios a los que el vestidor vende las skins bloqueadas, están explicados en La caja.
Claves de menu#
Claves de menu
| Clave | Por defecto | Qué hace |
|---|---|---|
style | CLASSIC | Qué abre /wardrobe. CLASSIC: el menú de inventario. SPATIAL: el vestidor 3D de pie en el mundo, dispuesto en spatial/wardrobe.yml. /wardrobe 3d y /wardrobe classic abren uno u otro diga lo que diga esto. |
ownership#
ownership:
scope: global
global-currencies: []Dónde cuenta lo que un jugador desbloquea aquí: global (todos los servidores, el valor por defecto), server, default (el grupo de red de este servidor) o el nombre de un grupo. Lo desbloqueado de forma global siempre cuenta. global-currencies lista las monedas cuyas compras cuentan en todos los servidores sea cual sea el ámbito. Reinicia para aplicarlo. Nuevo en v1.5.0
Todas las líneas de messages.yml#
Todas las líneas de messages.yml
Cada línea que envía el plugin, en lang/<idioma>/messages.yml. %prefix% se expande al valor de
prefix; %skin% se rellena en cada mensaje que nombra una skin.
| Clave | Por defecto | Tokens |
|---|---|---|
prefix | {primary}&lE-SKINS {letters_black}•<reset> | — |
applied | %prefix%{success}Skin {highlight}%skin% {success}applied. | %skin% |
removed | %prefix%{success}Skin {highlight}%skin% {success}removed and returned to you. | %skin% |
not-armor | %prefix%{error}That is not a piece of armor. | — |
unsupported-piece | %prefix%{error}The skin {highlight}%skin% {error}does not fit that piece. | %skin% |
unknown-skin | %prefix%{error}That skin no longer exists. | %skin% |
already-skinned | %prefix%{warning}That armor already wears a skin. Use a remover first. | — |
no-skin | %prefix%{warning}That armor wears no skin. | — |
inventory-full | %prefix%{error}You need a free slot in your inventory. | — |
no-permission | %prefix%{error}You do not own the skin {highlight}%skin%{error}. | %skin% |
given | %prefix%{success}You received {highlight}%amount%x %skin%{success}. | %skin%, %amount% |
given-remover | %prefix%{success}You received {highlight}%amount%x skin remover{success}. | %amount% |
list-header | %prefix%{secondary}Available skins: | — |
list-entry | {letters_black}▎ {info}%id% {letters_black}» {letters}%skin% {letters_black}(%pieces%) | %id%, %skin%, %pieces% |
list-empty | %prefix%{muted}No skins are registered. | — |
refreshed | %prefix%{success}Appearance synchronised. | — |
wardrobe-disabled | %prefix%{error}The wardrobe is off on this server. | — |
feature-locked | %prefix%{error}Your rank does not include that feature. | — |
wardrobe-cleared | %prefix%{success}Your wardrobe is empty again. | — |
rewards-claimed | Se entregaron al entrar los objetos guardados para un jugador sin sitio. | %amount% |
nothing-changed | Una escritura de admin dejó el vestidor como estaba. | %player% |
showcase-added · showcase-removed · showcase-missing | showcase add y remove. | %location% |
showcases-header · showcases-entry · showcases-empty · showcases-cleared | showcase list y clear. | %location%, %amount% |
keys-given · keys-taken | Subcomandos keys: al admin, y al jugador que perdió llaves. | %player%, %amount% |
unlock-granted · unlock-already · unlock-revoked · unlock-missing | Subcomandos unlocks. | %skin%, %player% |
crate-block-* · crate-blocks-* | Subcomandos crate block. | %location%, %amount% |
crate-description | La línea bajo una skin en los rodillos de la caja: {letters}Fits {info}%pieces%. | %pieces% |
Los valores por defecto son los del archivo inglés; lang/es/messages.yml los trae traducidos. Después
vienen las secciones:
| Sección | Qué guarda |
|---|---|
skin-item · remover-item | name y lore de los dos objetos. %skin% y %pieces% en el objeto de skin. |
key-item | name y lore de la llave de caja que se lleva en la mano. |
armor-lore | Las líneas bajo la armadura con skin. %skin%. |
wardrobe | Cómo llama el vestidor a las cosas: full-set, helmet, chestplate, leggings, boots, empty, y piece-names, cómo se escribe una pieza dentro de una frase, como las piezas en las que encaja una skin. Ver Configura el vestidor. |
spatial | Cada palabra que dibuja el vestidor 3D, sus líneas de chat (saved-message, save-blocked, discarded), las líneas de admin de los vestidores colocados (spot-placed, spot-removed, spot-missing) y, bajo catalog, las palabras de botones y estados: SAVE, BUY & SAVE, CONFIRM, revertir, quitar, la caja y la visita. |
crate | Las líneas propias de la caja: won, duplicate, no-keys, busy, empty, disabled, keys-received, rewards-claimed. Ver La caja. |
Lo que dice una compra (la confirmación, el éxito, dinero insuficiente) es de ExyliaLib, bajo
purchase en el messages.yml del propio ExyliaLib.
prefix se registra en ExyliaLib al arrancar y en cada recarga, así que %prefix% escrito en
cualquier texto de este plugin se resuelve a él. Otro plugin de Exylia que use %prefix% obtiene el
suyo: los dos nunca chocan.
Los otros archivos#
Las skins viven en skins.yml, las animaciones en
animations.yml y las pantallas en lang/<idioma>/menus/: el
vestidor y la caja.
¿Falta algo en esta página? Dínoslo en Discord