Contenido generado con IA — puede contener errores.

ExyliaArrows/GuíasActualizada en v1.7.1

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.

Página 4 de 226 min de lectura

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.

El id del efecto es el permiso

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

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

La estela es la que tiene presupuesto

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

ClaveQué hace
categoryBajo qué pestaña aparece. Debe ser una clave declarada en categories.
tierCuá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>.
nameCómo lo llaman los menús y los placeholders.
materialEl ítem con el que se dibuja su fila. Si falta material se lee icon.
descriptionUna lista es una línea por entrada; un texto simple se parte en <nl>. lore se acepta como otra forma de escribirla.
prioritySu posición en la pestaña; el más bajo va primero.
trail-intervalTicks entre pasos de la estela. 1 es cada tick, 2 uno sí y otro no. Por defecto trail.default-interval.
trail-max-durationOpcional. Cuánto puede vivir la estela de este efecto. Sin ella vale trail.max-duration.
effectsLos disparadores, abajo.
bowsOpcional. A qué se puede atar.
projectilesOpcional. En qué proyectiles suena; projectile-types se acepta como otra forma de escribirlo. Sin él decide config.yml.
priceOpcional. Cuánto cuesta en el menú; gana a shop.tier-prices de su rareza. Mira Configuración.
DisparadorCuándo
launchLa flecha saliendo del arco.
trailDurante el vuelo, cada trail-interval ticks.
hitDonde caiga, golpee lo que golpee.
hit-entitySolo sobre algo vivo. Usa hit si no se declara.
hit-blockSolo 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:

FamiliaCoincide con
ANYCualquier cosa.
BOW, CROSSBOW, TRIDENTSolo ese ítem.
RANGEDArcos, 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