Añade y edita efectos
Escribe tu propio efecto de flecha, cambia los 120 incluidos y ordénalos en categorías y rarezas en effects.yml.
Al terminar esta página tendrás un efecto de flecha propio en effects.yml, lo habrás visto en acción y un rango podrá usarlo. Los mismos pasos sirven para editar cualquiera de los 120 efectos que trae el plugin.
Antes de empezar#
Instala el plugin y fija el escenario de vista previa, mira Tu primer efecto. Las vistas previas son la forma de comprobar un efecto sin disparar. Si prefieres que lo escriba una IA, mira Crea un efecto con IA.
Pasos#
Abre el archivo
Abre plugins/ExyliaArrows/lang/<código>/effects.yml, donde <código> es el language de tu config.yml (mira Instala ExyliaArrows). O edítalo sin abrir ningún archivo, mira "Edítalo en el juego" más abajo.
Añade la entrada
Añade una clave nueva bajo arrow_effects, con una category que exista y un bloque effects con al menos un disparador. La forma está en los detalles técnicos de abajo; copia un efecto incluido y cámbialo.
Gasta donde se ve
Deja la estela en uno o dos displays y pon el trabajo en hit. El lenguaje de los pasos está en Cómo funcionan las secuencias.
Recarga
Ejecuta /arrowsadmin reload.
Míralo
Ejecuta /arrows preview <efecto>. Se reproduce contra un cielo vacío en el escenario de vista previa y después te devuelve a donde estabas.
Concédelo
Da a un rango el permiso exyliarrows.effect.<id en minúsculas>, o la categoría entera con exyliarrows.category.<categoría>. Mira Permisos.
Comprueba que funciona#
Ejecuta /arrowsadmin list: el efecto nuevo está en la lista. Ejecuta /arrows preview <efecto> y mira el lanzamiento, la estela y el impacto. Si una línea del efecto no se pudo leer, la consola la muestra con la línea que la causó, y el resto del efecto sigue sonando.
EMBER_TRAIL es exyliarrows.effect.ember_trail. Renombrar la clave renombra el permiso, y un arco atado a la clave antigua deja de reproducir nada. Las mayúsculas no importan: los ids se pasan a minúsculas al entrar.
Ir más lejos#
Limita un efecto a algunos arcos#
Añade bows al efecto. Solo se lee mientras behaviour.mode lee arcos (mira Ata efectos a arcos).
bows: [ CROSSBOW, TRIDENT ]Ninguno de los efectos incluidos declara bows, así que de fábrica todos valen para cualquier arco.
Ponle precio#
Añade price para vender un efecto en el menú: un número en la moneda por defecto, o {amount: 50, currency: gems}. Gana al precio de su rareza. Mira Configura la caja y la tienda.
Que suene en otros proyectiles#
Añade projectiles con los tipos de entidad, por ejemplo [ SNOWBALL ]. Sin él, decide config.yml qué proyectiles llevan efectos.
Edítalo en el juego#
effects.yml también se edita en el juego desde /exylialib config, y en el navegador con el editor web de ExyliaLib, ambos con exyliarrows.admin. Antes de escribir nada, el cambio lo lee el mismo cargador que usa una recarga. Si se perdiera una entrada o una sección (falta categories o arrow_effects, o una entrada que no es una sección) se rechaza todo el cambio y no se escribe nada. Una vez aplicado, el catálogo, la caja, los escaparates y cualquier selector 3D abierto lo recogen sin recargar.
Una flecha vive unos cuarenta ticks, y cuatro arqueros son cuatro flechas en el aire. Todo lo que escribe trail se dibuja en cada uno de esos ticks, en cada disparo: uno o dos displays pequeños más una línea de partículas, y sin sonido. El impacto es el premio y puede ser más grande: menos de un segundo, una docena de displays como mucho.
La forma de un efecto
categories:
ember:
material: BLAZE_POWDER
name: 'Ascua'
priority: 1
arrow_effects:
EMBER_TRAIL:
category: ember
tier: common
name: "<gradient:#FFD08A:#C43A10><bold>RASTRO DE BRASAS</bold></gradient>"
material: BLAZE_ROD
description: "Salen brasas del astil, {highlight}dan vueltas y se apagan{neutral} tras ella."
priority: 1
trail-interval: 1
effects:
trail:
- '[DISPLAY] MAGMA_BLOCK;as:block;size:0.09;size_to:0.01;life:0.45;spin:1,1,1;gravity:2;light:15;glow:{warning}'
- '[PARTICLE] FLAME;count:2;offset:0.04,0.04,0.04;speed:0.01'
hit:
- '[SOUND] BLOCK_FIRE_EXTINGUISH;0.7;1.3'
- '[CIRCLE] MAGMA_BLOCK;as:block;radius:0.2;points:10;size:0.1,0.05,0.1;size_to:0.5,0.04,0.5;pull:-2;ease:out;life:0.45;y:0.05;light:15;glow:{warning}'
- '[PARTICLE] FLAME;count:14;offset:0.4,0.2,0.4;speed:0.05'El bloque effects de un efecto es un mapa de disparadores, no una lista.
| Clave | Qué hace |
|---|---|
category | Bajo qué pestaña aparece. Debe ser una clave declarada en categories. |
tier | Cuán raro es. Debe ser una clave declarada en tiers de config.yml; sin ella el efecto es común. Decide el color de su nombre, las probabilidades de que la caja lo dé y lo que concede exyliarrows.tier.<id>. |
name | Cómo lo llaman los menús y los placeholders. |
material | El ítem con el que se dibuja su fila. Si falta material se lee icon. |
description | Una lista es una línea por entrada; un texto simple se parte en <nl>. lore se acepta como otra forma de escribirla. |
priority | Su posición en la pestaña; el más bajo va primero. |
trail-interval | Ticks entre pasos de la estela. 1 es cada tick, 2 uno sí y otro no. Por defecto trail.default-interval. |
trail-max-duration | Opcional. Cuánto puede vivir la estela de este efecto. Sin ella vale trail.max-duration. |
effects | Los disparadores, abajo. |
bows | Opcional. A qué se puede atar. |
projectiles | Opcional. En qué proyectiles suena; projectile-types se acepta como otra forma de escribirlo. Sin él decide config.yml. |
price | Opcional. Cuánto cuesta en el menú; gana a shop.tier-prices de su rareza. Mira Configuración. |
| Disparador | Cuándo |
|---|---|
launch | La flecha saliendo del arco. |
trail | Durante el vuelo, cada trail-interval ticks. |
hit | Donde caiga, golpee lo que golpee. |
hit-entity | Solo sobre algo vivo. Usa hit si no se declara. |
hit-block | Solo sobre un bloque. Usa hit si no se declara. |
hit-entity y hit-block son el mismo momento contado por separado: decláralos cuando caer sobre un jugador y sobre el suelo merezcan imágenes distintas. hit_entity se lee igual, porque el guion es lo que escriben todos los demás archivos de Exylia.
bows acepta nombres de ítem y familias:
| Familia | Coincide con |
|---|---|
ANY | Cualquier cosa. |
BOW, CROSSBOW, TRIDENT | Solo ese ítem. |
RANGED | Arcos, ballestas y tridentes. |
Los 120 efectos
Ascua (ember) — BLAZE_POWDER
EMBER_TRAIL INFERNO CINDERFALL MAGMA_CORE FIREBRAND SCORCH PYRE ASHFALL FORGE_STRIKE
METEOR MOLTEN_RAIN EMBER_WINGS COALFALL FLINT_SPARK SUNFIRE CRIMSON_BLOOM TORCHLIGHT
FURNACE_BLAST WILDFIRE PHOENIX
Escarcha (frost) — BLUE_ICE
FROSTBITE SNOWFALL ICE_SHARD BLIZZARD GLACIER HAILSTORM PERMAFROST FROZEN_CORE SLEET
ICICLE FROST_NOVA DEEP_FREEZE AURORA DIAMOND_DUST COLD_SNAP FROSTED_GLASS CRYO_SHOT
AVALANCHE WINTER_BLOOM ABSOLUTE_ZERO
Tormenta (storm) — LIGHTNING_ROD
THUNDERBOLT STATIC_CHARGE WIND_GUST SQUALL TEMPEST CHAIN_LIGHTNING SKYFALL CLOUDBURST
DOWNPOUR CYCLONE THUNDERHEAD WIND_SHEAR STORM_SURGE IONISE GALE BREEZE_SHOT MONSOON
STATIC_WEB UPDRAFT SKYBREAKER
Vacío (void) — ECHO_SHARD
SOULBOUND VOID_TEAR SCULK_BLOOM WITHERING ENDER_RIFT SHADOW_STEP NECROTIC SHRIEKER
ABYSS GRAVE_DUST WRAITH OBSIDIAN_TEAR DARK_MATTER SOUL_FIRE CATACOMB NULL REAPER
PHANTASM DECAY EVENT_HORIZON
Prisma (prism) — AMETHYST_SHARD
STARLIGHT AMETHYST ARCANE_BOLT SPECTRUM BEACON GILDED REFRACTION NOVA SANCTUM
GLIMMER ECHO_CRYSTAL STARFALL LUMEN KALEIDOSCOPE SOLAR_FLARE CRYSTALLINE PRISM_ARROW
HALO MIRROR CELESTIAL
Chiflado (goofy) — SLIME_BALL
BONK RUBBER_CHICKEN PIE CONFETTI BUBBLE SLIME_TIME CAKE_DROP DUCK ANGRY_BEE BOING
SQUEAK TOAST BANANA TNT_PRANK SNOWBALL_FIGHT ANVIL_DROP OOF SAD_TRUMPET DISCO
ROLL_CREDITS
La categoría Vacío tiene uno llamado NULL. YAML lee esa clave como nada a menos que esté entre comillas, así que déjala exactamente como la escribe el archivo si editas a su alrededor.
¿Falta algo en esta página? Dínoslo en Discord