Перейти к содержимому
Mineforgian

RuinedWardrobe

Paper/Folia wardrobe plugin with polished armor storage, anti-dupe protection, async storage, diagnostics, and bStats metrics.

Загрузки
23
Подписчики
1
Обновлён
26 июня 2026 г.
Лицензия
Custom

Опубликован 30 мая 2026 г.

Исходный кодСообщить об ошибке

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

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.

Ченджлог

1.0.10Релиз26.1.1, 26.1.2, 26.2 · 26 июня 2026 г.
  • Fixed rapid wardrobe equip clicks so a pending action blocks the second mutation before it reaches storage.
  • Added /wardrobe rename for saved set labels.
  • Added more PlaceholderAPI values for open state, equipped state, slot counts, set existence, and saved armor pieces.
  • Added /wardrobe doctor compatibility reporting for common custom item, cosmetics, permissions, vanish, and world-region plugins.
  • Updated Paper/Folia 26.2 compatibility docs and bStats defaults.
1.0.9Релиз26.1.1, 26.1.2, 26.2 · 26 июня 2026 г.
  • Added /wardrobe rename <slot> <name> for saved set labels.
  • Added more PlaceholderAPI values for open/equipped state, slot counts, set presence, and saved armor pieces.
  • Added /wardrobe doctor compatibility reporting for common custom item, cosmetic, protection, and utility plugins.
  • Updated docs with custom item/resource-pack compatibility notes and the current Paper 26.2 API check.
  • Kept the shipped jar on Java 21 bytecode with Paper/Folia 1.21 through 26.2 support.
1.0.8Релиз26.1.1, 26.1.2, 26.2 · 21 июня 2026 г.
  • Added Paper/Folia 26.2 to the supported runtime matrix.
  • Added a Gradle compatibility check for the Paper 26.2 API line.
  • Hardened async profile cache invalidation so late database loads cannot repopulate stale player cache after quit/reload paths.
  • Release jar still uses Java 21 bytecode and the Paper 1.21 API baseline for older supported servers.
1.0.7Релиз26.1, 26.1.1, 26.1.2 · 14 июня 2026 г.

GUI safety and reload cleanup.

  • Shut down the bStats metrics instance during plugin reload/disable so /wardrobe reload does not stack metrics tasks.
  • Changed GUI armor placement so occupied wardrobe pieces must be taken before a new piece is placed.
  • Restores taken armor back into the wardrobe slot if the viewer disconnects before the item can be delivered.
  • Kept bStats shaded/relocated and metrics enabled by default with the local opt-out.
1.0.6Релиз26.1, 26.1.1, 26.1.2 · 13 июня 2026 г.

bStats metrics support.

  • Added RuinedWardrobe bStats integration using the public Bukkit service ID.
  • Enabled anonymous metrics by default for new installs with a local metrics.enabled opt-out.
  • Updated the README, wiki config docs, and Modrinth page with the bStats link and privacy note.
  • Updated bStats to 3.2.1 and kept it shaded/relocated inside the plugin jar.
1.0.5Релиз26.1, 26.1.1, 26.1.2 · 13 июня 2026 г.

Armor wardrobe safety hardening.

  • Serialized same-player wardrobe writes across GUI, commands, API, sync, death sync, and selected-slot repair.
  • Made GUI place/take return items only from the server-authoritative mutation result.
  • Blocked stale async profile loads from replacing newer cache state.
  • Cancelled outside/null-target clicks while the wardrobe menu is open.
1.0.4Релиз26.1, 26.1.1, 26.1.2 · 30 мая 2026 г.

Inventory polish update.

  • Wardrobe armor pickup now puts the item on your cursor when possible, so a full inventory does not block taking a saved piece.
  • Replacing a saved armor piece now returns the previous piece instead of overwriting it.
  • Reduced extra item cloning during armor equip checks.

Комментарии

Загружаем…