Añade efectos a una skin
Reproduce un sonido o partículas al ponerse una skin, mientras se lleva y cuando el set entero está completo.
Los efectos son lo que hace una skin además de verse distinta: un sonido o un título al ponerla, partículas mientras se lleva y un bonus cuando el set entero está puesto. Al final tienes una skin que suena al equiparla y suelta partículas alrededor del cuerpo con el set completo. Todo es opcional.
Antes de empezar#
Tienes una skin, mira Crea y edita skins. Las cuarenta skins incluidas ya llevan efectos, así que puedes copiar de ellas en skins.yml.
Pasos#
Abre la skin
En skins.yml, busca tu skin y añade un bloque effects debajo.
Añade un sonido al equipar
skins:
inferno:
effects:
on-equip:
sound:
name: ITEM_ARMOR_EQUIP_NETHERITE
volume: 0.8
pitch: 1.2Añade una partícula mientras se lleva el set
skins:
inferno:
effects:
set:
ambient:
particle: 'FLAME|4|0.4|0.01'
interval: 0.25
radius: 32.0Recarga
Ejecuta /armorskinsadmin reload.
Comprueba que funciona#
Ponte la skin: oyes el sonido. Lleva todas las piezas que encaja y salen llamas alrededor de tu cuerpo; quita una y paran. Si no oyes nada, revisa el nombre del sonido (un id de sonido de Minecraft como ITEM_ARMOR_EQUIP_NETHERITE) y mira Problemas comunes.
Ir más lejos#
Títulos, action bars y más al equipar#
on-equip y on-unequip son efectos estándar de ExyliaLib que se reproducen para quien lleva la skin. Cada uno puede llevar title, action-bar, boss-bar, sound, particle y firework. La referencia completa es el módulo de efectos de ExyliaLib.
on-equip suena cuando se equipa una pieza o cambia su skin en el cuerpo. Entrar, reaparecer, cambiar de mundo, /armorskinsadmin refresh y /armorskinsadmin reload reconstruyen el aspecto en silencio, así que un jugador que entra no recibe cuatro títulos. Cambiar de armadura de ida y vuelta los reproduce como mucho una vez por segundo.
Partículas en cada pieza#
ambient se repite en cada pieza que se lleva, a la altura de esa pieza, mientras esté puesta. particle es NOMBRE|cantidad|dispersión|velocidad, sound es NOMBRE|volumen|tono, interval son los segundos entre repeticiones (mínimo 0.05, por defecto 1.0) y radius los bloques a la redonda que lo ven u oyen (por defecto 32.0). Detalles abajo.
Bonus de set#
effects.set se dispara cuando un jugador lleva todas las piezas que la skin encaja con esa misma skin: las cuatro con pieces vacío, dos para una skin con pieces: [helmet, chestplate].
| Clave | Qué es |
|---|---|
on-complete | Un efecto que suena una vez, en el momento en que el set se completa. |
on-break | Un efecto que suena una vez, en el momento en que deja de estar completo. |
ambient | Las mismas claves que el ambient por pieza, reproducido alrededor del jugador a una altura de 1.0 mientras el set aguanta. |
El set se juzga de la pieza con skin más alta hacia abajo: la skin del primer hueco ocupado es la única que puede completar. Tres piezas inferno y un casco ocean no completan nada.
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 de action bar ✦ Full set » <NOMBRE> al cerrarse y ✧ Set broken al terminar. Pasar directamente de un set completo a otro reproduce el nuevo on-complete pero no el on-break del anterior.
El sonido de aplicar y quitar#
Poner una skin y quitarla con un objeto de skin o un removedor tienen su propio sonido, en effects.on-apply y effects.on-remove de config.yml (por defecto ITEM_ARMOR_EQUIP_LEATHER e ITEM_BUNDLE_REMOVE_ONE, volumen 0.7). Solo suenan al arrastrar con éxito en el inventario: una aplicación rechazada no reproduce nada, y la API tampoco.
Secciones de efecto y claves de ambient
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.
| Sección | Claves |
|---|---|
title | text, subtitle, fade-in, stay, fade-out, countdown, time-style |
action-bar | text, duration, countdown, time-style |
boss-bar | text, colour, overlay, countdown, count-up, progress, time-style |
sound | name, volume, pitch, category |
particle | name, count, spread, speed |
firework | colours, fades, shape, flicker, trail |
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.
on-equip suena al equipar una pieza o cuando su skin cambia sobre el cuerpo. Entrar al servidor,
reaparecer, cambiar de mundo, /armorskinsadmin refresh y /armorskinsadmin reload reconstruyen el visual en
silencio: a un jugador que se conecta no le reciben cuatro títulos. Cambiar de armadura una y otra vez los hace
sonar como mucho una vez por segundo: un cambio dentro de ese segundo redibuja la pieza sin sonido.
ambient
Se repite mientras la pieza esté puesta.
| Clave | Por defecto | Qué es |
|---|---|---|
particle | '' | NOMBRE|cantidad|dispersión|velocidad. Vacío para ninguna. |
sound | '' | NOMBRE|volumen|tono. Vacío para ninguno. |
interval | 1.0 | Segundos entre repeticiones. Por debajo de 0.05 se sube a ese valor. |
radius | 32.0 | Bloques alrededor del jugador que lo ven o lo oyen. Por debajo de 1.0 se sube a ese valor. |
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:
| Pieza | Altura |
|---|---|
helmet | 1,7 |
chestplate | 1,2 |
leggings | 0,7 |
boots | 0,2 |
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.
El mínimo existe para que un error tipográfico no pida menos, no como invitación. Una partícula por segundo en el peto es para lo que están pensados los valores por defecto.
Efectos que traen todas las skins
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.
| Skin | Partícula ambiental del set | Intervalo | Sonido de on-equip | Sonido de on-complete |
|---|---|---|---|---|
rainbow | NOTE|3|0.5|0 | 0,5 s | BLOCK_NOTE_BLOCK_CHIME | BLOCK_NOTE_BLOCK_BELL |
pastel | END_ROD|2|0.4|0 | 0,5 s | BLOCK_AMETHYST_BLOCK_CHIME | BLOCK_AMETHYST_BLOCK_CHIME |
inferno | FLAME|4|0.4|0.01 | 0,25 s | ITEM_FIRECHARGE_USE | ENTITY_BLAZE_SHOOT |
ocean | BUBBLE_POP|3|0.4|0 | 0,3 s | AMBIENT_UNDERWATER_ENTER | ENTITY_DOLPHIN_SPLASH |
heartbeat | HEART|1|0.3|0 | 1,2 s | ENTITY_WARDEN_HEARTBEAT | ENTITY_WARDEN_HEARTBEAT |
toxic | SNEEZE|2|0.4|0.02 | 0,4 s | ENTITY_CREEPER_HURT | ENTITY_CREEPER_PRIMED |
galaxy | END_ROD|2|0.5|0.01 | 0,4 s | BLOCK_AMETHYST_CLUSTER_PLACE | BLOCK_END_PORTAL_FRAME_FILL |
aurora | GLOW|3|0.5|0 | 0,4 s | BLOCK_AMETHYST_CLUSTER_PLACE | BLOCK_BEACON_ACTIVATE |
ember | SMALL_FLAME|3|0.4|0.01 | 0,4 s | BLOCK_FIRE_AMBIENT | ITEM_FIRECHARGE_USE |
voltage | ELECTRIC_SPARK|4|0.4|0.05 | 0,25 s | BLOCK_COPPER_BULB_TURN_ON | BLOCK_COPPER_BULB_TURN_ON |
tempest | CLOUD|3|0.5|0.02 | 0,4 s | ENTITY_BREEZE_WIND_BURST | ENTITY_BREEZE_SHOOT |
sakura | CHERRY_LEAVES|3|0.5|0 | 0,4 s | BLOCK_CHERRY_WOOD_PLACE | BLOCK_NOTE_BLOCK_CHIME |
shogun | CRIT|3|0.4|0.05 | 0,5 s | ITEM_ARMOR_EQUIP_NETHERITE | ENTITY_PLAYER_ATTACK_SWEEP |
dragonfire | LAVA|2|0.4|0 | 0,35 s | ENTITY_PHANTOM_FLAP | ENTITY_BLAZE_SHOOT |
void_dragon | DRAGON_BREATH|3|0.5|0.01 | 0,35 s | BLOCK_RESPAWN_ANCHOR_AMBIENT | BLOCK_END_PORTAL_FRAME_FILL |
frostbite | SNOWFLAKE|4|0.5|0.01 | 0,4 s | BLOCK_POWDER_SNOW_STEP | BLOCK_GLASS_BREAK |
neon | GLOW|3|0.4|0 | 0,3 s | BLOCK_BEACON_POWER_SELECT | BLOCK_BEACON_POWER_SELECT |
verdant | FALLING_SPORE_BLOSSOM|2|0.5|0 | 0,5 s | BLOCK_MOSS_PLACE | BLOCK_AZALEA_PLACE |
bloodmoon | CRIMSON_SPORE|4|0.5|0 | 0,4 s | ENTITY_WOLF_GROWL | ENTITY_WOLF_HOWL |
celestial | WAX_ON|3|0.5|0 | 0,4 s | BLOCK_AMETHYST_BLOCK_CHIME | BLOCK_AMETHYST_BLOCK_RESONATE |
thunderlord | FIREWORK|3|0.4|0.02 | 0,3 s | ITEM_TRIDENT_RIPTIDE_1 | ITEM_TRIDENT_RETURN |
phoenix | FALLING_LAVA|2|0.4|0 | 0,3 s | ENTITY_BLAZE_AMBIENT | ENTITY_BLAZE_SHOOT |
tidecaller | NAUTILUS|3|0.5|0.01 | 0,35 s | ENTITY_DOLPHIN_AMBIENT_WATER | BLOCK_CONDUIT_ACTIVATE |
starfall | ENCHANTED_HIT|4|0.5|0.02 | 0,3 s | ENTITY_EXPERIENCE_ORB_PICKUP | BLOCK_AMETHYST_BLOCK_CHIME |
magmacore | LANDING_LAVA|2|0.3|0 | 0,4 s | BLOCK_LAVA_AMBIENT | ENTITY_MAGMA_CUBE_JUMP |
glacier | ITEM_SNOWBALL|4|0.5|0.01 | 0,4 s | BLOCK_POWDER_SNOW_PLACE | ENTITY_PLAYER_HURT_FREEZE |
spectre | SOUL|3|0.5|0.01 | 0,4 s | ENTITY_PHANTOM_FLAP | ENTITY_VEX_CHARGE |
midas | WAX_OFF|3|0.4|0 | 0,4 s | ITEM_ARMOR_EQUIP_GOLD | BLOCK_NOTE_BLOCK_BELL |
prismatic | ENCHANT|5|0.5|0.02 | 0,3 s | BLOCK_AMETHYST_BLOCK_RESONATE | BLOCK_AMETHYST_BLOCK_CHIME |
nebula | REVERSE_PORTAL|4|0.5|0.01 | 0,4 s | BLOCK_AMETHYST_BLOCK_RESONATE | BLOCK_END_PORTAL_FRAME_FILL |
venom | WARPED_SPORE|4|0.5|0 | 0,35 s | ENTITY_SPIDER_AMBIENT | ENTITY_WITCH_CELEBRATE |
solarflare | FLAME|5|0.5|0.02 | 0,25 s | ENTITY_BLAZE_BURN | ITEM_FIRECHARGE_USE |
abyss | SQUID_INK|3|0.5|0 | 0,45 s | ENTITY_GUARDIAN_AMBIENT | BLOCK_CONDUIT_ACTIVATE |
runeforged | SOUL_FIRE_FLAME|3|0.4|0.01 | 0,4 s | BLOCK_ANVIL_USE | BLOCK_SMITHING_TABLE_USE |
blossomfall | SPORE_BLOSSOM_AIR|3|0.5|0 | 0,5 s | BLOCK_PINK_PETALS_PLACE | BLOCK_NOTE_BLOCK_FLUTE |
warden | SCULK_SOUL|3|0.5|0.01 | 0,5 s | BLOCK_SCULK_CATALYST_BLOOM | BLOCK_SCULK_CATALYST_BLOOM |
chrome | DUST_PLUME|3|0.4|0.01 | 0,4 s | ITEM_ARMOR_EQUIP_IRON | BLOCK_CHAIN_PLACE |
wildfire | ASH|6|0.5|0.02 | 0,3 s | ITEM_FLINTANDSTEEL_USE | ENTITY_BLAZE_SHOOT |
eclipse | OMINOUS_SPAWNING|3|0.5|0 | 0,45 s | BLOCK_RESPAWN_ANCHOR_CHARGE | BLOCK_RESPAWN_ANCHOR_SET_SPAWN |
arcane | PORTAL|5|0.5|0.01 | 0,35 s | BLOCK_ENCHANTMENT_TABLE_USE | ENTITY_EVOKER_CAST_SPELL |
Todas usan un radio de 32 bloques, un sonido de equipado a volumen 0.7 y uno de completado a volumen
0.7, tono 1.4 y categoría PLAYERS. Desde la 1.4 ninguna usa un sonido fuerte o dramático (truenos,
dragones, fuegos artificiales, el tótem). Desde la 1.4.1 un skins.yml escrito por una versión anterior
también pasa a ellos, sonido a sonido: un sonido de equipar o de set completo que sigue tal como lo
envió la 1.3 se cambia, y uno que el dueño cambió o ajustó se conserva. El on-break es el mismo en todas:
BLOCK_BEACON_DEACTIVATE a volumen 0.7 con la línea de set roto.
Pasar de un set completo de inferno a uno completo de ocean reproduce el on-complete de ocean
pero no el on-break de inferno: la línea de ruptura es para un set que de verdad terminó.
¿Falta algo en esta página? Dínoslo en Discord