Contenido generado con IA — puede contener errores.

ExyliaArmorSkin/ReferenciaActualizada en v1.5.0

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.

Página 12 de 2111 min de lectura
          # ... ver La caja       - {permission: group.vip, cosmetic: galaxy}    - {permission: '', cosmetic: ocean} 

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 defecto default, que sigue el idioma de ExyliaLib). Mira Instalación.
  • De dónde salen las skins: behaviour.mode es item, wardrobe o both (por defecto). Mira Configura el vestidor.
  • Dónde no hay skins: behaviour.disabled-worlds es una lista de nombres de mundo.

Tras editar, ejecuta /armorskinsadmin reload. Las secciones de abajo listan todas las claves.

El config.yml por defecto
config.yml
yaml
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: CLASSIC

Claves de language#

Claves de language

De qué carpeta de lang/ se leen los menús y mensajes de este plugin.

ValorQué significa
defaultSigue el idioma puesto en el config.yml de ExyliaLib. Es lo que escribe una instalación nueva.
en, es, pt, fr, ru, trEste plugin solo, en ese idioma. Los seis vienen incluidos.
customLos 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.

ClaveQué hace
materialEl material del objeto. En el objeto de skin solo se usa cuando la skin no define icon.
glowSi el objeto tiene el brillo de encantamiento. Los atributos siempre se ocultan.

Claves de armor-lore#

Claves de armor-lore
ClavePor defectoQué hace
enabledtrueApá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.

Estas líneas nunca tocan el objeto

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
ClavePor defectoQué hace
modebothitem, wardrobe o both. Ver Configura el vestidor.
consume-skin-itemtrueSi el objeto de skin se gasta al aplicarlo. Apagado, un objeto pone la skin en cualquier número de piezas.
consume-removertrueSi el removedor se gasta al quitar una skin.
hide-without-permissiontrueSi 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
yaml
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.

ClavePor defectoCuándo
on-applyITEM_ARMOR_EQUIP_LEATHER, volumen 0.7, tono 1.2, categoría PLAYERSSe arrastró una skin sobre la armadura con éxito, o se guardó el vestidor 3D.
on-removeITEM_BUNDLE_REMOVE_ONE, volumen 0.7, tono 1.0, categoría PLAYERSSe 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.

ClavePor defectoQué 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-seconds3.0El descanso entre una skin y la siguiente.
radius24.0A 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
ClavePor defectoQué hace
styleCLASSICQué 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#

yaml
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.

ClavePor defectoTokens
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-claimedSe entregaron al entrar los objetos guardados para un jugador sin sitio.%amount%
nothing-changedUna escritura de admin dejó el vestidor como estaba.%player%
showcase-added · showcase-removed · showcase-missingshowcase add y remove.%location%
showcases-header · showcases-entry · showcases-empty · showcases-clearedshowcase list y clear.%location%, %amount%
keys-given · keys-takenSubcomandos keys: al admin, y al jugador que perdió llaves.%player%, %amount%
unlock-granted · unlock-already · unlock-revoked · unlock-missingSubcomandos unlocks.%skin%, %player%
crate-block-* · crate-blocks-*Subcomandos crate block.%location%, %amount%
crate-descriptionLa 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ónQué guarda
skin-item · remover-itemname y lore de los dos objetos. %skin% y %pieces% en el objeto de skin.
key-itemname y lore de la llave de caja que se lleva en la mano.
armor-loreLas líneas bajo la armadura con skin. %skin%.
wardrobeCó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.
spatialCada 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.
crateLas 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.

El prefijo es solo de este plugin

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