# SSoggySouls<\/p>\n
<\/p>\n
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.<\/p>\n
**Visit wiki for more detailed information: wiki** (wiki is most up to date)<\/p>\n
## How It Works<\/p>\n
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.<\/p>\n
– Players start with configurable lives (default: 2)
\n– Each death costs one life; optional grace period for new players
\n– At 0 lives, dead players enter spectator briefly, then get sent to Limbo
\n– Teammates revive dead players via the ritual structure, `\/revive`, or the Revive Skull
\n– Revived players get sent back to Main automatically
\n– Alive players can visit Limbo with `\/limbo` and return with `\/leavelimbo`<\/p>\n
## Death Modes<\/p>\n
| Mode | Behavior |
\n|——|———-|
\n| **`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. |
\n| **`spectator`** | Dead players stay on Main as spectators permanently until revived. |
\n| **`limbo`** | Dead players are immediately transferred to Limbo. |<\/p>\n
All modes support reviving via the Hardcore Revive Mode, Revive Skull, and `\/revive`.<\/p>\n
## Built-in HRM Features
\n(credits to https:\/\/modrinth.com\/plugin\/hardcore-revive-mod)
\n### Player Head Drops
\nOn final death, the player’s head drops at their death location. They also get a message with their death coords.<\/p>\n
### Revival Ritual Structure
\n3x3x3 structure to revive dead players:<\/p>\n
– **Bottom layer (3×3):** 4 Soul Sand corners, 4 Stair edges, 1 ore block center
\n– **Middle layer:** 4 Wither Roses on the soul sand, 1 Fence on the ore
\n– **Top:** Place the dead player’s head on the fence<\/p>\n
**Check the original page for more details https:\/\/modrinth.com\/plugin\/hardcore-revive-mod**<\/p>\n
### Craftable Items<\/p>\n
**Revive Skull** Right-click to open a menu of dead players and receive their head for the ritual.<\/p>\n
| | | |
\n|—|—|—|
\n| Obsidian | Ghast Tear | Obsidian |
\n| Totem of Undying | Any Skull | Totem of Undying |
\n| Obsidian | Ghast Tear | Obsidian |<\/p>\n
**Check the original page for more details https:\/\/modrinth.com\/plugin\/hardcore-revive-mod**<\/p>\n
**Extra Life** Right-click to gain +1 life. Recipe is fully configurable in `config.yml` (only on main).<\/p>\n
### “Limbo” Visiting
\nAlive players can visit Limbo using `\/limbo` to interact with dead players. Use `\/leavelimbo` to return. Dead players cannot leave until revived.<\/p>\n
## Requirements<\/p>\n
– Minecraft 1.21.X (Spigot or Paper)
\n– Velocity proxy
\n– MySQL database (you can share one with another plugin like CoreProtect)
\n– Java 21+
\n– Two backend servers: Main + “Limbo” (Limbo optional in `spectator` mode)<\/p>\n
> **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.<\/p>\n
## Proxy \/ Backend installation<\/p>\n
– Do NOT install PolarSouls on your proxy (Velocity\/BungeeCord\/Waterfall). Install the plugin only on your backend Spigot\/Paper\/Purpur servers (Main and Limbo).
\n– Ensure the proxy forwards player information to the backends so UUIDs and addresses remain consistent:
\n – Velocity: set `player-info-forwarding-mode: MODERN` in `velocity.toml`.
\n – BungeeCord\/Waterfall: enable IP forwarding and set the appropriate `bungeecord`\/proxy options in `spigot.yml`\/`paper.yml`.
\n– Make sure both backend servers can reach the shared MySQL database and any messaging channels you use.
\n– After configuring forwarding, test a full flow: death on Main \u2192 transfer to Limbo \u2192 revive and return to Main.
\n(might work on BungeeCord\/Waterfall, not tetsted yet, if you manage to test it out, please make a issue in GitHub)<\/p>\n
## Installation<\/p>\n
1. Place `SSoggySouls-X.X.X.jar` in the `plugins\/` folder of **both** servers
\n2. Start both servers to generate `config.yml`
\n3. Configure the MySQL database connection (same credentials on both)
\n4. On the Limbo server, set `is-limbo-server: true`
\n5. Set the spawn in-game with `\/setlimbospawn`
\n6. 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.
\n7. Restart both servers<\/p>\n
## Configuration<\/p>\n
See the generated `config.yml` for all options. Key settings:<\/p>\n
“`yaml
\nis-limbo-server: false # true on Limbo server only<\/p>\n
database:
\n host: localhost
\n port: 3306
\n name: polarsouls
\n username: root
\n password: password<\/p>\n
lives:
\n default: 2
\n max-lives: 5
\n on-revive: 1
\n grace-period-hours: 24
\n revive-cooldown-seconds: 30<\/p>\n
main:
\n death-mode: “hybrid” # hybrid | spectator | limbo
\n hybrid-timeout-seconds: 300<\/p>\n
hrm:
\n enabled: true
\n drop-heads: true
\n structure-revive: true
\n head-wearing-effects: true
\n revive-skull-recipe: true<\/p>\n
extra-life:
\n enabled: true
\n recipe:
\n row1: “DED”
\n row2: “INI”
\n row3: “GEG”
\n # Letter-to-material mapping
\n ingredients:
\n G: “GOLD_BLOCK”
\n E: “EMERALD_BLOCK”
\n N: “NETHER_STAR”
\n D: “DIAMOND_BLOCK”
\n I: “NETHERITE_INGOT”
\n“`
\n*(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)*
\n“`
\nmain-server-name: “main”
\nlimbo-server-name: “limbo”
\n“`
\n*(change this to the names that are in velocity.toml)*<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | ## Permissions<\/p>\n | Permission | Description | Default | ## License<\/p>\n GPL3<\/p>\n","protected":false},"excerpt":{"rendered":" Plugin that improves Hardcore experience in various ways (cross server, lives, reviving)<\/p>\n","protected":false},"featured_media":147669,"template":"","meta":{"_minecraft_slug":"ssoggysouls-for-hardcore","_minecraft_project_id":"Pb03qu6T","_minecraft_author":"ssoggytacoman","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":291,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ssoggysouls-for-hardcore.zip","_minecraft_size_bytes":1385228915,"_minecraft_version_count":207,"_minecraft_updated_at":"2026-05-15T19:54:03.153742Z","_minecraft_date_created":"2026-02-10T00:56:31.606040Z","_minecraft_date_modified":"2026-05-14T17:10:42.147880Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ssoggysouls-for-hardcore","_minecraft_icon_attachment_id":147669,"_minecraft_imported_at":"2026-06-08T20:42:27+00:00","_minecraft_import_hash":"3e184ddae466b5b3af4df6fd82aa58fc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,97,104,89,126,158,127,128,98,129,123,92],"mod_loader":[130,99,106,160,132,133,100,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-147668","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-management","mod_category-neoforge","mod_category-paper","mod_category-purpur","mod_category-quilt","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-paper","mod_loader-purpur","mod_loader-quilt","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/psadmin [args]` | Admin commands (lives, grace, kill, revive, reset, info, reload) | `polarsouls.admin` |
\n| `\/revive
\n| `\/pstatus [player]` | Check lives and status | `polarsouls.status` |
\n| `\/psetlives
\n| `\/setlimbospawn` | Set the Limbo spawn point | `polarsouls.admin` |
\n| `\/limbo` | Visit the Limbo server | `polarsouls.visit` |
\n| `\/leavelimbo` | Return from Limbo to Main | `polarsouls.visit` |<\/p>\n
\n|————|————-|———|
\n| `polarsouls.admin` | Full admin access | op |
\n| `polarsouls.revive` | Can revive dead players | op |
\n| `polarsouls.status` | Can check player status | true |
\n| `polarsouls.visit` | Can visit Limbo as a living player | true |
\n| `polarsouls.bypass` | Bypass all death mechanics | false |<\/p>\n