Efectos

Cada skin puede declarar un bloque effects. Todo es opcional, y una skin sin nada simplemente se ve distinta y no hace nada más.

skins:
  inferno:
    effects:
      on-equip:
        sound:
          name: ITEM_ARMOR_EQUIP_NETHERITE
          volume: 0.8
          pitch: 1.2
        title:
          text: '{warning}&lINFERNO'
          subtitle: '{letters}La armadura arde'
      on-unequip:
        sound:
          name: BLOCK_FIRE_EXTINGUISH
      ambient:
        particle: 'FLAME|5|0.3|0'
        sound: ''
        interval: 1.0
        radius: 32.0
      set:
        on-complete:
          sound:
            name: ITEM_FIRECHARGE_USE
            volume: 1.0
            pitch: 1.4
        on-break: {}
        ambient:
          particle: 'FLAME|4|0.4|0.01'
          sound: ''
          interval: 0.25
          radius: 32.0

on-equip y on-unequip

Los dos son efectos estándar de ExyliaLib, así que cada uno puede llevar cualquier combinación de seis secciones. Se reproducen para quien lleva la pieza.

Una sección que no dice nada se deja fuera del archivo, y por eso el skins.yml por defecto no muestra ningún bloque sound: bajo on-equip. Escríbela a mano y a partir de ahí se lee. La referencia completa está en el módulo de efectos de ExyliaLib.

ambient

Se repite mientras la pieza esté puesta.

Las dos líneas se separan por barras verticales, y una clave con namespace sobrevive porque los dos puntos nunca son separador: minecraft:flame|10|0.4|0.01 es válido. La línea de partícula también acepta la forma larga NOMBRE|cantidad|dx|dy|dz|velocidad cuando quieres una dispersión distinta por eje.

Dónde suena

A los pies del portador más la altura de la pieza donde está la skin, así que cuatro piezas con skin son cuatro alturas distintas:

Qué cuesta

Una tarea repetida por pieza equipada que declare un ambiente, atada a la entidad del jugador para que Folia esté conforme y para que muera con él. Se cancela en cuanto la pieza sale, la skin cambia o el jugador se desconecta; nada sobrevive a un apagado del plugin.

Bonus de set

effects.set se dispara cuando un jugador lleva todas las piezas que la skin encaja con esa misma skin. Para una skin con pieces vacío eso son las cuatro; para golden_sentry, que solo encaja en casco y peto, bastan dos piezas.

El set se juzga desde la pieza con skin más alta hacia abajo: la skin que ocupe la primera ranura es la única que puede completar. Tres piezas de inferno y un casco de ocean no completan nada.

Qué traen los valores por defecto

Todas las skins incluidas traen el espectáculo completo: un sonido al ponerse, una partícula alrededor del cuerpo mientras el set aguanta, una línea en la action bar — ✦ Full set » <NOMBRE> — al completarse y ✧ Set broken al romperse.

Todas usan un radio de 32 bloques, un sonido de equipado a volumen 0.8 y uno de completado a volumen 1.0, tono 1.4 y categoría PLAYERS. El on-break es el mismo en todas: BLOCK_BEACON_DEACTIVATE a volumen 0.7 con la línea de set roto.

Aplicar y quitar

Poner una skin y quitarla tienen su propio efecto, y esos dos viven en config.yml y no en la skin, porque pertenecen al sistema:

effects:
  on-apply:
    sound:
      name: BLOCK_SMITHING_TABLE_USE
      volume: 1.0
      pitch: 1.2
  on-remove:
    sound:
      name: BLOCK_GRINDSTONE_USE
      volume: 1.0
      pitch: 1.0

Los dos son efectos completos de ExyliaLib, los dos se reproducen para quien lo hizo y los dos solo suenan tras un arrastre con éxito en el inventario: un intento rechazado no suena, y la API tampoco reproduce nada.