# NetherExile (Paper 1.21.x)<\/p>\n
<\/p>\n
NetherExile is a Paper plugin that turns death into a temporary “Nether exile”.<\/p>\n
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).<\/p>\n
Optionally, if `nethernetherdeath_enabled=true`, exile can also start from a player’s first death in the Nether.<\/p>\n
<\/p>\n
## Features<\/p>\n
– **Death marker**
\n – Places a **lodestone** and **player head** at the death location.
\n – If the player dies in the air, the marker is placed on the **ground below**.
\n – If the player dies in lava, the marker is placed **on top of the lava surface**.
\n– **Nether exile**
\n – 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.
\n – Exiled players cannot leave the Nether (portals are extinguished; teleporting to other dimensions is blocked).
\n – 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).
\n– **Nether -> Nether exile (optional)**
\n – If `nethernetherdeath_enabled=true`, a player’s first death in the Nether also starts the exile.
\n – Their lodestone\/head marker is placed at\/near the Nether death location (same air\/lava placement rules).
\n – On respawn, they are sent back to where they last entered the Nether via portal (Overworld -> Nether).
\n– **Revival**
\n – Breaking the lodestone or head revives the player.
\n – The breaker receives the dead player’s head item.
\n – Lightning strikes the lodestone, and the revived player is struck with lightning on return to the Overworld.
\n – Revived players get **30s Regeneration**.
\n – 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).
\n– **Marker rules**
\n – Dead players cannot break their own lodestone\/head marker to revive themselves.
\n– **Break Lodestone With Arrow (optional)**
\n – If `breakwitharrow_enabled=true`, shooting the lodestone with an arrow can trigger revival.
\n– **World border safety**
\n – Revive teleports are clamped inside the world border and moved to a safe standing spot.
\n– **Auto-break (optional)**
\n – If nobody breaks the marker after a timeout, the plugin auto-breaks it and revives the player.
\n – Timers are based on **in-game time while the player is online** (so logging out does not advance the timer).
\n – Optional **progressive** mode: each new exile can **double** that player’s timeout.
\n– **Skeleton mode (optional)**
\n – Dead players spawning in the Nether are equipped with a skeleton skull named with death coords and time.<\/p>\n
## Commands<\/p>\n
All commands are under `\/netherexile`.<\/p>\n
– `\/netherexile help` ## Permissions<\/p>\n – `netherexile.toggle` (default: op) ## Configuration<\/p>\n `plugins\/NetherExile\/config.yml` (defaults are in `src\/main\/resources\/config.yml`):<\/p>\n – `netherexile_enabled`: master enable\/disable ## Data files<\/p>\n In `plugins\/NetherExile\/`:<\/p>\n – `dead.yml`: current exiled player state (marker locations, nether entry, etc.) ## Install<\/p>\n 1. Put the jar into your server’s `plugins\/` folder. ## Notes \/ Known behavior<\/p>\n – Marker placement replaces blocks where it is placed (for lava deaths it places above lava rather than replacing lava). Exile players to the Nether on death by creating a lodestone\/head marker at their death spot and blocking Nether escape until they\u2019re revived. It includes configurable revival rules, timed auto-revive options, anti-grief\/safe-teleport protections etc.<\/p>\n","protected":false},"featured_media":109869,"template":"","meta":{"_minecraft_slug":"netherexile","_minecraft_project_id":"tB9kGJOT","_minecraft_author":"cev-api","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":31,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"netherexile.zip","_minecraft_size_bytes":50543,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:01:08.018485Z","_minecraft_date_created":"2026-02-12T01:24:10.230958Z","_minecraft_date_modified":"2026-04-17T09:29:47.824388Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/netherexile","_minecraft_icon_attachment_id":109869,"_minecraft_imported_at":"2026-06-06T10:58:58+00:00","_minecraft_import_hash":"7cc35f923c37bc14229687cf6966854a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-109868","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/netherexile status`
\n– `\/netherexile enable`
\n– `\/netherexile disable`
\n – Disabling clears current “dead” state (markers are not removed).
\n– `\/netherexile revive
\n – Revives a currently-dead player (same effect as breaking their marker).
\n– `\/netherexile autobreak
\n – Duration supports: `s`, `m`, `h`, `d` (examples: `60s`, `30m`, `1h`, `1d`)
\n– `\/netherexile progressive
\n – Progressive (doubling) controls, including optional max cap (via `cap`). Only meaningful when auto-break is enabled.
\n– `\/netherexile netherpenalty
\n – Optional: add time to the remaining auto-break timer when a dead player dies in the Nether.
\n– `\/netherexile messages
\n – Toggle player-facing messages (trap\/revive\/etc).
\n– `\/netherexile bedreturn
\n – If enabled, revived players return to their bed\/respawn point when available.
\n– `\/netherexile skeleton
\n – Toggle skeleton helmet feature.
\n– `\/netherexile nethernetherdeath
\n – If enabled, a player’s first death in the Nether can start the exile too.
\n– `\/netherexile breakwitharrow
\n – If enabled, shooting a lodestone with an arrow can trigger revival.<\/p>\n
\n– `netherexile.revive` (default: op)
\n– `netherexile.autobreak` (default: op)<\/p>\n
\n– `messages_enabled`: player-facing messages
\n– `revive_to_bed_enabled`: revive to bed\/respawn location if available
\n– `autobreak_enabled`: enable auto-break timeout
\n– `autobreak_after`: base timeout (e.g. `1h`)
\n– `autobreak_progressive_enabled`: double timeout each new exile
\n– `autobreak_progressive_max`: optional max cap for progressive doubling (e.g. `12h`, or `off`)
\n– `nether_death_penalty_enabled`: add time when a dead player dies in the Nether (optional)
\n– `nether_death_penalty`: how much time to add per Nether death (e.g. `5m`)
\n– `nether_death_max_remaining`: cap on remaining time after penalties (e.g. `6h`, or `off`)
\n– `skeleton_enabled`: equip skeleton skull in Nether for dead players
\n– `nethernetherdeath_enabled`: start exile on first Nether death too
\n– `breakwitharrow_enabled`: allow breaking lodestone by shooting it with an arrow
\n– `near_entry_threshold_blocks`: controls anti-grief “revive 100 blocks away” behavior
\n– `revive_offset_blocks`: the revive offset distance when near-entry
\n– `regen_seconds`, `regen_amplifier`: revival buff
\n– `portal_extinguish_radius`: how far to search around a dead player for a portal block to extinguish
\n– `portal_extinguish_max_blocks`: max connected portal blocks to remove (safety cap)<\/p>\n
\n– `history.yml`: per-player progressive timeout history (used when `autobreak_progressive_enabled=true`)
\n– `entries.yml`: last known Nether portal entry locations (used by `nethernetherdeath_enabled`)<\/p>\n
\n2. Start the server once to generate `plugins\/NetherExile\/config.yml`.
\n3. Configure as desired and restart\/reload.<\/p>\n
\n– Auto-break countdown only progresses while the dead player is online (in-game time).
\n– If your server runs in offline mode, player skin rendering for heads may be inconsistent depending on client\/cache behavior.<\/p>\n","protected":false},"excerpt":{"rendered":"