Reactions

Reactions are effects that start by themselves when something happens to a player. They are in reactions.yml; turn them on and off in game with /sfx reactions (click a line) or in the reactions menu.
Default reactions
On by default (19): low-health, poison, wither, nausea, darkness, blindness, freezing, drowning, warden-nearby, heavy-hit, explosion (close / far), lightning, totem, death, respawn, join (a welcome scene only the very first time), teleport, portal, sleep.
Ready to turn on (32): blood-on-hit, kill, killstreak, shot, zombie-bite, hit-direction, on-fire, hungry, falling, hard-landing, fast-flight, enderman-stare, advancement, level-up, enchanting (an event example), blood-moon, rain-on-screen, storm, underwater, deep-dark, nether-heat, end-haze, dark-caves, stuck-in-web, brewery-drunk (BreweryX), desert-heat, sandstorm, cold-night, swamp-fog, high-altitude, near-lava, second-wind.
For other plugins (16): ready reactions for ExcellentCrates, CrazyCrates, mcMMO, AuraSkills, Citizens, FancyNpcs, CombatLogX, PvPManager, NuVotifier and EssentialsX, off by default (see below).
Options every reaction can have
| Option | |
|---|---|
enabled | on / off |
type | what starts it (below) |
preset | the preset to play |
presets | instead of preset, for reactions that happen once: one of them at random each time (presets: [a, b, c]) |
worlds | only in these worlds (empty = everywhere) |
permission | only players with this permission |
cooldown | reactions that happen once: minimum time between two (40 ticks, 2s, 1m) |
once-per-player | true = plays only once for each player, ever (remembered with the player) |
time | day or night: only then (empty = always) |
weather | storm or clear: only while it storms over the world, or while it doesn't (empty = always) |
channel | plays on this channel instead of the preset's own: reactions on different channels show together, on the same channel the stronger preset wins |
settings at the top: skip-gamemodes (no reactions in creative and spectator by default) and disabled-worlds.
While-true types
The preset plays while the condition is true, then stops.
| Type | Options |
|---|---|
health-below | value: 30% or 6 (half hearts) |
potion | effects: [poison, wither] |
freezing | in powder snow |
burning | on fire, without fire resistance |
drowning | value: 60 (air left, full = 300) |
underwater | head under water |
near-entity | entities: [warden], radius: 24 |
near-block | blocks: [lava], radius: 4 (1 - 8) |
light-below | value: 4 (light level at the eyes) |
height-above | value: 200 (y of the player) |
night | time 13000 - 23000 |
storm | rain or thunder on the player |
full-moon | the night of a full moon, overworld |
biome | biomes: [deep_dark] |
world | always true in worlds |
holding | items: [spyglass] (main hand); also nexo:<id>, oraxen:<id>, itemsadder:<namespace>:<id>, craftengine:<namespace>:<id> |
wearing | items: [carved_pumpkin] (helmet) |
in-block | blocks: [cobweb] (at the feet or the eyes) |
placeholder | placeholder: "%vault_eco_balance%", operator: "<", value: "100" (needs PlaceholderAPI) |
hunger | value: 6 (food level) |
falling | value: 8 (blocks fallen) |
gliding | value: 25 (elytra speed, blocks per second) |
event-while | from one event to another (below) |
Once types
The preset plays once.
| Type | Options |
|---|---|
damage | value: 6 (damage of the hit, half hearts); entities: [zombie] (only hits of these mobs, also their arrows), damage-causes: [projectile, fire, fall, magic...] |
explosion | radius: 16, presets: {6: explosion_close, 16: explosion_far} (by distance), line-of-sight: false |
lightning | radius: 24 |
totem, death, respawn, sleep, portal, world-change | |
kill | for the killer; targets: players (default), mobs or all |
killstreak | value: 5 (every 5 kills without dying, for the killer); targets: players (default), mobs or all |
join | delay: 10 (ticks after joining), first-join: true (only the very first time on the server) |
teleport | min-distance: 32, causes: [command, plugin] |
hit-direction | value: 1 (damage); plays <preset>_front, _back, _left or _right (where the hit came from) |
landing | value: 4 (fall damage) |
enderman-stare | an enderman gets angry at the player |
advancement | done (not recipes) |
level-up | value: 5 (every 5 levels, 1 = every level) |
healed | value: 30% or 6 (half hearts): the player heals back over this line (out of low health) |
event | any event of any plugin (below) |
Events of other plugins
type: event plays the preset when an event of any plugin happens. type: event-while keeps it on from one event to another (a combat tag, AFK).
| Option | |
|---|---|
event | the full class name of the event (see the plugin's API pages) |
player | the method that gives the player: getPlayer, or a chain like getVote.getUsername. Without it getPlayer, getEntity, getDamager, getKiller... are tried |
match | only events whose getter gives one of these values, chains too: match: {getAbility: [berserk]} |
audience | who sees it: self (default), nearby (with radius) or all |
requires | the plugin it needs: when it is missing, the reaction is skipped without a warning |
end-event | event-while: the class of the event that ends it |
end-match | event-while: or the same event with other values (AFK on / off) |
An event-while reaction also ends when the player quits.
Ready reactions for other plugins
All off by default: turn on the ones you have. Change match to pick which rewards, abilities or NPCs play them.
| Plugin | Reactions |
|---|---|
| ExcellentCrates | excellentcrates-open (a golden glow when a crate opens), excellentcrates-rare-reward (a jackpot for legendary, mythic and epic rewards, seen by players nearby) |
| CrazyCrates | crazycrates-open, crazycrates-prize (confetti, seen by players nearby) |
| mcMMO | mcmmo-berserk (red rage while Berserk starts), mcmmo-level-up |
| AuraSkills | auraskills-ability (a rush when a mana ability starts), auraskills-level-up |
| Citizens | citizens-npc (an effect when a player clicks an NPC; write its name in match) |
| FancyNpcs | fancynpcs-npc (the same) |
| CombatLogX | combatlogx-tagged (soft red edges while tagged), combatlogx-untagged (relief at the end) |
| PvPManager | pvpmanager-tagged, pvpmanager-untagged (the same) |
| NuVotifier | vote (a small party on the screen of who votes) |
| EssentialsX | afk (the screen slowly darkens while a player is AFK) |
New presets for them: crate_open, combat_tagged, combat_relief, afk_dim (presets/plugins.yml).
Examples
# a zombie bite: only hits of zombies
zombie-bite:
enabled: true
type: damage
value: 1
entities: [zombie, husk, drowned, zombie_villager]
cooldown: 2s
preset: zombie_bite
# random hit effects
hits:
type: damage
value: 4
cooldown: 1s
presets: [hit, blood_splatter, concussion]
# deserts get no rain: a storm blows sand instead, and wins over the other looks of the channel
sandstorm:
type: biome
biomes: [desert, badlands, eroded_badlands, wooded_badlands]
weather: storm
channel: atmosphere
preset: sandstorm
# any event of any plugin
enchanting:
type: event
event: org.bukkit.event.enchantment.EnchantItemEvent
player: getEnchanter
cooldown: 1s
preset: achievement
# mcMMO: only the Berserk ability
mcmmo-berserk:
type: event
requires: mcMMO
event: com.gmail.nossr50.events.skills.abilities.McMMOPlayerAbilityActivateEvent
match:
getAbility: [berserk]
preset: rage
# EssentialsX: from AFK on to AFK off
afk:
type: event-while
requires: Essentials
event: net.ess3.api.events.AfkStatusChangeEvent
player: getAffected.getBase
match:
getValue: [true]
end-match:
getValue: [false]
preset: afk_dim
Strong reactions don't pile up: explosions and lightning play at most every half second for a player, and TNT chains play one effect.
Last updated