我的世界

CosmeticsCore 终极装饰品插件

LT-YHC

2026-08-11 00:09:40 · 更新于 2026-08-22 01:54:53 · 34 浏览 · 3 回复

CosmeticsCore

Minecraft 服务器终极装饰品（Cosmetics）解决方案。为玩家提供帽子、背包、尾巴、翅膀、气球等丰富的外观自定义内容，集成专业级衣橱界面，以极低带宽消耗实现丝滑体验，让服务器拥有"官方更新级"的质感。

下载链接1为官方下载地址，需要付费。
下载地址2为本人购买的获得了授权的插件jar网盘地址，收取部分积分不过分吧。
请看清楚支持的范围，我不负责处理问题。
发布之前，已经确认过插件可以正常使用。

概述

CosmeticsCore 由 LoneDev 开发，是一款专注于玩家外观装饰的付费插件。它通过资源包（Resourcepack）为玩家提供丰富的装饰品系统，所有模型与纹理均由服务端自动分发，玩家无需安装任何客户端模组。
核心优势
即装即用：内置 14 款预制装饰品，安装后即可体验
专业衣橱界面：创新的交互式预览模式，支持旋转、缩放、着色
极低带宽占用：优化数据传输，支持数百个装饰品不造成 TPS 下降
无缝集成：完美融入原版 Minecraft 体验，如同官方更新
灵活存储：支持 YAML 本地存储与 MySQL 同步（可选）
开发者 API：开放 API 便于二次开发与第三方插件集成

兼容性与依赖
支持的服务端与版本

| 项目 | 详情 |
| :--- | :--- |
| 服务端 | Spigot / Paper / Purpur |
| Minecraft 版本 | 1.16.5 – 1.21.11（含 26.x 预览版） |
| Java 版本 | Java 16+（推荐 Java 21） |
依赖关系

| 依赖 | 类型 | 说明 |
| :--- | :--- | :--- |
| ProtocolLib | 必须 | 数据包拦截与修改基础库 |
| LoneLibs | 必须 | LoneDev 系列插件的通用工具库 |
| ItemsAdder | 可选 | 用于高级气球功能与资源包合并 |
如果你的服务器已安装 ItemsAdder，CosmeticsCore 可以与其共享资源包，无需额外配置独立的资源包分发。

配置文件

配置文件位于 plugins/CosmeticsCore/config.yml，关键配置项如下：

lang: en # 语言文件（en / zh_cn / 等）
extract_default_assets: true # 是否自动解压默认资源

cosmetics:
max_equippable:
hat: 1 # 最多戴 1 顶帽子
body: 3 # 最多装备 3 个身体装饰
balloon: 2 # 最多携带 2 个气球

hide_during_combat:
enabled: true # 战斗时隐藏装饰品
combat_duration_ticks: 600 # 战斗判定持续时间（tick）

hide_in_vanish: true # 隐身时隐藏装饰品

wardrobe_room:
camera:
hide_actionbar_texts: true # 隐藏动作栏文本
rotation:
enabled: true # 启用鼠标滚轮旋转
zoom:
enabled: true # 启用鼠标滚轮缩放
min: 2
fade_effect: true # 进出衣橱黑屏淡入淡出

衣橱房间坐标（在此区域内可打开衣橱）
teleport_area:
enter:
world: Spawn
pos1: { x: 139.0, y: 43.0, z: -34.0 }
pos2: { x: 141.0, y: 41.0, z: -35.0 }

exit_location:
world: Spawn
x: 140.5
y: 41.0
z: -32.5
yaw: -0.09
pitch: -1.58

gui:
slots:
colors:
not_owned: 195,147,57 # 未拥有的装饰品槽位颜色（RGB）
owned: 56,67,100 # 已拥有的槽位颜色
wearing: 57,70,195 # 正在穿戴的槽位颜色
wearing_preview: 195,120,57 # 预览穿戴的槽位颜色
max_amount_reached: 111,111,111 # 已达上限的槽位颜色

save:
以下两种方式二选一
file:
enabled: true # 使用 YAML 文件存储
mysql:
enabled: false # 使用 MySQL 存储
url: jdbc:mysql://localhost:3306/cosmeticscore
username: root
password: your_password
table: cosmeticscore_saved

debug: false

