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 <details> <summary>Spoiler</summary> ``` # 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: 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**