Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
⚡ RayzWardrobe
The ultimate, lightweight Armour & Loadout management system for PaperMC 1.21+.
RayzWardrobe brings a seamless, Premoim wardrobe experience to your server. Allow your players to save their current armor sets, rename them, and swap between them instantly using a highly aesthetic and fully customizable GUI.

✨ Features
- Custom Item Framework Ready: Natively hooks into ItemsAdder, Oraxen, and Nexo. Your custom items will retain their specific metadata, custom durability, and 3D models when saved in the wardrobe.
- 100% Configurable GUI: Don't like the default layout? Change it! The
gui.ymlallows you to adjust the inventory size (9-54 slots) and assign exact slots for every button, armor piece, and nameplate. - Resource Pack GUI Support: Easily implement custom transparent Font UI resource packs by mapping the plugin's configurable buttons over your custom texture pack art.
- Animated GUI Themes: Players can unlock different visual themes. Features RGB cycling borders, breathing backgrounds, and particle effects.
- Database Support: Built-in support for both local YAML file storage and MySQL for cross-server syncing.
- Admin Inspection: Staff members can view and inspect the wardrobes of other players in real-time.
- Highly Optimized: Written efficiently for modern Paper servers with asynchronous data handling and safe legacy-data fallbacks.
🚀 Installation
- Download the latest
RayzWardrobe-x.x.jarfrom the releases page. - Drop the jar file into your server's
plugins/folder. - Restart your server.
- (Optional) Edit the
config.yml,gui.yml, andmessages_en.ymlto your liking and type/rwreloadin the console.
Developer note:
Rayzwardrobe is owned by rayzstudio & rayz, i dont make money off it as it is a free plugin. please if you decide to use it in your projects and server setups that you're gonna sell add this plugin as a dependency and not provide it directly.
💻 Commands & Permissions
| Command | Permission | Description |
|---|---|---|
/wardrobe |
rayzwardrobe.use |
Opens your personal wardrobe. |
/wardrobe themes |
rayzwardrobe.use |
Opens the GUI theme selector. |
/wardrobe view <player> |
rayzwardrobe.admin.view |
Inspects another player's wardrobe. |
/rwreload |
rayzwardrobe.reload |
Reloads all plugin configurations. |
Note: You can lock specific wardrobe slots behind permissions by enabling
slot-permissions-enabledin the config and giving playersrayzwardrobe.use.slot.<number>.
Placeholder
Placeholders
| Placeholder | Description | Example |
|---|---|---|
%rayzwardrobe_version% |
Plugin version | %rayzwardrobe_version% |
%rayzwardrobe_storage_type% |
Current storage type | %rayzwardrobe_storage_type% |
%rayzwardrobe_max_sets% |
Maximum wardrobe sets | %rayzwardrobe_max_sets% |
%rayzwardrobe_max_pages% |
Maximum wardrobe pages | %rayzwardrobe_max_pages% |
%rayzwardrobe_theme_count% |
Total registered themes | %rayzwardrobe_theme_count% |
%rayzwardrobe_placeholder_count% |
Total available placeholders | %rayzwardrobe_placeholder_count% |
%rayzwardrobe_total_sets% |
Player's total saved sets | %rayzwardrobe_total_sets% |
%rayzwardrobe_used_slots% |
Used wardrobe slots | %rayzwardrobe_used_slots% |
%rayzwardrobe_empty_slots% |
Empty wardrobe slots | %rayzwardrobe_empty_slots% |
%rayzwardrobe_current_page% |
Current wardrobe page | %rayzwardrobe_current_page% |
%rayzwardrobe_selected_theme% |
Selected theme display name | %rayzwardrobe_selected_theme% |
%rayzwardrobe_selected_theme_key% |
Selected theme key | %rayzwardrobe_selected_theme_key% |
%rayzwardrobe_renaming% |
Whether player is renaming a set | %rayzwardrobe_renaming% |
%rayzwardrobe_cooldown% |
Wardrobe cooldown status | %rayzwardrobe_cooldown% |
%rayzwardrobe_cooldown_remaining% |
Remaining cooldown time | %rayzwardrobe_cooldown_remaining% |
%rayzwardrobe_can_use% |
Whether player can use wardrobe | %rayzwardrobe_can_use% |
%rayzwardrobe_can_themes% |
Whether player can use themes | %rayzwardrobe_can_themes% |
%rayzwardrobe_slot_<number>_name% |
Slot display name | %rayzwardrobe_slot_1_name% |
%rayzwardrobe_slot_<number>_exists% |
Whether slot exists | %rayzwardrobe_slot_1_exists% |
%rayzwardrobe_slot_<number>_permission% |
Slot permission node | %rayzwardrobe_slot_1_permission% |
%rayzwardrobe_slot_<number>_access% |
Whether player has access to slot | %rayzwardrobe_slot_1_access% |
Slot placeholders use 1-based slot numbers (
1,2,3, etc).
🔗 Links & Support
- Discord: Join for Support & Suggestions
- Wiki: Read the Documentation


