OutfitsPlus

# 👕 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_ !(https://cdn.modrinth.com/data/cached_images/5049f7e77c39bad94370f3f433ba1676b7dc57f3.png) --- ## 📋 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 ` - 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: ```yaml 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: 🔗 **(https://github.com/itsharshxd/OutfitsPlus/issues)** ---