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, rename saved sets, 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.
• Full Bukkit ItemStack storage for custom armor metadata exposed through Bukkit.
• /wardrobe doctor reports storage, cache, sync, DB probe, and common optional plugin hooks.
• 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 rename <slot> <name> renames one of your saved 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.

Compatibility Notes

RuinedWardrobe stores and restores the full Bukkit item stack for armor pieces. Custom item and resource-pack plugins work best when their armor is exposed as normal Bukkit ItemStack data. RuinedWardrobe does not create those items; it stores, equips, and returns the item stack the server gives it.

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.