Home

SimpleRevive Wiki

SimpleRevive replaces instant death with a downed-player system. When a player receives fatal damage, they are knocked down for a limited amount of time and can be revived, carried, or looted by other players.

Compatibility

SimpleRevive supports:

• Spigot

• Paper

• Purpur

• Folia

• Minecraft 1.21.x, 26.1.x, and 26.2

ProtocolLib is required on Spigot to correctly synchronize the downed-player animation. It is optional on Paper, Purpur, and Folia.

Installation

1. Download SimpleRevive.

2. Install ProtocolLib if your server requires it.

3. Place the plugin .jar files inside your server's plugins folder.

4. Restart the server.

5. Edit the configuration file located at:

plugins/SimpleRevive/config.yml

How It Works

When a player receives fatal damage:

1. The player enters the downed state.

2. The bleedout timer begins.

3. Another player can revive them by crouching nearby.

4. The downed player can also be carried or looted, depending on the server configuration.

5. If the timer expires, the player dies.

6. The downed player can hold Shift to surrender before the timer ends.

While downed, certain actions such as using commands, sprinting, placing blocks, or breaking blocks may be restricted.

Controls

Reviving a Player

Crouch near a downed player and remain within the configured revive radius.

By default, reviving takes 7 seconds and requires players to stay within 2.5 blocks.

Looting a Player

Right-click a downed player to open their inventory.

The downed player's personal inventory protection may prevent looting, depending on the server configuration.

Carrying a Player

Use Shift + Right-click on a downed player to carry them.

Press Shift again to drop the player.

Surrendering

While downed, hold the Shift key.

By default, Shift must be held for 2 seconds.

Main Settings

bleedout-seconds: 60
revive-seconds: 7
revive-radius: 2.5
surrender-hold-seconds: 2

Setting | Description -- | -- bleedout-seconds | Time before a downed player dies. revive-seconds | Time required to complete a revive. revive-radius | Maximum distance allowed during a revive. surrender-hold-seconds | Time the player must hold Shift to surrender.

Messages

All plugin messages can be customized inside the following section:

messages:

Color codes using & are supported.

Depending on the message, the following placeholders may be available:

• %player%

• %seconds%

• %progress%

• %status%

After editing the configuration, restart the server to ensure all changes are applied correctly.