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 minigame lobbies, minigame lobbies, minigame lobbies, or any server looking to add cosmetic customization.

---

🚀 Key Features

🎭 Multiple Cosmetic Categories

- Shoes - Crowns, helmets, hats, and headwear - Shoes - Face coverings and masks - Shoes - Chestplates and upper body cosmetics - Shoes - Elytra-style back cosmetics - Shoes - 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 Multi-line lore (resource pack textures) - Multi-line lore 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:

```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

- MySQL - 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

---