OrjusDeath

---

# ⚔️ 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!**

---