NetherExile

# NetherExile (Paper 1.21.x) !(https://i.imgur.com/eZPg9yD.png) NetherExile is a Paper plugin that turns death into a temporary "Nether exile". By default, exile starts when a player dies in the Overworld: a lodestone + their head is placed at/near the death location, they respawn in the Nether, and cannot leave until revived (by breaking the lodestone/head marker, by auto-break timeout, or by lava flowing onto the marker). Optionally, if `nethernetherdeath_enabled=true`, exile can also start from a player's first death in the Nether. !(https://i.imgur.com/zw9GYCy.png) ## Features - **Death marker** - Places a **lodestone** and **player head** at the death location. - If the player dies in the air, the marker is placed on the **ground below**. - If the player dies in lava, the marker is placed **on top of the lava surface**. - **Nether exile** - On respawn, the player is teleported to the Nether at the **Overworld-equivalent** location (`x/8`, `z/8`), searching for a safe position and avoiding the Nether roof. - Exiled players cannot leave the Nether (portals are extinguished; teleporting to other dimensions is blocked). - If an exiled player dies in the Nether, they are sent back to their original Nether entry location and shown a "no escape" message (if enabled). - **Nether -> Nether exile (optional)** - If `nethernetherdeath_enabled=true`, a player's first death in the Nether also starts the exile. - Their lodestone/head marker is placed at/near the Nether death location (same air/lava placement rules). - On respawn, they are sent back to where they last entered the Nether via portal (Overworld -> Nether). - **Revival** - Breaking the lodestone or head revives the player. - The breaker receives the dead player's head item. - Lightning strikes the lodestone, and the revived player is struck with lightning on return to the Overworld. - Revived players get **30s Regeneration**. - Anti-grief: if the dead player stayed near their Nether entry point, they are revived ~**100 blocks away** from the original death spot (random direction). - **Marker rules** - Dead players cannot break their own lodestone/head marker to revive themselves. - **Break Lodestone With Arrow (optional)** - If `breakwitharrow_enabled=true`, shooting the lodestone with an arrow can trigger revival. - **World border safety** - Revive teleports are clamped inside the world border and moved to a safe standing spot. - **Auto-break (optional)** - If nobody breaks the marker after a timeout, the plugin auto-breaks it and revives the player. - Timers are based on **in-game time while the player is online** (so logging out does not advance the timer). - Optional **progressive** mode: each new exile can **double** that player's timeout. - **Skeleton mode (optional)** - Dead players spawning in the Nether are equipped with a skeleton skull named with death coords and time. ## Commands All commands are under `/netherexile`. - `/netherexile help` - `/netherexile status` - `/netherexile enable` - `/netherexile disable` - Disabling clears current "dead" state (markers are not removed). - `/netherexile revive <player>` - Revives a currently-dead player (same effect as breaking their marker). - `/netherexile autobreak <status|on|off|set> ` - Duration supports: `s`, `m`, `h`, `d` (examples: `60s`, `30m`, `1h`, `1d`) - `/netherexile progressive <status|on|off|cap> ` - Progressive (doubling) controls, including optional max cap (via `cap`). Only meaningful when auto-break is enabled. - `/netherexile netherpenalty <status|on|off|set|cap> ` - Optional: add time to the remaining auto-break timer when a dead player dies in the Nether. - `/netherexile messages <on|off>` - Toggle player-facing messages (trap/revive/etc). - `/netherexile bedreturn <on|off>` - If enabled, revived players return to their bed/respawn point when available. - `/netherexile skeleton <on|off>` - Toggle skeleton helmet feature. - `/netherexile nethernetherdeath <on|off>` - If enabled, a player's first death in the Nether can start the exile too. - `/netherexile breakwitharrow <on|off>` - If enabled, shooting a lodestone with an arrow can trigger revival. ## Permissions - `netherexile.toggle` (default: op) - `netherexile.revive` (default: op) - `netherexile.autobreak` (default: op) ## Configuration `plugins/NetherExile/config.yml` (defaults are in `src/main/resources/config.yml`): - `netherexile_enabled`: master enable/disable - `messages_enabled`: player-facing messages - `revive_to_bed_enabled`: revive to bed/respawn location if available - `autobreak_enabled`: enable auto-break timeout - `autobreak_after`: base timeout (e.g. `1h`) - `autobreak_progressive_enabled`: double timeout each new exile - `autobreak_progressive_max`: optional max cap for progressive doubling (e.g. `12h`, or `off`) - `nether_death_penalty_enabled`: add time when a dead player dies in the Nether (option