SSoggySouls

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

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

Built-in HRM Features

(credits to https://modrinth.com/plugin/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 https://modrinth.com/plugin/hardcore-revive-mod

Craftable Items

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

Check the original page for more details https://modrinth.com/plugin/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

Permissions

License

GPL3