SSoggySouls

!Artwork

Spigot/Paper/Purpur plugin for Minecraft 1.21.1 that adds a lives system to a Velocity proxy network. When players lose all their lives, they get sent to a Limbo server until teammates revive them.

Visit wiki for more detailed information: wiki (wiki is most up to date)

How It Works

The plugin runs on two backend servers behind a Velocity (might work on BungeeCord/Waterfall, not tetsted yet, if you manage to test it out, please make a issue in GitHub) proxy: Main (survival) and Limbo (purgatory). Both share a MySQL database.

• Players start with configurable lives (default: 2)
• Each death costs one life; optional grace period for new players
• At 0 lives, dead players enter spectator briefly, then get sent to Limbo
• Teammates revive dead players via the ritual structure, /revive, or the Revive Skull
• Revived players get sent back to Main automatically
• Alive players can visit Limbo with /limbo and return with /leavelimbo

Death Modes

Mode	Behavior
hybrid (default)	Spectator for a time window, then transferred to Limbo. Teammates can revive during the window. Reconnecting while dead skips the spectator window and sends straight to Limbo.
spectator	Dead players stay on Main as spectators permanently until revived.
limbo	Dead players are immediately transferred to Limbo.

All modes support reviving via the Hardcore Revive Mode, Revive Skull, and /revive.

Built-in HRM Features

(credits to /plugins/hardcore-revive-mod)

Player Head Drops

On final death, the player's head drops at their death location. They also get a message with their death coords.

Revival Ritual Structure

3x3x3 structure to revive dead players:

• Bottom layer (3x3): 4 Soul Sand corners, 4 Stair edges, 1 ore block center

• Middle layer: 4 Wither Roses on the soul sand, 1 Fence on the ore

• Top: Place the dead player's head on the fence

  Check the original page for more details /plugins/hardcore-revive-mod

Craftable Items

Revive Skull Right-click to open a menu of dead players and receive their head for the ritual.

Obsidian	Ghast Tear	Obsidian
Totem of Undying	Any Skull	Totem of Undying
Obsidian	Ghast Tear	Obsidian

Check the original page for more details /plugins/hardcore-revive-mod

Extra Life Right-click to gain +1 life. Recipe is fully configurable in config.yml (only on main).

"Limbo" Visiting

Alive players can visit Limbo using /limbo to interact with dead players. Use /leavelimbo to return. Dead players cannot leave until revived.

Requirements

• Minecraft 1.21.X (Spigot or Paper)
• Velocity proxy
• MySQL database (you can share one with another plugin like CoreProtect)
• Java 21+
• Two backend servers: Main + "Limbo" (Limbo optional in spectator mode)

Note: You do not need hardcore=true in server.properties. Leave it as false on both servers. If you do have it enabled, the plugin will NOT work.

Proxy / Backend installation

• Do NOT install PolarSouls on your proxy (Velocity/BungeeCord/Waterfall). Install the plugin only on your backend Spigot/Paper/Purpur servers (Main and Limbo).
• Ensure the proxy forwards player information to the backends so UUIDs and addresses remain consistent:
  • Velocity: set player-info-forwarding-mode: MODERN in velocity.toml.
  • BungeeCord/Waterfall: enable IP forwarding and set the appropriate bungeecord/proxy options in spigot.yml/paper.yml.
• Make sure both backend servers can reach the shared MySQL database and any messaging channels you use.
• After configuring forwarding, test a full flow: death on Main → transfer to Limbo → revive and return to Main. (might work on BungeeCord/Waterfall, not tetsted yet, if you manage to test it out, please make a issue in GitHub)

Installation

1. Place SSoggySouls-X.X.X.jar in the plugins/ folder of both servers
2. Start both servers to generate config.yml
3. Configure the MySQL database connection (same credentials on both)
4. On the Limbo server, set is-limbo-server: true
5. Set the spawn in-game with /setlimbospawn
6. Configure the rest in the config.yml, the guide in the config is pretty simple, so just follow it. If you need help, feel free to reach out in GitHub.
7. Restart both servers

Configuration

See the generated config.yml for all options. Key settings:

is-limbo-server: false           # true on Limbo server only

database:
  host: localhost
  port: 3306
  name: polarsouls
  username: root
  password: password

lives:
  default: 2
  max-lives: 5
  on-revive: 1
  grace-period-hours: 24
  revive-cooldown-seconds: 30

main:
  death-mode: "hybrid"           # hybrid | spectator | limbo
  hybrid-timeout-seconds: 300

hrm:
  enabled: true
  drop-heads: true
  structure-revive: true
  head-wearing-effects: true
  revive-skull-recipe: true

extra-life:
  enabled: true
    recipe:
    row1: "DED"
    row2: "INI"
    row3: "GEG"
    # Letter-to-material mapping
    ingredients:
      G: "GOLD_BLOCK"
      E: "EMERALD_BLOCK"
      N: "NETHER_STAR"
      D: "DIAMOND_BLOCK"
      I: "NETHERITE_INGOT"

(to edit this, change one of the letters in the rows to another one, and set the block for that letter under ingredients. A customized example is shown above)

main-server-name: "main"
limbo-server-name: "limbo"

(change this to the names that are in velocity.toml)

Commands

Command	Description	Permission
/psadmin <sub> [args]	Admin commands (lives, grace, kill, revive, reset, info, reload)	polarsouls.admin
/revive <player>	Revive a dead player	polarsouls.revive
/pstatus [player]	Check lives and status	polarsouls.status
/psetlives <player> <n>	Set a player's lives	polarsouls.admin
/setlimbospawn	Set the Limbo spawn point	polarsouls.admin
/limbo	Visit the Limbo server	polarsouls.visit
/leavelimbo	Return from Limbo to Main	polarsouls.visit

Permissions

Permission	Description	Default
polarsouls.admin	Full admin access	op
polarsouls.revive	Can revive dead players	op
polarsouls.status	Can check player status	true
polarsouls.visit	Can visit Limbo as a living player	true
polarsouls.bypass	Bypass all death mechanics	false

License

GPL3