安装步骤
第一步：安装依赖
下载并安装 ProtocolLib（放入 plugins/ 文件夹）
下载并安装 LoneLibs（放入 plugins/ 文件夹）
如果使用高级气球功能，确保已安装 ItemsAdder
第二步：安装 CosmeticsCore
从 SpigotMC 购买并下载 CosmeticsCore（CosmeticsCore.jar）
将 jar 文件放入 plugins/ 文件夹
启动服务器，让插件生成默认配置文件与资源包文件
第三步：配置资源包

如果你已经有自定义资源包：
打开 plugins/CosmeticsCore/default_assets.zip
将其中的 assets/z_cosmetics 和 assets/cosmetics 文件夹复制到你的资源包中
使用官方提供的 JSON 合并工具合并 fermented_spider_eye.json 和 potion.json
将合并后的文件放回你的资源包

如果你使用 ItemsAdder 管理资源包（推荐）：
解压 default_assets.zip 中的内容
将 plugins/ 文件夹复制到服务器的 plugins/ 目录（覆盖合并）
执行 /iazip 重新生成资源包
执行 /cosmeticsconfig cosmetics reload 重载装饰品
第四步：设置衣橱位置
在游戏中走到你希望作为衣橱入口的位置
执行 /cosmeticsconfig config set door-area-locations 设置传送区域
执行 /cosmeticsconfig config set camera-location 设置摄像机位置
执行 /cosmeticsconfig config set exit-location 设置退出返回位置
执行 /cosmeticsconfig config reload 确认配置生效
第五步：验证
走进传送区域，确认衣橱自动打开
检查装饰品是否正常显示
测试穿戴/卸下功能

与 ItemsAdder 的协同

CosmeticsCore 与 ItemsAdder 同为 LoneDev 开发的插件，两者可以深度整合：
共享资源包：CosmeticsCore 的装饰品模型可以直接打包进 ItemsAdder 的资源包中，玩家只需下载一个资源包
气球增强：安装 ItemsAdder 后，CosmeticsCore 的气球功能支持更多自定义模型（通过 ModelEngine）
统一配置管理：装饰品配置文件可以放在 ItemsAdder 的 contents/ 目录下统一管理

更新记录

| 版本 | 日期 | 重要变更 |
| :--- | :--- | :--- |
| 1.3.12 | 2026-05-26 | 修复 Brigadier 命令问题；修复帽子命令问题；新增隐藏鞘翅系统 |
| 1.3.11 | 2026-05-22 | 支持 1.26.1.1 和 1.26.1.2；修复 Ansi 颜色问题 |
| 1.3.10 | 2026-03-04 | 支持 Minecraft 1.21.11 |
| 1.3.8 | 2025-07-24 | 修复 java.lang.VerifyError |
| 1.3.7 | 2025-07-22 | 1.21.8 兼容；1.21.6 兼容；装饰品预览权限 |
| 1.3.6 | 2025-05-07 | 自动补全优化；按分类移除；颜色工具提示；占位符支持 |
| 1.3.0 | 2024-09-03 | 重大更新，支持 1.21+ |
| 1.2.0 | 2023-01-30 | 新增 ModelEngine 气球支持 |
| 1.0.2 | 2022-10-13 | 修复 ProtocolLib 兼容性问题；修复 Nova WAILA 显示 |
| 1.0.0 | 2022-09-16 | 首个公开版本 |

常见问题
装饰品不显示 / 显示为原版物品
确认资源包已正确加载（在游戏选项中检查）
执行 /iatexture（如已安装 ItemsAdder）强制重载资源包
检查 config.yml 中装饰品的 itemSource 和 itemID 是否正确
玩家进入衣橱后卡住无法退出
按 Shift 退出，或按 ESC
如果仍然卡住，在控制台执行 /teleport 将该玩家传送到安全位置
确保 exit_location 已正确配置
如何添加自定义装饰品
使用 Blockbench 创建模型并导出
在 plugins/CosmeticsCore/ 下创建装饰品配置文件（YAML）
将纹理和模型文件放入对应的资源包路径
执行 /cosmeticsconfig cosmetics reload 重载

许可协议

CosmeticsCore 为付费插件，由 LoneDev 开发并维护。
每个服务器/网络/域名需要单独的许可证
禁止反编译、转售、破解或重新分发
可以基于插件创建并出售自定义的装饰品包、纹理和配置
默认装饰品资源（assets）不得包含在你的出售包中
购买后享受终身更新

制作 by LT-YHC

CosmeticsCore 终极装饰品插件

评论 (0)

{{title}}

CosmeticsCore 终极装饰品插件

评论 (0)

打赏支持

打赏记录

举报内容

编辑版本

{{title}}