Edit the effect catalogue
Rename, reprice, restrict or remove any of the 110 kill effects, or add your own, by editing the effects file.
You will change what the 110 kill effects are called, what they cost and which weapons carry them, take some out, and add one of your own. All of it is one file, and a reload applies it.
Before you start#
Find the file: plugins/ExyliaKillEffect/lang/<code>/effects.yml, where <code> is the plugin's language (en by default, see Messages and languages). Open it in the browser instead if you prefer: the web editor (/exylialib editor) checks the file before saving it and applies it with no reload.
The file has two blocks. categories are the tabs of the menu (Meme, Void, Cataclysm, Lovestruck, Cosmic). kill_effects are the effects, each under its id, for example GRIDDY.
Steps#
Rename an effect
Change its name. Colours tokens, MiniMessage and gradients all work. The id does not change, so permissions and tokens keep working.
Set a price
Add price: 2500 to the effect. It is sold in the menu at that price in your default currency, or in another one with price: {amount: 50, currency: gems}. A price here wins over the rarity price. Prices only show when shop.enabled is on (it is by default) and an economy is installed, see Configuration and Economy.
Limit it to some weapons
Add weapons: [ SWORD, AXE ]. It only matters when a player can bind effects to weapons, see Modes and tokens. Without weapons, the effect fits any weapon.
Remove it from a tab
Delete its whole entry. Players who wore it play nothing; the choice is not erased, so the effect comes back for them if you add the same id again.
Apply the change
Run /killeffectsadmin reload.
Check that it works#
Run /killeffect: the new name and price show on the effect. Run /killeffect preview <id> to watch it (the preview stage must be set). If the console prints a line starting effects.yml kill_effects.<id>, that entry has a problem and the line says which; everything else still loaded.
Going further#
Add your own effect#
Copy an existing entry, give it a new id and a category that exists, then change its effects list. Each line is a step: a sound, a shape, a delay. The language is in Sequences, or let an assistant write it with Create effects with AI. Then reload and preview it.
The effect id is its permission: GRIDDY is exyliakilleffect.effect.griddy. Ids are lowercased, so case does not matter. Renaming an id renames the permission, and everyone who had the old one loses the effect. Give a whole category with exyliakilleffect.category.<category>, see Permissions.
Change a rarity#
Set tier to a rarity declared under tiers in config.yml (common, rare, epic and legendary by default). It decides the colour and how often the crate lands on it. An entry with no tier is common.
What an effect looks like#
All 110 effects are built on a [RAGDOLL] step: the victim's own body, every joint kept and wearing the colours of their skin, moved frame by frame. In 41 of them a copy of the killer walks in and acts the death out, and in 20 the players watching nearby join in. Everything drawn is display-only: nothing can be hit, looted or collided with.
Technical details: effect keys, weapon families, the catalogue
categories:
meme:
material: JUKEBOX
name: 'Meme'
priority: 1
kill_effects:
GRIDDY:
category: meme
tier: common
name: "<gradient:#B8FF9E:#59A4FF><bold>HIT THE GRIDDY</bold></gradient>"
material: NOTE_BLOCK
description:
- 'Two bars of the griddy, a spin, a dab, and'
- 'then {highlight}the whole dance goes everywhere{neutral}.'
priority: 1
effects:
- '[RAGDOLL] {victim};keys:0.18 up=-0.1 body=20 | 0.22 leg_l=48 … ease=smooth | …'
- '[SOUND] BLOCK_NOTE_BLOCK_BIT;0.8;1.0'
- '[DELAY] 0.28'
- '[PARTICLE] NOTE;count:2;offset:0.7,0.3,0.7;speed:1.0;y:2.3;repeat:8;every:0.22'| Key | What it does |
|---|---|
category | Which tab it appears under. Must be declared under categories. An entry naming an undeclared category is kept (commands and tokens still give it) but has no tab. |
tier | Its rarity: a key under tiers in config.yml. Default common. An undeclared rarity is reported and the effect is treated as the first rarity. |
name | What menus and placeholders call it. |
material | The item the row is drawn with. Default BARRIER. |
description | A list is one line per entry; a single string breaks on <nl>. |
priority | Where it sits in its tab; lower comes first. Default 999. |
effects | The steps drawn where the victim fell. An entry with none draws nothing and is reported. |
weapons | Optional. What the effect may be bound to. Omit it and it fits anything. |
price | Optional. A number in the default currency, or {amount: 50, currency: gems}. A price that is not above zero means not for sale. |
preview-facing | Optional. The side the 3D selector shows it from: AUTO, FRONT, SIDE or degrees. Omit it for the layout's preview.effect-facing. |
A category takes material (default PAPER), name and priority. The id none is reserved and is refused. A missing categories or kill_effects section is reported and that section is dropped; the web editor refuses a save that would lose a section or an entry.
Sound volumes above 1.0 are lowered to 1.0 when the file is read: a higher volume does not play louder, it only widens the radius at which the sound is heard.
Weapon families:
| Family | Matches |
|---|---|
ANY | Anything, including an empty hand. |
SWORD | Every _SWORD. |
AXE | Every _AXE. A pickaxe is not one. |
TRIDENT, MACE, BOW, CROSSBOW | Just that item. |
MELEE | Swords, axes, tridents and maces. |
RANGED | Bows, crossbows and tridents. |
You can also list exact items such as NETHERITE_SWORD. A token that is neither is reported and ignored. Families match on the item's name, so a new sword in a later Minecraft version counts at once. None of the shipped effects declares weapons.
The catalogue#
Thirty effects in Meme and twenty in each of the others, 110 in total. Each carries a tier — see
The crate.
Meme — JUKEBOX
Deaths that know exactly how ridiculous they are.
GRIDDY FLOSS T_POSE HEADSPIN RAGE_QUIT WORSHIP_ME YEET CLOWNED OSCAR_WORTHY EZ
SLAPPED PUNTED BONK CROWD_SURF TOUGH_CROWD NOT_WORTHY PINATA SUPLEX DANCE_OFF
BOWLING SIX_SEVEN PLATE_SMASH ROTTEN_EGG COFFIN_DANCE SKIBIDI METAL_PIPE
TO_BE_CONTINUED EJECTED VINE_BOOM AURA_LOSS
Void — END_PORTAL_FRAME
Taken apart, pulled under, fed to the dark.
NULL_SPACE ABYSS_SWIM UNMADE HUNGRY_DARK POSSESSED ABYSSAL_RITE MARIONETTE SOUL_REAP
EVENT_HORIZON DOPPELGANGER PORTAL_PUSH SOUL_THEFT PHASE_STRIKE DARK_CHOIR
INTO_THE_VOID THE_EYE RIFT SHADOW_PEOPLE REFLECTION VOODOO
Cataclysm — MAGMA_BLOCK
The world itself, arriving all at once.
EARTHQUAKE SINKHOLE SHOCKWAVE THUNDERSTRIKE HOT_FLOOR AVALANCHE ERUPTION TORNADO
METEOR TIDAL_WAVE IMPALED SMITE SIX_FEET_UNDER BODY_SLAM GUILLOTINE ONE_PUNCH
STONE_SPIRE STAMPEDE PYRE CHAINED
Lovestruck — PINK_PETALS
Swoons, serenades and petals: death, but romantic.
LOVE_LETTER BLOWN_KISS CUPIDS_ARROW BLOSSOM_WALTZ LOVE_POTION SWEET_DREAMS SERENADE
HEARTBEAT HEAD_OVER_HEELS LAST_DANCE CHEEK_KISS SAY_YES TANGO BRIDAL_CARRY FAN_CLUB
PILLOW_FIGHT PICNIC_DATE RUNWAY BOUQUET_TOSS CORONATION
Cosmic — NETHER_STAR
Zero gravity, starlight and a sky that answers.
ZERO_GRAVITY SHOOTING_STAR WORMHOLE SPACEWALK MOONWALK ALIEN_ABDUCTION CONSTELLATION
GALAXY_BRAIN SUPERNOVA SOLAR_SYSTEM FALLING_STARS COSMIC_HIGH_FIVE ROCKET_RIDE
GRAVITY_GUN SPACE_CIRCLE ORBITAL_STRIKE GRAVITY_FLIP FLAG_PLANTED TIME_STOP
HEAVENS_LIGHT
Something missing on this page? Tell us on Discord