👕 OutfitsPlus - Cosmetic Armor System

Let your players express themselves with stylish cosmetic outfits!

---

✨ What is OutfitsPlus?

OutfitsPlus is a lightweight cosmetic armor plugin that allows players to wear custom cosmetic outfits over their armor slots. Cosmetics are purely visual and only appear when the armor slot is empty - zero impact on gameplay!

Perfect for RPG servers, survival networks, minigame lobbies, or any server looking to add cosmetic customization.

---

🚀 Key Features

🎭 Multiple Cosmetic Categories

• Hats - Crowns, helmets, hats, and headwear
• Masks - Face coverings and masks
• Tops - Chestplates and upper body cosmetics
• Wings - Elytra-style back cosmetics
• Pants - Leggings and lower body cosmetics
• Shoes - Boots and footwear

👁️ Player Visibility Control

Players can choose what they see:

• Toggle their own cosmetics on/off
• Hide other players' cosmetics if desired

🎨 Full Customization

• Support for Custom Model Data (resource pack textures)
• Color-coded display names with hex color support
• Multi-line lore for detailed descriptions
• Custom metadata for rarity, author, and more

🔐 Flexible Unlock System

• Permission-based unlocks
• Command-based grants for admins
• Default unlocked cosmetics option

🌐 Multi-Language Support

• Built-in locale system
• Players can choose their preferred language
• Easy to add new translations

⚡ Performance First

• Uses Bukkit's native equipment API
• No packet libraries required
• Minimal server impact
• Async data saving

---

📷 Gallery

TEXTURE ARE NOT APPLIED HERE

---

📋 Requirements

Requirement	Version
Server	Paper 1.21.4+
Java	21+

No dependencies required! OutfitsPlus is a standalone plugin.

---

🎮 Commands

Player Commands:

• /outfits help - Show help menu
• /outfits equip <category> <id> - Equip a cosmetic
• /outfits unequip <category|all> - Remove cosmetic(s)
• /outfits list [category] - Browse available cosmetics
• /outfits toggle <own|others> - Toggle visibility
• /outfits info <category> <id> - View cosmetic details

Admin Commands:

• /outfits reload - Reload all configs
• /outfits give <player> <category> <id> - Grant cosmetic
• /outfits take <player> <category> <id> - Revoke cosmetic
• /outfits reset <player> - Reset player data

---

📁 Easy Configuration

Creating cosmetics is simple - just drop YAML files in the category folders:

id: royal_crown
display-name: "&6&lRoyal Crown"
lore:
  - "&7A crown fit for royalty!"
  - "&eMade of pure gold."
material: LEATHER_HELMET
custom-model-data: 2001
default-unlocked: false
metadata:
  rarity: legendary

---

🔧 Storage Options

• YAML - Simple file-based storage (default)
• MySQL - Database storage for networks (coming soon)

---

🛡️ Permissions

Permission	Description
outfitsplus.use	Basic access
outfitsplus.admin	Admin commands
outfitsplus.bypass.unlock	Use any cosmetic
outfitsplus.cosmetic.*	All cosmetics

---

💬 Support

Having issues or suggestions? Visit our GitHub:

🔗 GitHub Issues

---