? HyroCosmetics — 高级 3D 外观引擎
HyroCosmetics 是一款专为现代 Paper / Purpur (1.20 - 1.21.x) Minecraft 服务器打造的高性能、下一代 3D 外观插件。它基于 Minecraft 原生的 Display Entities(显示实体) 技术,能够在不造成服务器 TPS 延迟或拖尾滞后的情况下,提供流畅的 144+ FPS 动作追踪体验!
✨ 功能特性
? 1. 实时 3D 动作追踪
- 平滑客户端追踪:背包、翅膀和气球动态附着在玩家身上,零拖尾延迟。
- 自然的潜行与姿态倾斜:当玩家潜行或改变视角俯仰角时,外观模型会随之自然倾斜,完美匹配身体朝向。
? 2. 非破坏性穿戴系统
- 玩家可以装备自定义 3D 帽子,而无需卸下护甲!
- 下界合金、钻石等头盔仍可正常佩戴,同时展示自定义的外观模型。
?️ 3. 智能第一人称防遮挡
- 智能检测摄像机角度,当玩家向下看或处于第一人称视角时,自动隐藏笨重的翅膀或帽子。
- 确保玩家在 PvP、挖矿和建造时屏幕保持 100% 干净无遮挡。
? 4. 通用自定义模型支持
- 开箱即用兼容 ItemsAdder、Nexo、Oraxen 以及标准的原版 CustomModelData。
- 可为每个单独模型轻松配置自定义偏移量、旋转、缩放和位置。
? 5. 集成经济商店与优惠券
- 衣柜商店:玩家可通过 Vault 使用服务器货币预览并购买外观道具。
- 实体优惠券:可将任何外观转换为可交易的实体物品优惠券,保留持久的 NBT/PDC 数据。
- 高性能数据库:基于 SQLite 和 HikariCP 连接池的快速、线程安全的玩家数据存储方案。
? 支持的外观类型
| 类别 |
描述 |
| Hats(帽子) |
与玩家俯仰角和偏航角无缝同步的 3D 头部配饰。 |
| Backpacks(背包) |
安装在玩家身后,并支持潜行倾斜的自定义背包。 |
| Wings(翅膀) |
位于上肩胛骨位置的动画翅膀。 |
| Balloons(气球) |
漂浮在玩家上方和身后的可爱 3D 伙伴。 |
| Hand Items(手持物品) |
自定义副手配饰和悬浮的手持道具。 |
| Trails & Effects(轨迹与特效) |
跟随玩家步伐和移动的动态粒子特效。 |
⌨️ 命令与权限
| 命令 |
权限节点 |
描述 |
/cosmetics |
hyrocosmetics.use |
打开 3D 外观衣柜 GUI |
/cosmetics viewself |
hyrocosmetics.use |
切换第一人称/F5 视角下的 3D 外观可见性 |
/cosmetics unequip |
hyrocosmetics.use |
卸下当前激活的外观道具 |
/cosmetics reload |
hyrocosmetics.admin |
重新加载所有配置和模型缓存 |
别名: /hc, /wardrobe, /topi, /cosmetic
⚙️ 要求与安装
运行要求:
- 服务端软件:PaperMC 或 Purpur (1.20 - 1.21.x)
- Java 版本:Java 21 或更高版本
- 可选依赖项:
快速安装:
- 从 Versions 选项卡下载最新的
HyroCosmetics.jar。
- 将 jar 文件放入服务器的
plugins/ 文件夹中。
- 重启服务器以生成配置文件。
- 自定义
config.yml 以调整模型偏移量、消息提示和权限设置!
? 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:
Quick Installation:
- Download the latest
HyroCosmetics.jar from the Versions tab.
- Place the jar file inside your server's
plugins/ folder.
- Restart your server to generate the configuration files.
- Customize
config.yml to adjust model offsets, messages, and permissions to your liking!
评论 0
登录后参与评分
还没有评论,来抢沙发吧