Content generated with AI — it may contain mistakes.

ExyliaArrows/GuidesUpdated in v1.7.1

Add and edit effects

Write your own arrow effect, change the 120 shipped ones and sort them into categories and rarities in effects.yml.

Page 4 of 226 min read

By the end of this page you have a new arrow effect of your own in effects.yml, you have seen it play, and a rank can use it. The same steps edit any of the 120 effects that ship with the plugin.

Before you start#

Install the plugin and set the preview stage, see Your first effect. Previews are how you check an effect without shooting. If you would rather have an AI write the effect, see Create an effect with AI.

Steps#

Open the file

Open plugins/ExyliaArrows/lang/<code>/effects.yml, where <code> is your language in config.yml (see Install ExyliaArrows). Or edit it without opening a file, see "Edit it in game" below.

Add the entry

Add a new key under arrow_effects, with a category that exists and an effects block naming at least one trigger. The shape is in the technical details below; copy a shipped effect and change it.

Spend where it shows

Keep the trail to a display or two and put the work in hit. The step language is in How sequences work.

Reload

Run /arrowsadmin reload.

Look at it

Run /arrows preview <effect>. It plays against an empty sky on the preview stage, then puts you back.

Grant it

Give a rank the permission exyliarrows.effect.<id in lowercase>, or the whole category with exyliarrows.category.<category>. See Permissions.

Check that it works#

Run /arrowsadmin list: the new effect is in the list. Run /arrows preview <effect> and watch launch, trail and impact. If a line of the effect could not be read, the console prints it with the line that caused it, and the rest of the effect still plays.

The effect id is the permission

EMBER_TRAIL is exyliarrows.effect.ember_trail. Renaming the key renames the permission, and a bow bound to the old key stops playing. Case does not matter: ids are lowercased on the way in.

Going further#

Restrict an effect to some bows#

Add bows to the effect. It is only read while behaviour.mode reads bows (see Bind effects to bows).

yaml
bows: [ CROSSBOW, TRIDENT ]

None of the shipped effects declares bows, so out of the box every one of them fits every bow.

Set a price#

Add price to sell one effect in the menu: a number in the default currency, or {amount: 50, currency: gems}. It wins over the price of its rarity. See Set up the crate and the shop.

Make it play on other projectiles#

Add projectiles with the entity types, for example [ SNOWBALL ]. Without it, config.yml decides which projectiles carry effects.

Edit it in game#

effects.yml is also editable in game from /exylialib config, and in the browser through ExyliaLib's web editor, both with exyliarrows.admin. Before anything is written, the change is read by the same loader a reload uses. If an entry or a section would be lost (a missing categories or arrow_effects, an entry that is not a section) the whole change is refused and nothing is written. Once applied, the catalogue, the crate, the showcases and any open 3D selector pick it up without a reload.

The trail is the one with a budget

An arrow lives about forty ticks, and four archers are four arrows in the air. Whatever trail writes is drawn on every one of those ticks, per shot: one or two small displays plus a particle line, and no sound. The impact is the payoff and may be bigger: under a second, a dozen displays at the very most.

The shape of an effect
effects.yml
yaml
categories:
  ember:
    material: BLAZE_POWDER
    name: 'Ember'
    priority: 1
 
arrow_effects:
  EMBER_TRAIL:
    category: ember
    tier: common
    name: "<gradient:#FFD08A:#C43A10><bold>EMBER TRAIL</bold></gradient>"
    material: BLAZE_ROD
    description: "Coals come off the shaft, {highlight}tumble, and burn out{neutral} behind it."
    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'

An effect's effects block is a map of triggers, not a list.

KeyWhat it does
categoryWhich tab it appears under. Must be a key declared under categories.
tierHow rare it is. Must be a key declared under config.yml's tiers; without it the effect is common. It decides the colour it is named in, the odds of a crate landing on it, and what exyliarrows.tier.<id> grants.
nameWhat menus and placeholders call it.
materialThe item the row is drawn with. icon is read when material is missing.
descriptionA list is one line per entry; a single string breaks on <nl>. lore is accepted as another spelling.
priorityWhere it sits in its tab; lower comes first.
trail-intervalTicks between trail steps. 1 is every tick, 2 every other. Defaults to trail.default-interval.
trail-max-durationOptional. How long this effect's trail may live. Without it trail.max-duration applies.
effectsThe triggers, below.
bowsOptional. What it may be bound to.
projectilesOptional. Which projectiles it plays on; projectile-types is accepted as another spelling. Without it config.yml decides.
priceOptional. What it sells for in the menu, winning over its rarity's shop.tier-prices. See Configuration.
TriggerWhen
launchThe shot leaving the bow.
trailAlong the flight, every trail-interval ticks.
hitWherever it lands, whatever it hit.
hit-entityOnly on something alive. Falls back to hit.
hit-blockOnly on a block. Falls back to hit.

hit-entity and hit-block are the same moment told apart: declare them when landing on a player and on the ground deserve different pictures. hit_entity is read the same way, because a hyphen is what every other Exylia file writes.

bows accepts item names and families:

FamilyMatches
ANYAnything at all.
BOW, CROSSBOW, TRIDENTJust that item.
RANGEDBows, crossbows and tridents.
All 120 effects

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

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

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

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

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

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

The void category has one called NULL. YAML reads that key as nothing at all unless it is quoted, so leave it exactly as the file writes it if you edit around it.

Something missing on this page? Tell us on Discord