OrjusDeath 2.0

OrjusDeath is a highly customizable Minecraft plugin that introduces a "downed" state mechanic, similar to modern battle royale games. Instead of dying instantly, players enter a incapacitated state where they can be revived by teammates.

🌟 Key Features

• Downed State: Players fall to the ground instead of dying immediately.
• Crawling Mechanic: Downed players can slowly crawl to safety.
• Revival System: Teammates can revive downed players with a progress-based system.
• Customizable Penalties: Adjust what happens when a player finally dies (item drop, inventory void, armor damage).
• Interactive GUI: Full in-game configuration menu for administrators.
• Visual Effects: Custom particles and screen effects (Darkness/Blindness) in the downed state.
• Advanced Logic: Configure instant death causes (lava, void, etc.) and "overkill" damage thresholds.

🛠 Commands

Command	Description	Aliases
/od gui	Opens the main settings GUI	orjusdeath, revive
/od reload	Reloads the configuration and language files
/od allowcmd <cmd>	Allows a specific command while downed
/od denycmd <cmd>	Denies a specific command while downed

⚙️ Configuration Overview

Spoiler ```

language: ru or en

language: en

General Settings

settings:
down-time: 30 # Time before final death (sec)
suicide-hold-time: 5 # Shift hold time to give up (sec)
health-after-revive: 1.0 # HP after revival (1.0 = 0.5 hearts)
health-while-downed: 6.0 # HP while in downed state
crawl-speed-percent: 30 # Crawl speed (% of normal). 0 = still, 100 = walk.
survive-suicide-chance: 10.0 # Chance (%) to survive when attempting to give up (player stands up instead of dying)
survive-timer-chance: 5.0 # Chance (%) to survive when the downed timer expires (player stands up automatically)
instant-death-overkill: 10.0 # If damage > (hp + this value), player dies instantly
worlds: ["world", "world_nether", "world_the_end"]
allowed-commands: [] # Commands allowed while in downed state

List of death causes that kill instantly (player does not enter downed state)

instant-death-causes:

• LAVA
• VOID
• DROWNING
• SUFFOCATION

Revival Logic

revive-logic:
time-to-revive: 10.0 # Seconds required to revive
reset-on-stop: false # Reset progress if the medic moves away?
regress-speed: 5 # Progress loss speed (% per sec) if not being revived
interrupt-on-damage: false # Interrupt revival if the medic takes damage?
max-distance: 3.0 # Maximum revival distance (blocks)

Inventory Penalties (Applied on final death)

inventory-penalty:
armor-damage-pct: 20 # % of armor durability to lose
void-chance: 10 # Chance to destroy an item (Void)
drop-chance: 40 # Chance to drop an item on the ground (Drop)

Remaining (100 - void - drop) = 50% are kept (Save)

protected-items: # Items that are always kept
- NETHERITE_SWORD
always-drop-items: # Items that always drop
- DIAMOND

Effects (Applied while downed)

effects:
darkness:
enabled: true
type: "DARKNESS" # BLINDNESS or DARKNESS
amplifier: 0 # Effect strength

Particles

particles:
on-down:
type: "BLOCK_CRACK"
data: "REDSTONE_BLOCK"
count: 30
speed: 0.1
on-revive:
type: "VILLAGER_HAPPY"
count: 20
speed: 0.5
on-death:
type: "SMOKE_LARGE"
count: 100
speed: 0.1

</details>
### General Settings
- `down-time`: How many seconds a player stays downed before dying.
- `suicide-hold-time`: How long to hold the Shift key to "give up" and die instantly.
- `crawl-speed-percent`: Controls how fast players can move while downed.
- `survive-timer-chance`: Chance to automatically stand up when the timer expires.

### Revival Logic
- `time-to-revive`: Time required to bring a teammate back to their feet.
- `max-distance`: How far away the "medic" can be from the downed player.
- `regress-speed`: How fast the revival progress is lost if the process is interrupted.

### Inventory Penalties
- `armor-damage-pct`: Percentage of durability lost on armor items upon death.
- `void-chance`: Percentage chance for an item to be completely destroyed.
- `drop-chance`: Percentage chance for an item to drop on the ground.
- `protected-items`: List of items that will never be lost or dropped.

## 🛡 Permissions

- `orjusdeath.admin`: Grants access to all plugin commands and the configuration GUI.

## 🎨 Visuals
The plugin uses:
- **Darkness/Blindness**: To simulate the struggle of being downed.
- **Action Bar**: Displays real-time timers for death and revival progress.
- **Particles**: Customizable effects for falling, being revived, and final death.

---
Developed by **Orjus**