⚡ 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.yml allows 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

1. Download the latest RayzWardrobe-x.x.jar from the releases page.
2. Drop the jar file into your server's plugins/ folder.
3. Restart your server.
4. (Optional) Edit the config.yml, gui.yml, and messages_en.yml to your liking and type /rwreload in 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-enabled in the config and giving players rayzwardrobe.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