EchoingDeaths.docs
v0.1.0-alpha · Spigot / Paper / Purpur · MC 1.21+

Death leaves a curse behind.

Every player death echoes. EchoingDeaths grips nearby players with temporary debuffs themed by the cause of death: a lava death nauseates witnesses, a void death blinds them, the Warden's sonic boom leaves them in darkness. Fully configurable, Bukkit-only, NMS-free.

0
death curses
0
block curse radius
0
message channels
0
NMS internals
FALLLAVAFIREDROWNINGVOIDMAGICWITHEREXPLOSIONFREEZELIGHTNINGPOISONSTARVATIONSUFFOCATIONSONIC_BOOMTHORNSCONTACT
The curse catalog

One curse for every way to die.

These sixteen curses ship in the default config.yml. Every value, display name, duration, amplifier, potion effects, is yours to change, and any Bukkit damage cause can join the list.

Fall

FALL

The impact lingers: legs heavy, grip gone.

SLOWNESSWEAKNESS
10samp 1lvl 2

Lava

LAVA

The burn spreads as weakness, queasiness and hunger.

WEAKNESSNAUSEAHUNGER
12samp 1lvl 2

Fire

FIRE

Flames hollow out strength and appetite nearby.

WEAKNESSHUNGER
8samp 1lvl 2

Drowning

DROWNING

Waterlogged lungs drag everything around them down.

MINING_FATIGUESLOWNESS
10samp 1lvl 2

Void

VOID

The abyss stares back: light dies with the fallen.

DARKNESSBLINDNESS
8samp 0lvl 1

Magic

MAGIC

Arcane backlash blinds and weakens bystanders.

BLINDNESSWEAKNESS
12samp 1lvl 2

Wither

WITHER

Decay echoes outward, rotting flesh and resolve.

WITHERHUNGER
10samp 1lvl 2

Explosion

EXPLOSION

The shockwave leaves nausea and frailty in its ring.

NAUSEAWEAKNESS
8samp 1lvl 2

Freezing

FREEZE

Cold radiates from the fallen, stiffening every joint.

SLOWNESSWEAKNESS
12samp 1lvl 2

Lightning

LIGHTNING

The charge marks bystanders: glowing, reeling.

GLOWINGNAUSEA
8samp 1lvl 2

Poison

POISON

Venom hangs in the air after a poisoned death.

POISONHUNGER
12samp 1lvl 2

Starvation

STARVATION

The empty stomach of the dead gnaws at the living.

HUNGERWEAKNESS
15samp 0lvl 1

Suffocation

SUFFOCATION

Buried breath returns as darkness and dead weight.

BLINDNESSSLOWNESS
10samp 1lvl 2

Sonic Boom

SONIC_BOOM

The Warden's blast deafens and dims everything near.

DARKNESSWEAKNESS
8samp 1lvl 2

Thorns

THORNS

A pricked death: brief, barbed weakness.

WEAKNESS
6samp 0lvl 1

Sharp Contact

CONTACT

Cactus and berry bush deaths leave a toxic sting.

POISON
6samp 0lvl 1
fallback

Unknown, any death cause without a mapping still curses: weakness, 5s.

Full curse reference →
Mechanics

How a death becomes a curse.

A player dies

EchoingDeaths listens for PlayerDeathEvent and reads the killer's Bukkit damage cause: FALL, LAVA, VOID, whatever finished the job.

The cause picks a curse

The damage-cause name is looked up in config.yml. Any Bukkit DamageCause can be mapped; unmapped causes fall back to a generic curse.

Nearby players are cursed

Everyone in the same world within the configured radius gets the curse's potion effects, plus your chat, actionbar, title and sound feedback.

Quick start

Cursing in three moves.

  1. Drop the jar from Modrinth into your server's /plugins/ folder and restart.
  2. Tune plugins/EchoingDeaths/config.yml: radius, worlds, messages and every curse.
  3. Run /echoingdeaths reload, then /echoingdeaths test LAVA to feel one yourself.
Full installation guide
FIRE:
  display-name: "Fire"
  duration-seconds: 8
  amplifier: 1          # 0 = Level I, 1 = Level II
  potion-effects:
    - WEAKNESS
    - HUNGER

Let every death echo.

Free and open source under the MIT license. Questions? The support Discord and the issue tracker are open.