<div align="center"> <h1>❤️ NexusRevive</h1> <h3>Modern downed and revive system for Paper servers</h3> <b>Version:</b> 1.0.1 | <b>Compatibility:</b> 1.19.4 to 26.1+ (and forks) <p><a href="https://discord.gg/WHBWBWWYDq">🎮 Support Discord</a></p> </div> --- **NexusRevive** replaces instant death with a full **downed system** built for modern survival and PvP servers. Down players instead of killing them, carry them to safety, revive them manually or automatically inside zones, track them with a configurable GPS, and fully customize the experience with `config.yml`, `messages.yml`, and `gps.yml`. --- ## Screenshots <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/1Te3IJY0Rvk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> <details> <summary>Player Downed</summary> !(https://cdn.modrinth.com/data/cached_images/f90e18f5ed2c5c16ada289914b08ae3acca9b2c1.png) </details> <details> <summary>GPS</summary> !(https://cdn.modrinth.com/data/cached_images/b96ad973684bfd62684e46aa6c1e2e646cdf9c89.png) </details> <details> <summary>Carry</summary> !(https://cdn.modrinth.com/data/cached_images/d0777d0401f9ff68ad2d218142b666293d714918.png) </details> <details> <summary>loot player downed</summary> !(https://cdn.modrinth.com/data/cached_images/78f1516b511e38fd6ab0c2b4a98b6db7c00a3316_0.webp) </details> --- ## Main Features ### Downed State - Players fall into a downed state instead of dying instantly - Custom downed pose with real `1.21.x` NMS support - Death timer, invulnerability window, actionbar, scoreboard, and sounds - Configurable potion effects while downed, including effects like `DARKNESS` ### Manual Revive and Carry - Revive by holding `shift` near the downed player - Carry downed players on your head and move them to safer locations - Prevent reviving while carrying - Optional item requirement to revive ### Auto-Revive Zones - Create revive zones with `/nr zone wand` - Auto-revive players when they are inside a zone - Zone speed multipliers - Visual finish effect when auto-revive completes ### GPS System - Track downed players from a GUI menu - GPS display modes: - `BOSSBAR` - `ACTIONBAR` - `HOLOGRAM` - `BOSSBAR_AND_HOLOGRAM` - Configurable arrows, distance display, and hologram behavior ### Safe Loot System - Open a controlled loot menu with `shift + right click` - Loot inventory, armor, and offhand - Session locking to reduce desync and duplication risk - Closes automatically if the target revives, dies, disconnects, or changes state ### Hooks and Integrations - `Vault` - `WorldGuard` - `DeluxeCombat` - `PlaceholderAPI` --- ## WorldGuard Flags - `nexus-revive` - controls reviving - `nexus-revive-carry` - controls carrying - `nexus-revive-loot` - controls looting Example: ```text /rg flag hospital nexus-revive allow /rg flag warzone nexus-revive-carry deny /rg flag spawn nexus-revive-loot deny ``` --- ## Commands and Permissions **Main Command:** - `/nexusrevive` - `/nr` (alias) **Commands:** - `/nr reload` - Reload config, messages, gps, and zones (`nexusrevive.command.reload`) - `/nr down <player>` - Force the downed state (`nexusrevive.command.down`) - `/nr revive <player>` - Revive a downed player (`nexusrevive.command.revive`) - `/nr kill <player>` - Permanently kill a downed player (`nexusrevive.command.kill`) - `/nr gps` - Open the downed player tracker (`nexusrevive.command.gps`) - `/nr zone wand` - Get the zone wand (`nexusrevive.command.zone`) - `/nr zone create <name>` - Create a revive zone from your selection (`nexusrevive.command.zone`) - `/nr zone remove <name>` - Remove a revive zone (`nexusrevive.command.zone`) - `/nr zone list` - List revive zones (`nexusrevive.command.zone`) - `/nr zone speed <name> <multiplier>` - Change zone revive speed (`nexusrevive.command.zone`) **Player Permissions:** - `nexusrevive.revivable` - `nexusrevive.reviver` - `nexusrevive.pickable` - `nexusrevive.picker` - `nexusrevive.lootable` - `nexusrevive.robber` - `nexusrevive.downable` --- ## PlaceholderAPI Identifier: ```text %nexusrevive_<placeholder>% ``` Available placeholders include: - `status` - `death_delay` - `invulnerability` - `reviver` - `picker` - `attacker` - `victim` - `progress` - `auto_revive_zone` - `in_auto_revive_zone` - `auto_reviving` - `death_delay_bar` - `invulnerability_bar` - `progress_bar` --- ## API and Events Main API class: ```java com.aquiles.nexusrevive.api.NexusReviveAPI ``` Useful methods: ```java NexusReviveAPI.isAvailable(); NexusReviveAPI.isDowned(player); NexusReviveAPI.isReviving(player); NexusReviveAPI.getDownedPlayer(player); NexusReviveAPI.getReviveVictim(player); NexusReviveAPI.getDownedPlayers(); NexusReviveAPI.revivePlayer(player); NexusReviveAPI.revivePlayer(player, reviver); NexusReviveAPI.killDowned(player); Nexus