Compatibility
Minecraft: Java Edition
1.21.x
1.20.x
Platforms
Links
Tags
Creators
Details
Licensed ARR
Published last month
Updated 1 hour ago
๐ HyroCosmetics โ Advanced 3D Cosmetics Engine
HyroCosmetics is a high-performance, next-generation 3D cosmetics plugin built specifically for modern Paper / Purpur (1.20 - 1.21.4+) Minecraft servers. Powered by native Display Entities (ItemDisplay), it provides butter-smooth 144+ FPS motion tracking without causing server tick lag or trailing delay!
โจ Features
๐ 1. Real-Time 3D Motion Tracking & Dynamic Poses
- Smooth Client-Side Tracking: Backpacks, wings, and balloons are dynamically attached with zero trailing lag.
- Natural Sneak & Head Tilting: Cosmetics dynamically tilt when players sneak or change pitch, matching their body orientation naturally.
- Horizontal Pose Synchronization (1.21+): Automatically detects Swimming, Crawling, Elytra Gliding, and Trident Spin Attack โ rotating backpacks and wings 90ยฐ horizontally to naturally follow the player's spine.
- Seat & Mount Stability: Built-in listeners for GSit / Chairs and vehicles (
VehicleEnter/Exit,EntityMount/Dismount) ensure models never detach or float away when sitting or riding horses/boats.
๐ฉ 2. Non-Destructive Wearable System
- Players can equip custom 3D hats without losing their armor!
- Netherite, Diamond, and enchanted helmets can still be worn with full protection while displaying custom cosmetic models.
๐๏ธ 3. Smart First-Person Anti-Obstruction
- Intelligently detects camera angles and automatically hides bulky wings, backpacks, or hats when looking down or in first-person view (
hide-from-self: auto). - Keeps the player's screen 100% clean and unobstructed for competitive PvP, mining, and building, while remaining fully visible in F5 (Third-Person view).
๐ฆ 4. Universal Custom Model & 1.21.2+ Component Support
- Multi-Plugin Support: Out-of-the-box compatibility with ItemsAdder, Nexo, Oraxen, and standard vanilla CustomModelData.
- Modern Vanilla Item Models (1.21.2+): Native support for Minecraft's data-driven item model format (
item_model: "namespace:model_path"). Run custom 3D models without strict integer IDs! - Hex Armor Tinting (
color: "#HEX"): Freely tint leather cosmetics (hats, footwear, robes) to any hex color code in config files without creating separate texture files. - Fine-Tuned Offsets: Easily configure custom X/Y/Z offsets, rotations, scales, and passenger coordinates for each individual model.
๐ฐ 5. Interactive Wardrobe GUI, Economy & Vouchers
- Multi-Page Pagination: Browse hundreds of cosmetics effortlessly with intuitive page buttons (
ยซ Previous Page,Page X of Y,Next Page ยป). - Active Profile Slot: Preview all currently equipped cosmetics directly at slot 4 of the main wardrobe GUI.
- Economy Wardrobe Shop: Players can preview and unlock cosmetics using in-game currency via Vault.
- Physical Vouchers: Convert any cosmetic into a tradeable physical item voucher with persistent NBT/PDC data via
/cosmetics convert. - High-Performance Storage: Fast, thread-safe player data storage powered by SQLite with HikariCP connection pooling.
๐ญ Supported Cosmetic Types
| Category | Description |
|---|---|
| Hats & Masks | 3D head accessories that sync seamlessly with player pitch and yaw without removing helmets. |
| Backpacks | 3D backpacks and jetpacks mounted cleanly behind the player with sneak and swimming tilt. |
| Wings | Animated wings placed across the upper shoulder blades. |
| Balloons | Cute 3D companions floating above and behind the player with invisible tethers. |
| Hand Items | Custom off-hand accessories, floating handheld props, and walking canes. |
| Footwear | 3D boots, sneakers, and step auras. |
| Trails & Auras | Dynamic particle effects (including 1.21 Breeze Gust, Cherry Blossom, Trial Omen, and Vault Runes). |
| Kill Effects | Visceral PvP elimination effects (including 1.21 Wind Burst, Mace Ground Slam, Ominous Mist, and Blood Explosions). |
โจ๏ธ Commands & Permissions
| Command | Permission | Description |
|---|---|---|
/cosmetics |
hyrocosmetics.use |
Opens the 3D Cosmetics Wardrobe GUI |
/cosmetics list [category] |
hyrocosmetics.use |
Lists all loaded cosmetics and active models in chat |
/cosmetics info <id> |
hyrocosmetics.use |
Displays technical details for a specific cosmetic |
/cosmetics viewself |
hyrocosmetics.use |
Toggles 3D cosmetic visibility for first-person / F5 |
/cosmetics unequip [category] |
hyrocosmetics.use |
Unequips your current active cosmetic or category |
/cosmetics convert <id> |
hyrocosmetics.use |
Converts an owned cosmetic into a tradeable voucher item |
/cosmetics equip <id> [player] |
hyrocosmetics.admin |
Forces equipping a cosmetic to a player |
/cosmetics reload |
hyrocosmetics.admin |
Reloads all configurations, menus, and model caches |
Aliases: /hc, /hcosmetics, /wardrobe, /topi, /pakaian, /cosmetic
โ๏ธ Requirements & Installation
Requirements:
- Server Software: PaperMC or Purpur (1.20 - 1.21.4+)
- Java Version: Java 21 or newer
- Optional Integrations:
- Vault (For in-game currency economy purchases)
- PlaceholderAPI (For scoreboard and tablist cosmetic placeholders)
- GSit (For sitting and pose compatibility)
- ItemsAdder / Nexo / Oraxen (For custom 3D model packs)
Quick Installation:
- Download the latest
HyroCosmetics-1.1.0.jarfrom the Versions tab. - Place the jar file inside your server's
plugins/directory. - Restart your server to generate the default configuration files.
- Enjoy smooth 3D cosmetics on your server!


