TMDevelopmentTinulica & Maiky

Reactions

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
enabledon / off
typewhat starts it (below)
presetthe preset to play
presetsinstead of preset, for reactions that happen once: one of them at random each time (presets: [a, b, c])
worldsonly in these worlds (empty = everywhere)
permissiononly players with this permission
cooldownreactions that happen once: minimum time between two (40 ticks, 2s, 1m)
once-per-playertrue = plays only once for each player, ever (remembered with the player)
timeday or night: only then (empty = always)
weatherstorm or clear: only while it storms over the world, or while it doesn't (empty = always)
channelplays 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.

TypeOptions
health-belowvalue: 30% or 6 (half hearts)
potioneffects: [poison, wither]
freezingin powder snow
burningon fire, without fire resistance
drowningvalue: 60 (air left, full = 300)
underwaterhead under water
near-entityentities: [warden], radius: 24
near-blockblocks: [lava], radius: 4 (1 - 8)
light-belowvalue: 4 (light level at the eyes)
height-abovevalue: 200 (y of the player)
nighttime 13000 - 23000
stormrain or thunder on the player
full-moonthe night of a full moon, overworld
biomebiomes: [deep_dark]
worldalways true in worlds
holdingitems: [spyglass] (main hand); also nexo:<id>, oraxen:<id>, itemsadder:<namespace>:<id>, craftengine:<namespace>:<id>
wearingitems: [carved_pumpkin] (helmet)
in-blockblocks: [cobweb] (at the feet or the eyes)
placeholderplaceholder: "%vault_eco_balance%", operator: "<", value: "100" (needs PlaceholderAPI)
hungervalue: 6 (food level)
fallingvalue: 8 (blocks fallen)
glidingvalue: 25 (elytra speed, blocks per second)
event-whilefrom one event to another (below)

Once types

The preset plays once.

TypeOptions
damagevalue: 6 (damage of the hit, half hearts); entities: [zombie] (only hits of these mobs, also their arrows), damage-causes: [projectile, fire, fall, magic...]
explosionradius: 16, presets: {6: explosion_close, 16: explosion_far} (by distance), line-of-sight: false
lightningradius: 24
totem, death, respawn, sleep, portal, world-change
killfor the killer; targets: players (default), mobs or all
killstreakvalue: 5 (every 5 kills without dying, for the killer); targets: players (default), mobs or all
joindelay: 10 (ticks after joining), first-join: true (only the very first time on the server)
teleportmin-distance: 32, causes: [command, plugin]
hit-directionvalue: 1 (damage); plays <preset>_front, _back, _left or _right (where the hit came from)
landingvalue: 4 (fall damage)
enderman-starean enderman gets angry at the player
advancementdone (not recipes)
level-upvalue: 5 (every 5 levels, 1 = every level)
healedvalue: 30% or 6 (half hearts): the player heals back over this line (out of low health)
eventany 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
eventthe full class name of the event (see the plugin's API pages)
playerthe method that gives the player: getPlayer, or a chain like getVote.getUsername. Without it getPlayer, getEntity, getDamager, getKiller... are tried
matchonly events whose getter gives one of these values, chains too: match: {getAbility: [berserk]}
audiencewho sees it: self (default), nearby (with radius) or all
requiresthe plugin it needs: when it is missing, the reaction is skipped without a warning
end-eventevent-while: the class of the event that ends it
end-matchevent-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.

PluginReactions
ExcellentCratesexcellentcrates-open (a golden glow when a crate opens), excellentcrates-rare-reward (a jackpot for legendary, mythic and epic rewards, seen by players nearby)
CrazyCratescrazycrates-open, crazycrates-prize (confetti, seen by players nearby)
mcMMOmcmmo-berserk (red rage while Berserk starts), mcmmo-level-up
AuraSkillsauraskills-ability (a rush when a mana ability starts), auraskills-level-up
Citizenscitizens-npc (an effect when a player clicks an NPC; write its name in match)
FancyNpcsfancynpcs-npc (the same)
CombatLogXcombatlogx-tagged (soft red edges while tagged), combatlogx-untagged (relief at the end)
PvPManagerpvpmanager-tagged, pvpmanager-untagged (the same)
NuVotifiervote (a small party on the screen of who votes)
EssentialsXafk (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

Sign in

New here? Just enter your email: the account is created when you click the link. No password needed.

or

We send you a link that signs you in with one click. It works for new and existing accounts.

Sign in with a password instead

By continuing you accept the Terms & Conditions and the Privacy policy.

Staff: open “Sign in with a password instead” and type your username instead of the email. After the password we ask for your 2FA code.