RuinedWardrobe

RuinedWardrobe is a Paper and Folia wardrobe plugin for servers that want armor cosmetics to feel clean for players and dependable for staff. Players save armor sets into GUI slots, equip or unequip them with one click, and the plugin handles persistence, bound armor protection, diagnostics, audit logs, and storage migration around it.

Highlights

• Hypixel-style wardrobe GUI with drag and drop armor editing, page navigation, locked slots, and equip buttons.
• Paper and Folia scheduler support.
• Runtime support for Paper/Folia 1.21 through 26.2.
• Java 21+.
• Permission tier slots through ruinedwardrobe.slots.<amount> plus admin bonus slots.
• SQLite by default, with optional MySQL or MariaDB for networks.
• Async database pipeline with queue limits, retries, health metrics, and batch sync.
• Bound armor anti-dupe protection for clicks, drags, drops, swaps, armor dispense, and optional container locking.
• GUI editing avoids silent item loss by preventing occupied-piece overwrites and restoring undelivered taken pieces.
• Vanilla-compatible death behavior by default, with an option to preserve wardrobe sets on death.
• Audit logs for equips, edits, deaths, sanitizer removals, sync changes, storage errors, and item deserialization failures.
• Anonymous bStats metrics for server/plugin version adoption, with a local opt-out in config.
• Config, GUI, language, and permission templates made for live server management.

Install

1. Download the jar for your server version.
2. Put it in your server plugins folder.
3. Start the server once so RuinedWardrobe creates its files.
4. Edit plugins/RuinedWardrobe/config.yml, gui.yml, lang/en_US.yml, and permissions.
5. Restart the server, or use /wardrobe reload after config-only changes.

Commands

• /wardrobe or /rw opens the wardrobe GUI.
• /wardrobe help shows command help.
• /wardrobe list [player] lists saved wardrobe sets.
• /wardrobe doctor prints runtime diagnostics.
• /wardrobe reload reloads config, GUI, and language files.
• /wardrobe migrate <sqlite|mysql> [--dry-run] [--force] migrates storage with snapshot verification.
• /wardrobe admin open <player> opens another player's wardrobe.
• /wardrobe admin setslots <player> <amount> adds admin bonus slots.
• /wardrobe admin clearslots <player> removes admin bonus slots.

Links

• Source: https://github.com/Riqqqque/RuinedWardrobe
• Wiki: https://github.com/Riqqqque/RuinedWardrobe/wiki
• Issues: https://github.com/Riqqqque/RuinedWardrobe/issues
• bStats: https://bstats.org/plugin/bukkit/RuinedWardrobe/31967

License

RuinedWardrobe is free to use on any server, including monetized servers. The source and jar can be used, modified, and shared for free, but the plugin itself cannot be resold or commercially redistributed. See the license in the repository for the full terms.