---

# ⚔️ OrjusDeath – Downed & Revive System

**OrjusDeath** replaces the standard Minecraft death mechanic with a fully customizable **downed state system**.
Instead of dying instantly, players fall into a **“downed” state** where they must wait for teammates to revive them.
If no one helps before the timer runs out – the player dies as usual.

This plugin brings **teamwork, immersion, and exciting last-minute rescues** to survival, PvP, and RPG servers.

---

### ✨ Features

* Players enter a **downed state** instead of dying instantly.
* **Configurable timer** for how long a player can stay downed.
* **Revival system** – teammates can revive each other.
* **Custom messages** for downed, revived, and final death states.
* **Easy configuration** through `config.yml`.
* **Admin commands** for reloading and control.

---

### 📝 Commands

* `/orjusdeath reload` – reloads the configuration.

---

### 🔑 Permissions

* `orjusdeath.admin` – access to admin commands.

---

<details>
<summary>Spoiler</summary>

```
# Orjusdeath config

settings:
# Number of seconds a player stays in the "downed" state before final death
downed_duration_seconds: 30

# Number of seconds a rescuer must hold SHIFT + right-click to revive
revive_time_seconds: 5

# Maximum distance to the target for revival (in blocks)
revive_distance: 3.0

# Chances during the first "death"
# First, instant_death_chance is checked → if it fails, instant_heal_chance is checked
instant_death_chance: 0.05 # 0.0..1.0 — chance to die instantly
instant_heal_chance: 0.05 # 0.0..1.0 — chance to instantly recover

# Chance to survive at the end of the downed phase (instead of dying)
survive_after_downed_chance: 0.20

# Surrender (suicide) by holding SHIFT while in the downed state
surrender_enabled: true
surrender_hold_seconds: 3

effects:
particles:
enabled: true # enable/disable particle "burst" when entering the downed state
type: "SMOKE" # particle name (org.bukkit.Particle), e.g. SMOKE_NORMAL, HEART, CAMPFIRE_COSY_SMOKE, CRIT, FLAME
count: 40 # number of particles per burst
radius: 0.6 # horizontal spread (X/Z); Y spread is 0.15
speed: 0.01 # extra/speed value for spawnParticle
repeats: 3 # number of bursts in a row
repeat_interval_ticks: 5 # interval between bursts (in ticks)

messages:
# Downed state / death
downed_start: "§cYou are downed! You have {time}s to be rescued."
actionbar_downed: "§eTime to death: §6{mmss} §7(crawling)"
death_title: "§cYou died"
death_subtitle: "§7No one saved you"
#death_chat: "§7{player} §cdied. §7No one saved them."
survive_after: "§aYou miraculously came back to life!"

# Revival
revive_start_rescuer: "§aStarted reviving §f{target}§a. Keep aiming and hold §eSHIFT§a for {seconds}s."
revive_start_target: "§e{rescuer} §7is trying to revive you..."
revive_cancel_shift: "§7Revival cancelled: you released §eSHIFT§7."
revive_cancel_distance: "§7Revival cancelled: too far or no line of sight."
revive_cancel_not_downed: "§7Revival cancelled: target is no longer downed."
revive_success_rescuer: "§aYou successfully revived §f{target}§a!"
revive_success_target: "§aYou were revived by §f{rescuer}§a."
revive_self: "§7You cannot revive yourself."
revive_not_needed: "§7This player does not need revival."
revive_need_shift: "§7Hold §eSHIFT§7 and right-click the player to start revival."

# Surrender (suicide)
surrender_start: "§7Hold §eSHIFT§7 for {seconds}s to surrender."
surrender_cancel: "§7Surrender cancelled."
surrender_progress: "§cSurrender: §6{percent}%"
surrender_done: "§7You surrendered."

# Outcomes from the first "death"
instant_death: "§7Instant death chance triggered."
instant_heal: "§aLucky you! You instantly recovered."

# Miscellaneous
commands_blocked: "§7You are downed and cannot use commands."
reload_ok: "§aOrjusdeath: config reloaded successfully."
reload_fail: "§cOrjusdeath: error reloading config."

```

</details>

---

👉 With **OrjusDeath**, death is no longer the end – it becomes a chance for **teamwork, strategy, and epic comebacks!**

---