HyroCosmetic
Advanced 3D cosmetics engine for Minecraft with real-time motion tracking, Display Entities, and built-in economy support.
1250обновлён 26 сент. 2026 г.
ДекорЭкономикаСнаряжение
Описание
👑 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.x) Minecraft servers. Powered by Minecraft's native Display Entities, it provides butter-smooth 144+ FPS motion tracking without causing server tick lag or trailing delay!
✨ Features
🎒 1. Real-Time 3D Motion Tracking
- Smooth Client-Side Tracking: Backpacks, wings, and balloons are dynamically attached with zero trailing lag.
- Natural Sneak & Pose Tilting: Cosmetics dynamically tilt when players sneak or change pitch, matching their body orientation naturally.
🎩 2. Non-Destructive Wearable System
- Players can equip custom 3D hats without losing their armor!
- Netherite, Diamond, and other helmets can still be worn while displaying custom cosmetic models.
👁️ 3. Smart First-Person Anti-Obstruction
- Intelligently detects camera angles and automatically hides bulky wings or hats when looking down or in first-person view.
- Keeps the player's screen 100% clean and unobstructed for PvP, mining, and building.
📦 4. Universal Custom Model Support
- Compatible out-of-the-box with ItemsAdder, Nexo, Oraxen, and standard vanilla CustomModelData.
- Easily configure custom offsets, rotations, scales, and positions for each individual model.
💰 5. Integrated Economy Shop & Vouchers
- Wardrobe Shop: Players can preview and purchase cosmetics using server currency via Vault.
- Physical Vouchers: Convert any cosmetic into a tradeable physical item voucher with persistent NBT/PDC data.
- High-Performance Database: Fast, thread-safe player data storage powered by SQLite and HikariCP connection pooling.
🎭 Supported Cosmetic Types
| Category | Description |
|---|---|
| Hats | 3D head accessories that sync seamlessly with player pitch and yaw. |
| Backpacks | Custom backpacks mounted cleanly behind the player with sneak tilt. |
| Wings | Animated wings placed across the upper shoulder blades. |
| Balloons | Cute 3D companions floating above and behind the player. |
| Hand Items | Custom off-hand accessories and floating handheld props. |
| Trails & Effects | Dynamic particle effects following player steps and movements. |
⌨️ Commands & Permissions
| Command | Permission | Description |
|---|---|---|
/cosmetics | hyrocosmetics.use | Opens the 3D Cosmetics Wardrobe GUI |
/cosmetics viewself | hyrocosmetics.use | Toggles 3D cosmetic visibility for first-person / F5 |
/cosmetics unequip | hyrocosmetics.use | Unequips your current active cosmetic |
/cosmetics reload | hyrocosmetics.admin | Reloads all configurations and model caches |
Aliases: /hc, /wardrobe, /topi, /cosmetic
⚙️ Requirements & Installation
Requirements:
- Server Software: PaperMC or Purpur (1.20 - 1.21.x)
- Java Version: Java 21 or newer
- Optional Dependencies:
- Vault (Required only if you use economy features)
- ItemsAdder / Nexo / Oraxen (For custom 3D model packs)
Quick Installation:
- Download the latest
HyroCosmetics.jarfrom the Versions tab. - Place the jar file inside your server's
plugins/folder. - Restart your server to generate the configuration files.
- Customize
config.ymlto adjust model offsets, messages, and permissions to your liking!
Последние версии
Все версии →release
HyroCosmetic
1.0.026 сент. 2026 г.125Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Что нового
# 🎉 HyroCosmetics v1.0.0 - Initial Release
Welcome to the first official release of **HyroCosmetics**, the next-generation 3D cosmetics engine for modern Minecraft servers!
### ✨ Key Features
* **Display Entity Rendering**: Ultra-smooth real-time tracking for custom 3D models with zero client-side trailing delay.
* **Non-Destructive Wearables**: Equip custom 3D hats without overriding the player's helmet slot—armor remains fully functional!
* **Smart First-Person Anti-Obstruction**: Automatically hides bulky wings and hats when in first-person or looking down to keep your screen clear for mining and PvP.
* **Multiple Cosmetic Types**:
* 🎒 **Backpacks** (dynamic pitch/sneak tilting)
* 🪽 **Wings** (upper-back passenger positioning)
* 🎩 **Hats** (head equipment/display tracking)
* 🎈 **Balloons & Handhelds**
* **Universal Custom Model Support**: Plug-and-play compatibility with **ItemsAdder**, **Nexo**, **Oraxen**, and vanilla `CustomModelData`.
* **Integrated Economy & Database**: Built-in wardrobe shop and high-performance SQLite database with HikariCP connection pooling.
* **Physical Cosmetic Vouchers**: Trade cosmetics easily as physical item vouchers with persistent PDC data.
### ⚙️ Compatibility
* **Server Software**: Paper, Purpur (1.20 - 1.21.x)
* **Java Version**: Java 21+