# \u26a1 RayzWardrobe<\/p>\n
**The ultimate, lightweight Armour & Loadout management system for PaperMC 1.21+.**<\/p>\n
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.
\n<\/p>\n
## \u2728 Features<\/p>\n
* **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.
\n* **100% Configurable GUI:** Don’t like the default layout? Change it! The `gui.yml` allows you to adjust the inventory size (9-54 slots) and assign exact slots for every button, armor piece, and nameplate.
\n* **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.
\n* **Animated GUI Themes:** Players can unlock different visual themes. Features RGB cycling borders, breathing backgrounds, and particle effects.
\n* **Database Support:** Built-in support for both local YAML file storage and **MySQL** for cross-server syncing.
\n* **Admin Inspection:** Staff members can view and inspect the wardrobes of other players in real-time.
\n* **Highly Optimized:** Written efficiently for modern Paper servers with asynchronous data handling and safe legacy-data fallbacks.<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
1. Download the latest `RayzWardrobe-x.x.jar` from the releases page.
\n2. Drop the jar file into your server’s `plugins\/` folder.
\n3. Restart your server.
\n4. *(Optional)* Edit the `config.yml`, `gui.yml`, and `messages_en.yml` to your liking and type `\/rwreload` in the console.<\/p>\n
## Developer note:
\nRayzwardrobe 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.<\/p>\n
## \ud83d\udcbb Commands & Permissions<\/p>\n
| Command | Permission | Description | > **Note:** You can lock specific wardrobe slots behind permissions by enabling `slot-permissions-enabled` in the config and giving players `rayzwardrobe.use.slot. ## Placeholder<\/p>\n # Placeholders<\/p>\n | Placeholder | Description | Example | > Slot placeholders use **1-based slot numbers** (`1`, `2`, `3`, etc).<\/p>\n ## \ud83d\udd17 Links & Support<\/p>\n * **Discord:** Join for Support & Suggestions RayzWardrobe brings a polished GUI for saving, managing, and equipping unlimited armor sets \u2014 secure, customizable, and performance-optimized..<\/p>\n","protected":false},"featured_media":129393,"template":"","meta":{"_minecraft_slug":"rayzwardrobe","_minecraft_project_id":"o3eYj7IM","_minecraft_author":"RayzGG","_minecraft_license":"MIT","_minecraft_downloads":378,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"rayzwardrobe.zip","_minecraft_size_bytes":419556,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-16T11:03:35.561638Z","_minecraft_date_created":"2025-08-16T17:43:59.005954Z","_minecraft_date_modified":"2026-05-07T12:11:35.888892Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/rayzwardrobe","_minecraft_icon_attachment_id":129393,"_minecraft_imported_at":"2026-06-07T14:53:55+00:00","_minecraft_import_hash":"97dc4485aeb43910e579234df08ea2f1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,89,126,127,128,867,129,91,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-129392","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n| :— | :— | :— |
\n| `\/wardrobe` | `rayzwardrobe.use` | Opens your personal wardrobe. |
\n| `\/wardrobe themes` | `rayzwardrobe.use` | Opens the GUI theme selector. |
\n| `\/wardrobe view
\n| `\/rwreload` | `rayzwardrobe.reload` | Reloads all plugin configurations. |<\/p>\n
\n|—|—|—|
\n| `%rayzwardrobe_version%` | Plugin version | `%rayzwardrobe_version%` |
\n| `%rayzwardrobe_storage_type%` | Current storage type | `%rayzwardrobe_storage_type%` |
\n| `%rayzwardrobe_max_sets%` | Maximum wardrobe sets | `%rayzwardrobe_max_sets%` |
\n| `%rayzwardrobe_max_pages%` | Maximum wardrobe pages | `%rayzwardrobe_max_pages%` |
\n| `%rayzwardrobe_theme_count%` | Total registered themes | `%rayzwardrobe_theme_count%` |
\n| `%rayzwardrobe_placeholder_count%` | Total available placeholders | `%rayzwardrobe_placeholder_count%` |
\n| `%rayzwardrobe_total_sets%` | Player’s total saved sets | `%rayzwardrobe_total_sets%` |
\n| `%rayzwardrobe_used_slots%` | Used wardrobe slots | `%rayzwardrobe_used_slots%` |
\n| `%rayzwardrobe_empty_slots%` | Empty wardrobe slots | `%rayzwardrobe_empty_slots%` |
\n| `%rayzwardrobe_current_page%` | Current wardrobe page | `%rayzwardrobe_current_page%` |
\n| `%rayzwardrobe_selected_theme%` | Selected theme display name | `%rayzwardrobe_selected_theme%` |
\n| `%rayzwardrobe_selected_theme_key%` | Selected theme key | `%rayzwardrobe_selected_theme_key%` |
\n| `%rayzwardrobe_renaming%` | Whether player is renaming a set | `%rayzwardrobe_renaming%` |
\n| `%rayzwardrobe_cooldown%` | Wardrobe cooldown status | `%rayzwardrobe_cooldown%` |
\n| `%rayzwardrobe_cooldown_remaining%` | Remaining cooldown time | `%rayzwardrobe_cooldown_remaining%` |
\n| `%rayzwardrobe_can_use%` | Whether player can use wardrobe | `%rayzwardrobe_can_use%` |
\n| `%rayzwardrobe_can_themes%` | Whether player can use themes | `%rayzwardrobe_can_themes%` |
\n| `%rayzwardrobe_slot_
\n| `%rayzwardrobe_slot_
\n| `%rayzwardrobe_slot_
\n| `%rayzwardrobe_slot_
\n* **Wiki:** [Read the Documentation]([https:\/\/github.com\/yourlink\/wiki](https:\/\/discord.gg\/8deUaAvasf))<\/p>\n","protected":false},"excerpt":{"rendered":"