
OrjusDeath
The plugin adds a downed state mechanic, allowing teammates to revive players within a set time instead of dying instantly.
📖About OrjusDeath
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**