# InventorySwap<\/p>\n
InventorySwap is a lightweight plugin that randomly rotates inventories between online players on a configurable timer. No databases, no bloat. Just chaos on a schedule.<\/p>\n
Works great on SMP servers, events, or any gamemode where you want to keep players on their toes.<\/p>\n
—<\/p>\n
## How it works<\/p>\n
A countdown ticks in the action bar for every player on the server. When it hits zero, inventories rotate \u2014 armor, items, offhand included. Players get a title announcement and a sound cue. The timer resets and starts again.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
All commands require the `inventoryswap.admin` permission.<\/p>\n
| Command | Description | —<\/p>\n ## Permissions<\/p>\n | Node | Default | Description | > Players without `inventoryswap.use` are silently excluded from the rotation. —<\/p>\n ## Configuration<\/p>\n “`yaml If there aren’t enough eligible players when the timer fires, the swap is skipped silently and the timer resets normally.<\/p>\n —<\/p>\n ## Features<\/p>\n – **Action bar countdown** visible to all online players at all times —<\/p>\n ## Compatibility<\/p>\n – Paper \/ Spigot \/ Bukkit \/ and more **1.21.1** —<\/p>\n ## Language files<\/p>\n Both `en.yml` and `es.yml` are generated in the plugin folder on first run. Every message, action bar text, title and subtitle is editable. Changes apply on `\/invswap reload`.<\/p>\n “` Inventory Swap system between players<\/p>\n","protected":false},"featured_media":86192,"template":"","meta":{"_minecraft_slug":"invswapsc","_minecraft_project_id":"ftrv7DzH","_minecraft_author":"vyurita","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":9,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"invswapsc.zip","_minecraft_size_bytes":12839,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:13:56.689500Z","_minecraft_date_created":"2026-04-01T22:51:23.988343Z","_minecraft_date_modified":"2026-04-01T10:31:28.799327Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/invswapsc","_minecraft_icon_attachment_id":86192,"_minecraft_imported_at":"2026-06-04T22:12:30+00:00","_minecraft_import_hash":"7d7498c4ec83736cd937fbf7b38d263e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,89,866,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-86191","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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| `\/invswap interval
\n| `\/invswap minplayers
\n| `\/invswap pause` | Freeze the timer without resetting it |
\n| `\/invswap resume` | Resume from where it left off |
\n| `\/invswap bypass` | Toggle swap immunity for yourself |
\n| `\/invswap lang
\n| `\/invswap reload` | Reload config and restart the timer |
\n| `\/invswap help` | Show command list in-game |<\/p>\n
\n|—|—|—|
\n| `inventoryswap.admin` | OP | Full access to all commands |
\n| `inventoryswap.use` | Everyone | Eligible to participate in swaps |
\n| `inventoryswap.bypass` | Nobody | Immune to swaps entirely |<\/p>\n
\n> `inventoryswap.bypass` is separate \u2014 useful for staff who want to stay opt-out by default.<\/p>\n
\n# config.yml
\nswap-interval: 300 # seconds between each swap (default: 5 minutes)
\nmin-players: 2 # won’t swap if fewer players are online
\nlanguage: en # en | es
\n“`<\/p>\n
\n– **Pause \/ Resume** \u2014 freeze the timer mid-countdown, pick up exactly where you left off
\n– **Full inventory swap** \u2014 contents, armor slots and offhand
\n– **Configurable minimum players** \u2014 swap only fires when it’s worth it
\n– **Title + subtitle announcement** on every swap
\n– **5-second countdown titles** with sound cues before each swap
\n– **Subtle particle and sound effects** on swap (Portal + End Rod burst, no lag)
\n– **Per-player bypass toggle** for staff or exempt players
\n– **Bilingual** \u2014 English and Spanish out of the box, switchable with a command
\n– **No restart required** \u2014 everything reloads live<\/p>\n
\n– Java 21
\n– No dependencies<\/p>\n
\nplugins\/InventorySwap\/
\n\u251c\u2500\u2500 config.yml
\n\u2514\u2500\u2500 lang\/
\n \u251c\u2500\u2500 en.yml
\n \u2514\u2500\u2500 es.yml
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"