Effects¶
All 176: 136 triggered and 40 permanent.
Every effect also accepts these optional args: chance (percent), cooldown (seconds, per player), delay (seconds), every (run on every Nth firing), repeat, and target: player|victim where it makes sense.
Economy and experience¶
| effect | what it does | args |
|---|---|---|
give_money |
Give money (Vault or Ember Coins) | amount |
take_money |
Take money | amount |
give_xp |
Give experience points | amount |
take_xp |
Take experience points | amount |
give_xp_levels |
Give XP levels | amount |
take_xp_levels |
Take XP levels | amount |
set_xp_level |
Set XP level | level |
explosion |
Explode at the location (no block damage unless set) | power, break_blocks, fire |
drop_xp_orb |
Drop an XP orb at the location | amount |
set_event_xp |
Set XP dropped by the current break/death event | amount |
multiply_event_xp |
Multiply XP from the current break/death event | multiplier |
Items¶
| effect | what it does | args |
|---|---|---|
give_item |
Give an item | item, amount, name |
take_item |
Remove items from inventory | item, amount |
drop_item |
Drop an item at the location | item, amount |
give_random_item |
Give one random item from a list | items, amount |
repair_item |
Repair the context item (or held item) by an amount, or fully | amount |
damage_item |
Wear down the held item | amount |
consume_held |
Use up one of the held item | - |
multiply_drops |
Multiply the drops of the broken block (drops extra copies) | multiplier |
smelt_drops |
Replace the broken block's drops with their smelted form | - |
telekinesis |
Send the broken block's drops straight to the inventory | - |
Health and status¶
| effect | what it does | args |
|---|---|---|
heal |
Heal the target | amount, target |
damage |
Damage the target (raw, from the player) | amount, target |
damage_percent |
Damage the target by a percentage of its max health | percent, target |
kill |
Kill the target outright | target |
feed |
Restore food | amount |
saturate |
Restore saturation | amount |
starve |
Take food | amount |
set_health |
Set the target's health | health, target |
set_fire |
Set the target on fire (seconds) | seconds, target |
extinguish |
Put out the target | target |
freeze |
Freeze the target (seconds) | seconds, target |
give_air |
Restore breath | amount |
potion_effect |
Apply a potion effect | effect, seconds, level, target |
remove_potion_effect |
Remove a potion effect | effect, target |
clear_potion_effects |
Remove every potion effect | target |
clear_negative_effects |
Remove poison, wither, slowness, weakness, blindness, nausea, hunger, mining fatigue | target |
absorption |
Give absorption hearts | hearts, target |
set_invisible |
Make the target invisible for seconds | seconds, target |
set_glowing |
Make the target glow for seconds | seconds, target |
firework |
Launch a firework at the location | power |
set_event_damage |
Set the damage of the current damage event | damage |
multiply_event_damage |
Multiply the current damage event | multiplier |
firework_custom |
A firework with your colours, shape, fade, trail and flicker | colors, fade, type, power, trail, flicker |
firework_volley |
Several fireworks around the player, spaced out | count, spread, delay, colors, type |
Movement¶
| effect | what it does | args |
|---|---|---|
velocity |
Push the target in its facing direction | strength, vertical, target |
launch_up |
Throw the target upward | strength, target |
knockback |
Knock the victim away from the player | strength, vertical |
pull |
Pull the victim toward the player | strength |
teleport |
Teleport the player to x,y,z (and world) | x, y, z, world, yaw, pitch |
teleport_to_location |
Teleport the player to the context location | - |
teleport_to_victim |
Teleport the player to the victim | - |
teleport_victim_to_player |
Bring the victim to the player | - |
teleport_behind_victim |
Blink behind the victim | - |
teleport_forward |
Blink forward N blocks if the space is clear | distance |
random_teleport |
Teleport within a radius to a safe spot | radius |
set_spawn |
Set the player's respawn point here | - |
allow_flight |
Enable flight for seconds (0 = permanent until removed) | seconds |
dismount |
Dismount the player | - |
spawn_entity |
Spawn an entity at the location | entity, amount |
spawn_guard |
Spawn a mob that attacks the victim | entity, amount, seconds |
spawn_particle |
Spawn particles at the location | particle, amount, spread, speed |
World and blocks¶
| effect | what it does | args |
|---|---|---|
set_block |
Set the context block to a material | block |
break_block |
Break the context block naturally | - |
break_area |
Break every block in a radius around the context block | radius, blocks |
vein_mine |
Break every connected block of the same type | limit |
replant |
Replant the harvested crop | - |
lightning |
Strike lightning at the location | damage |
set_time |
Set the world time | time |
set_weather |
Set the weather: clear, rain, thunder | weather |
remove_entity |
Remove the context entity | - |
ignite_block |
Set the block above the context block on fire | - |
particle_orbit |
Points circling the player at chest height | particle, color, color2, size, seconds, speed, density, period, follow, radius, height, points |
particle_lightning |
A jagged arc from the player to the target or ahead | particle, color, color2, size, seconds, speed, density, period, follow, range |
display_orbit |
Items circling the player, each slowly turning | item, count, scale, glow, radius, height, seconds, speed, period, follow |
display_guard |
Two blades hovering at the shoulders that slash every second | item, count, scale, glow, radius, height, seconds, speed, period, follow |
Feedback¶
| effect | what it does | args |
|---|---|---|
send_message |
Send a chat message | message |
send_actionbar |
Show text above the hotbar | message |
send_title |
Show a title and subtitle | title, subtitle, fade_in, stay, fade_out |
broadcast |
Send a message to everyone | message |
play_sound |
Play a sound to the player | sound, volume, pitch |
play_sound_at |
Play a sound at the location for everyone | sound, volume, pitch |
particle_ring |
A ring of particles around the target | particle, radius, amount |
bossbar |
Show a boss bar for seconds | text, seconds, color |
toast |
Show an advancement-style toast (via title, short) | message |
particle_helix |
One strand spiralling up around the player | particle, color, color2, size, seconds, speed, density, period, follow, radius, height |
particle_double_helix |
Two strands twisting up, DNA style | particle, color, color2, size, seconds, speed, density, period, follow, radius, height |
particle_spiral |
A flat spiral unwinding outward on the ground | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_vortex |
A tornado widening as it rises | particle, color, color2, size, seconds, speed, density, period, follow, radius, height |
particle_sphere |
A slowly turning shell of points around the player | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_dome |
A half sphere resting on the ground | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_cube |
A wireframe cube rotating around the player | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_pulse |
Rings expanding from the feet, again and again | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_shockwave |
A fast ring racing outward with sparks lifting off it, repeating | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_beam |
A column of light rising from the player | particle, color, color2, size, seconds, speed, density, period, follow, height, radius |
particle_laser |
A straight line from the eyes to the target or where the player looks | particle, color, color2, size, seconds, speed, density, period, follow, range |
particle_wings |
A pair of wings on the player's back, flapping gently | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_halo |
A ring hovering above the head | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_crown |
A spiked crown above the head | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_footsteps |
Marks left where the player walks | particle, color, color2, size, seconds, speed, density, period, follow |
particle_trail |
A ribbon following the player's path | particle, color, color2, size, seconds, speed, density, period, follow |
particle_burst |
An explosion of particles flying outward, again every second | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_nova |
A sphere shell expanding outward, repeating | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_fountain |
Particles shooting up and raining back down | particle, color, color2, size, seconds, speed, density, period, follow, height |
particle_rain |
Particles drifting down in a cylinder around the player | particle, color, color2, size, seconds, speed, density, period, follow, radius, height |
particle_star |
A five-point star on the ground, turning | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_heart |
A heart floating in front of the player | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_cage |
Vertical bars around the player | particle, color, color2, size, seconds, speed, density, period, follow, radius, height |
particle_atom |
Three tilted rings orbiting like electrons | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_wave |
A ring that ripples up and down | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_galaxy |
Spiral arms turning slowly on the ground | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_blackhole |
Points spiralling inward and vanishing at the centre | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_twinkle |
Random sparkles around the body | particle, color, color2, size, seconds, speed, density, period, follow, radius, height |
particle_tornado_ground |
A wide, low whirl skimming the ground | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_ring_spin |
A ring of dashes spinning around the waist | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_shield |
A rotating lattice dome that moves with the player | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_clock |
A clock face with a sweeping hand | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_flower |
A rose curve blooming on the ground | particle, color, color2, size, seconds, speed, density, period, follow, radius, petals |
particle_comet |
A glowing head with a tail, circling the player | particle, color, color2, size, seconds, speed, density, period, follow, radius |
particle_preset |
Play a named preset from presets.yml (override any argument) | preset |
Commands and control¶
| effect | what it does | args |
|---|---|---|
run_command |
Run a command as console (%player% available) | command |
run_player_command |
Make the player run a command | command |
run_commands |
Run several console commands | commands |
give_permission |
Grant a permission for seconds (needs a permissions plugin for persistence) | permission, seconds |
cancel_event |
Cancel the event that fired the trigger | - |
set_data |
Store a value in the context for later effects | key, value |
run_chain |
Run a reusable chain from Ember Fx Core's config.yml | chain |
nothing |
Does nothing (a placeholder in chains) | - |
display_blade_storm |
Blades spinning flat around the waist, points outward | item, count, scale, glow, radius, height, seconds, speed, period, follow |
display_halo |
A ring of small items above the head | item, count, scale, glow, radius, height, seconds, speed, period, follow |
display_wings |
Items fanned out behind the back like wings, flapping | item, count, scale, glow, radius, height, seconds, speed, period, follow |
display_spiral |
Items rising in a helix and starting over at the bottom | item, count, scale, glow, radius, height, seconds, speed, period, follow |
display_rain |
Items falling around the player, over and over | item, count, scale, glow, radius, height, seconds, speed, period, follow |
display_shield_wall |
Items standing upright in a slow ring, like a wall of shields | item, count, scale, glow, radius, height, seconds, speed, period, follow |
display_crown |
Items standing up in a ring above the head, turning | item, count, scale, glow, radius, height, seconds, speed, period, follow |
display_tornado |
Items whirling up around the player in a widening cone | item, count, scale, glow, radius, height, seconds, speed, period, follow |
Permanent effects¶
These have no trigger. They stay applied while the effect's conditions hold and are removed when they stop. In Ember Jobs these are the perks.
| effect | what it does | args |
|---|---|---|
permanent_flight |
Allow flight while held | - |
permanent_keep_fed |
Never go hungry while held | - |
permanent_no_fire |
Fire is put out every tick while held | - |
permanent_air |
Never drown while held | - |
bonus_health |
Extra max health (points; 2 = one heart) while held | amount, target |
bonus_health_percent |
Extra max health as a fraction (0.1 = +10%) | amount, target |
bonus_speed |
Extra movement speed as a fraction (0.1 = +10%) | amount, target |
bonus_damage |
Extra attack damage (points) | amount, target |
bonus_damage_percent |
Extra attack damage as a fraction | amount, target |
bonus_armor |
Extra armour points | amount, target |
bonus_toughness |
Extra armour toughness | amount, target |
bonus_knockback_resistance |
Knockback resistance (0-1) | amount, target |
bonus_attack_speed |
Extra attack speed as a fraction | amount, target |
bonus_luck |
Extra luck | amount, target |
bonus_reach |
Extra block reach (blocks) | amount, target |
bonus_entity_reach |
Extra entity reach (blocks) | amount, target |
bonus_mining_speed |
Extra block break speed as a fraction | amount, target |
bonus_jump |
Extra jump strength | amount, target |
bonus_safe_fall |
Extra safe fall distance (blocks) | amount, target |
bonus_scale |
Size multiplier as a fraction (0.2 = 20% bigger) | amount, target |
bonus_step_height |
Extra step height | amount, target |
bonus_gravity |
Gravity multiplier as a fraction (-0.2 = 20% less) | amount, target |
permanent_haste |
Haste while held | level, target |
permanent_speed |
Speed while held | level, target |
permanent_strength |
Strength while held | level, target |
permanent_resistance |
Resistance while held | level, target |
permanent_regeneration |
Regeneration while held | level, target |
permanent_night_vision |
Night vision while held | level, target |
permanent_water_breathing |
Water breathing while held | level, target |
permanent_fire_resistance |
Fire resistance while held | level, target |
permanent_jump_boost |
Jump boost while held | level, target |
permanent_saturation |
Saturation while held | level, target |
permanent_luck |
Luck while held | level, target |
permanent_dolphins_grace |
Dolphin's grace while held | level, target |
permanent_conduit_power |
Conduit power while held | level, target |
permanent_hero_of_the_village |
Hero of the Village while held | level, target |
permanent_slow_falling |
Slow falling while held | level, target |
permanent_invisibility |
Invisibility while held | level, target |
permanent_glowing |
Glowing while held | level, target |
particle_aura |
Any shape, kept running while the holder is active (a perk that glows) | shape, particle, color, color2, size, seconds, speed, density, period |
Attribute effects stack across holders: two jobs each granting bonus_health: 2
give four, and leaving one job removes only its own two.