# Death Swap Plus<\/p>\n
A DeathSwap minigame plugin for Minecraft **1.21**.<\/p>\n
In DeathSwap, everyone plays in survival and the plugin will periodically **swap players\u2019 positions**. Your goal is to **make other players die** (traps, lava, fall damage, mobs, etc.).
\nIf you die, you become a **spectator**.
\n**Last player alive wins.**<\/p>\n
—<\/p>\n
## Quick Start<\/p>\n
1. Put the plugin jar into your server\u2019s `plugins\/` folder.
\n2. Start the server once (this creates `plugins\/DeathSwap\/config.yml`).
\n3. (Optional) Configure the plugin with `\/dssettings`.
\n4. Start a game:
\n – **Ready-up start (recommended):** everyone runs `\/dsready`, then someone runs `\/dsready start`
\n – **Admin start:** `\/dsstart`<\/p>\n
—<\/p>\n
## How The Game Works<\/p>\n
– When a game starts, all online players are put into **SURVIVAL** and added to the match.
\n– Players get optional starting items:
\n – `GiveFood=true` \u2192 **20 cooked porkchops**
\n – `GiveWaterBucket=true` \u2192 **1 water bucket**
\n– The plugin shows **health in the TAB list** (scoreboard objective `showhealth`).
\n– Swaps happen after a random delay between `MinTimer` and `MaxTimer` (ticks).
\n– A big title warning **always** appears **10 seconds** before a swap (200 ticks):
\n **\u201cSWAP INCOMING!\u201d**
\n– During the match, eliminated players are set to **SPECTATOR**.
\n– The game ends automatically when only **one** player remains.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### `\/dsready [get|start]`<\/p>\n
Player-only. Used to ready-up before starting.
\nOnly works when **no game is active**.<\/p>\n
| Command | Description |
\n|——|————-|
\n| `\/dsready` | Toggles your ready status and broadcasts `[ready\/online]`. |
\n| `\/dsready get` | Shows whether you are currently marked as ready. |
\n| `\/dsready start` | Starts the game **only if everyone online is ready**. |<\/p>\n
—<\/p>\n
### `\/dsstart`<\/p>\n
Requires permission: `ds.start`<\/p>\n
| Command | Description |
\n|——|————-|
\n| `\/dsstart` | Force-starts a new game (only if no game is active). |
\n| `\/dsstart true` | Starts the game in **dev mode** (testing mode). |<\/p>\n
**Dev mode notes:**
\n– Allows starting with only **1 player** online.
\n– Sends extra debug info to OPs (teleport order \/ pair listings).
\n– **Stats are not written** while dev mode is enabled.<\/p>\n
—<\/p>\n
### `\/dsstop`<\/p>\n
Requires permission: `ds.stop`<\/p>\n
| Command | Description |
\n|——|————-|
\n| `\/dsstop` | Force-stops the current game (only if a game is active). |<\/p>\n
—<\/p>\n
### `\/dssettings Requires permission: `ds.settings`<\/p>\n | Command | Description | **Time values are in ticks** **Examples** —<\/p>\n ### `\/dstp Player-only. Spectator utility.<\/p>\n | Command | Description | **Notes** —<\/p>\n ### `\/dskill`<\/p>\n Player-only.<\/p>\n | Command | Description | Useful if you want to forfeit and spectate.<\/p>\n —<\/p>\n ### `\/dsstats [player]`<\/p>\n Player-only.<\/p>\n | Command | Description | **Tracked stats** —<\/p>\n ### `\/dsinfo`<\/p>\n | Command | Description | —<\/p>\n ## Settings Reference<\/p>\n Settings can be changed via `\/dssettings set …` or directly in —<\/p>\n ### Swap Timing<\/p>\n | Setting | Description | —<\/p>\n ### TeleportMode<\/p>\n Controls how player locations are swapped.<\/p>\n | Mode | Description | —<\/p>\n ### World \/ Start Options<\/p>\n | Setting | Description | —<\/p>\n ### Swap Cleanup<\/p>\n | Setting | Description | —<\/p>\n ### Language<\/p>\n | Setting | Description | —<\/p>\n ## Notes & Tips<\/p>\n – Joining while a game is running puts you into **SPECTATOR**. A customizable Death Swap plugin for Spigot and Paper featuring an optional random long-distance spawn at the start, adding a strategic twist to the classic Death Swap experience.<\/p>\n","protected":false},"featured_media":54959,"template":"","meta":{"_minecraft_slug":"death-swap-plus","_minecraft_project_id":"NQdDYBMg","_minecraft_author":"HeroWarriors","_minecraft_license":"MIT","_minecraft_downloads":289,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"death-swap-plus.zip","_minecraft_size_bytes":46751,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:49:41.510770Z","_minecraft_date_created":"2025-12-30T23:41:49.488029Z","_minecraft_date_modified":"2025-12-27T10:31:07.047910Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/death-swap-plus","_minecraft_icon_attachment_id":54959,"_minecraft_imported_at":"2026-06-03T01:23:49+00:00","_minecraft_import_hash":"eb13ee7651cb3c35874a60af50adc4c8","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,88,89,866,127,129,92],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-54958","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-equipment","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","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| `\/dssettings get` | Prints all settings and their current values in one line. |
\n| `\/dssettings help` | Shows help pages. |
\n| `\/dssettings set
\n– `20 ticks = 1 second`
\n– `1200 ticks = 1 minute`<\/p>\n
\n– `\/dssettings set MinTimer 2400` (2 minutes)
\n– `\/dssettings set MaxTimer 6000` (5 minutes)
\n– `\/dssettings set Warning 200` (10 seconds)
\n– `\/dssettings set Safe 60` (3 seconds of invincibility)
\n– `\/dssettings set TeleportMode pairs`<\/p>\n
\n|——|————-|
\n| `\/dstp
\n– Works only if a game is active.
\n– You must be spectating (not in the alive player list).
\n– Tab completion suggests alive players.<\/p>\n
\n|——|————-|
\n| `\/dskill` | Instantly kills you during a game (sets health to 0). |<\/p>\n
\n|——|————-|
\n| `\/dsstats` | Shows your own stats. |
\n| `\/dsstats
\n– Games
\n– Wins
\n– Swaps
\n– Deaths
\n– Disconnected
\n– Time played<\/p>\n
\n|——|————-|
\n| `\/dsinfo` | Shows plugin info (creator, inspiration, version). |<\/p>\n
\n`plugins\/DeathSwap\/config.yml`.<\/p>\n
\n|——|————-|
\n| `MinTimer` | Minimum time before the next swap (ticks). |
\n| `MaxTimer` | Maximum time before the next swap (ticks). |
\n| `Warning` | Action-bar countdown when time until swap \u2264 this value. |
\n| `Safe` | Resistance duration after swaps and at game start. |<\/p>\n
\n|——|————-|
\n| `random` | Each player is teleported to a random other player every swap. Falls back to circle if no valid mapping is found after 500 tries. |
\n| `circle` | Players swap in a circular order randomized at game start. |
\n| `random_circle` | Same as `circle`, but reshuffles after each swap. |
\n| `fixed_circle` | Circle order is fixed and never shuffled. |
\n| `pairs` | Players swap in pairs; odd counts create one 3-player rotation. Pairings are generated at game start. |<\/p>\n
\n|——|————-|
\n| `World` | World used for spawning and teleporting. Falls back if invalid. |
\n| `RandomSpawn` | Randomizes player spawn positions at game start. |
\n| `GiveFood` | Gives starting food if enabled. |
\n| `GiveWaterBucket` | Gives a water bucket if enabled. |<\/p>\n
\n|——|————-|
\n| `KillPearls` | Removes all ender pearls at the moment of a swap. |
\n| `SendChunks` | Present as a setting, but chunks are already preloaded regardless. |<\/p>\n
\n|——|————-|
\n| `Language` | Controls broadcast messages and settings text (`en`, `hu`, `de`, `es`). |<\/p>\n
\n– Dead players can spectate alive players using `\/dstp
\n– Player stats are stored in
\n `plugins\/DeathSwap\/PlayerDatabase\/