更新记录
每个版本的更新内容与发布日期。升级方式见安装与升级。
3.2 支持 CloudModel 云模型
3.2 起模型时装可以改用 CloudModel 云模型 渲染，ModelEngine 变成可选，时装配置不用改。见 搭配云时装。
3.0 原生背包
3.0 起支持 ItemsAdder / CraftEngine 原生背包（type: backpack），贴身跟随、转身同步，可与帽子等时装同时穿戴。配置见原生背包。
2.10.8 多件穿戴
2.10.8 起可以让玩家同时穿戴多件时装（翅膀 + 头饰 + 光环……），默认仍为一次一件。开启方式见多 件穿戴。
开服信息统一格式
- 优化开服信息改成全系列统一格式：一行「云时装 v3.4.1 已启用」、一行统计（时装、分类、模型插件、储存方式），再列出侦测到的本系列插件；去掉原本的大标题
- 兼容替换 JAR 并重启，配置与玩家数据不用改
启动横幅、后台零警告
- 新增开服后在后台显示云时装启动横幅：时装数量、分类、模型插件、储存方式，并列出侦测到的云系列 / 星月系列插件与联动内容
- 优化没有填写授权码、暂时连不上授权服务器（会自动重试）时改为一般信息，不再显示整片红色警告；只有授权码错误、过期、被停用才会警告
- 修复简体版残留的繁体提示（时装模型尚未载入、时装物品无法载入、资料载入失败等）与云界面画面文件的注释改为简体；没改过的旧画面文件开服时自动更新
- 兼容替换 JAR 并重启，配置与玩家数据不用改
支持 Paper 26.3、云界面衣橱新画面
- 兼容支持 Paper 26.3：前置 packetevents 请换成 2.14.0 以上（2.13.0 不支持 26.3，会在开服时崩溃导致云时装无法加载）
- 优化云界面衣橱：空卡与空格外框改成均匀实线；背景暗角改成柔和的椭圆渐层
- 新增旧画面文件自动更新：没有修改过的旧版默认画面文件开服时自动换成新版，改过的文件保留不动
- 优化后台更干净：没有设置模型时装时，缺少 CloudModel / ModelEngine 不再显示警告；没有开启商城时，缺少 Vault 不再显示警告
- 兼容替换 JAR 并重启，配置与玩家数据不用改
修复时装属性重新登录后重复叠加
- 修复修复时装属性（MythicLib 属性）在玩家每次重新登录后多叠加一层：较新的 MythicLib 开发版会在下线后保留玩家的属性表、下次登录沿用，旧属性没被移除
- 优化套用属性前先清除该玩家所有
yunyuecosmetics_开头的属性；MythicLib 有档案会话（profile session）功能时，会话开启后重新套用、关闭时清除 - 兼容官方 MythicLib 1.7.1 照常运作；已经叠加的多余属性会在玩家下次登录、重生、获得时装或
/cosmetic reload时自动清掉，重启服务器也会清空；直接替换 JAR 并重启
开服不再等待授权服务器
- 优化授权验证改在后台进行：开服不再等待授权服务器（授权服务器连不上时原本每次开服卡约 5 秒，现在不到 0.3 秒），验证通过前功能保持锁定
- 新增开服时连不上授权服务器会每 60 秒自动重试，连上就立即解锁，不需要重启；HTTPS 被网络拦截时自动改用 HTTP 验证（回应带数字签名，安全性不受影响）
- 优化连不上时控制台会写出具体原因（DNS 解析不到、连线超时、被防火墙拦截、HTTPS 握手失败），方便排查
指定世界停用不死图腾
- 新增
config.yml新增totem-disabled-worlds：图腾时装在这些世界不触发（例如 PVP、竞技场、副本），世界名称不分大小写 - 优化在停用的世界死亡不会消耗图腾冷却，回到其他世界照常生效；手持原版不死图腾不受影响
- 兼容直接替换 JAR 并重启，或加上设置后
/cosmetic reload；没写这一行时所有世界都生效
时装跟着玩家大小缩放
- 新增玩家用体型插件或
/attribute ... minecraft:scale改变大小时，时装等比例跟着放大缩小，游戏中途改大小也会立即跟上（1.20.5 起的原版属性） - 新增模型时装（ModelEngine / CloudModel）、BODY 贴身时装、CE / IA 原生背包、Citizens 时装 NPC 都会一起缩放，偏移也按比例换算，不会歪到一边
- 新增
config.yml新增follow-player-scale（默认true），设为false时时装保持原本大小 - 新增安装云界面 CloudUI 时，衣橱改用云界面画面（时装分类、时装列表、角色试穿）；穿戴提示改为画面通知，可用
cloudui.notice关闭 - 兼容直接替换 JAR 并重启，旧配置不用改
时装跟着 NPC 转身
- 修复NPC 看向玩家时（Citizens
lookclose、Adyeshach「看向玩家」）时装跟着 NPC 一起转，不再停在原本的方向或慢半拍 - 优化NPC 时装改为跟随 NPC 的身体朝向并每 tick 同步，转身效果与玩家时装相同；
rotation.mode: smooth对 NPC 同样生效 - 兼容Adyeshach 的「看向所有玩家（发包）」是每位玩家各自看到 NPC 看向自己，服务器上的朝向不会改变，时装无法跟着转；需要时装跟随时请改用「看向玩家」
- 兼容直接替换 JAR 并重启
时装 NPC 支持 Adyeshach
- 新增时装 NPC 支持 Adyeshach：
/cosmetic npc <分类> <时装ID>指令不变，开服自动检测服务器装的是 Citizens 还是 Adyeshach - 新增Citizens 和 Adyeshach 都装时默认用 Citizens 创建，可在
config.yml加npc-plugin: adyeshach指定；已创建的 NPC 两边都继续显示时装 - 新增
/cosmetic npc remove <NPC ID>同时支持两种 NPC：Adyeshach 填 Ady 的 NPC ID（可 Tab 补全，改过 ID 也能删除） - 新增使用 Adyeshach 的 Citizens 转换功能后，删除原 Citizens NPC（或移除 Citizens），转换出来的 NPC 会自动沿用原本的时装
- 修复NPC 名称不再被锁死：创建时以时装名称命名，之后可以用 Citizens / Adyeshach 的改名指令自由修改，重生、重启、
/cosmetic reload都不会被改回 - 兼容直接替换 JAR 并重启，不需要修改配置；原有的时装 NPC 不受影响
授权保护加强
- 优化授权版在本机也检查授权码到期时间，到期后立即停用；永久授权不受影响
支持 CloudModel 云模型
- 新增模型时装（
type: meg）可以使用 CloudModel 渲染：模型在客户端骑乘玩家，跟随零延迟 - 新增开服自动检测模型插件；两个都装时每件时装各自选择，可用
model-backend: cloudmodel / modelengine强制指定 - 优化ModelEngine 改为可选前置，只装 CloudModel 的服务器不会出现找不到 ModelEngine 的错误
- 优化CloudModel 模式沿用时装原本的动作动画、朝向平滑、偏移与可见设定；与原生背包同时穿戴互不覆盖
原生背包体验升级
- 优化背包转向更跟手：快速转身后立即与玩家朝向对齐
- 优 化区域保护更友好：在禁止生成实体的区域（如 WorldGuard 保护区）背包会自动暂停显示，限制解除后自动恢复，并在控制台提示
- 优化背包仅作为外观显示，不会掉落
- 兼容直接替换 JAR 并完整重启，不需要修改任何配置或数据
CE / IA 原生背包
- 新增新增原生背包
type: backpack：直接使用 ItemsAdder / CraftEngine 的背包物品，贴身跟随、转身同步，不占用玩家的头盔或副手 - 新增背包配置简单：
backpack.source与backpack.item两行即可 - 新增CE / IA 帽子（
type: equipment、slot: HEAD）可与原生背包同时穿戴 - 优化背包的移动与转向同步：走、跑、转身都紧贴玩家
- 兼容原有 BODY 时装配置保持不变；原生背包的位置与大小由模型资源包决定
可设置的多件穿戴
- 新增新增两种穿戴模式：
equipment.mode: single（全身一件）/per-category（每个分 类分别穿戴） - 新增分类以
cosmetics/内的 YAML 文件名为准；body、meg、equipment只是渲染方式，不再作为「同类型只能一件」的限制 - 新增支持 BODY + MEG + HEAD 同穿，以及多件 MEG 同穿；同一模型也能由不同时装配置分别挂载
- 新增
menus/categories.yml每个分类可设max-equipped（默认 1，0禁止穿戴）；分类满额时替换该分类最早穿戴的一件 - 新增
equipment.max-equipped全身总上限，超出时拒绝新增并保留原穿搭 - 新增原生装备槽冲突检查
equipment.slot-conflict：replace替换旧时装 /deny拒绝新时装 - 新增新增时装字段
equip-group：不同分类的整套模型或配件互斥，同组只保留新穿戴的一件 - 优化整合多个模型的挂载清单，BODY / MEG 不再互相覆盖；原生 HEAD 与 OFF_HAND 外观状态独立管理
- 优化点击衣橱中已穿戴的项目只卸下该件；「卸下」按钮仍为全部卸下
- 优化多件穿搭按顺序保存，重登后恢复；自动沿用旧版单件数据
- 优化多件图腾时装共用玩家冷却，采用最早穿戴的图腾时装规则，切换时装不会重置冷却
- 修复数据加载中 / 加载失败时阻止穿戴变更，避免覆盖尚未成功读取的数据
- 兼容默认
mode: single，旧服升级不会突然开启多件；切回single时保留最后穿戴的一件。属性仍按已拥有时装计算，同穿多件不会重复加成
修复 BODY 闪烁与上下跳动
- 修复修复 BODY 已挂到玩家身上，却仍收到独立移动、传送与位置同步封包，导致模型突然掉下去又回来的问题
- 优化已挂载的 BODY 由客户端处理乘客位置，保留转向更新；服务端仍维持实体位置与追踪范围
- 优化挂载清单不变时不再重复发送，减少反复挂载引发的不稳定
- 修复补强登录与实体生成的时序，修复挂载封包早于模型生成而失效的情况
- 修复修正销毁、重登、切换可见性及跨世界后的挂载状态清理与恢复
- 兼容适用原版、ItemsAdder 与 CraftEngine 来源的 BODY 时装
IA / CE 跟随与装备外观改善
- 优化BODY 在玩家移动、转向时直接更新朝向，移除额外的展示插值延迟，改 善跑动时模型落后的感觉
- 优化改善 ItemsAdder / CraftEngine 自定义物品读取，保留来源插件生成的完整物品数据
- 优化改善
equipment原生装备外观封包；帽子可用HEAD，适合副手姿势的素材可用OFF_HAND - 修复真实主手 / 副手物品优先显示，清空后恢复时装，不会遮住盾牌、图腾或工具
- 修复创造模式隐藏本人的虚拟装备，避免展示物品进入创造背包；其他玩家仍可看到，回到生存模式后恢复
- 新增找不到 MEG 模型或自定义物品时给出提示；不支持的装备槽会在加载时警告
MEG 偏移方向修正 · CE BODY 显示模式
- 修复MEG XYZ 偏移方向修正：ModelEngine 会从骨骼位置减去挂载补偿值，之前把偏移加进补偿值导致显示方向相反。现在正 Y 向上，X / Z 按玩家朝向换算（玩家与 NPC 通用）
- 兼容⚠ 升级前为了抵消反向而调整过的 MEG
offset，升级后需要把 X / Y / Z 的正负号反过来 - 新增CE BODY 新增
body.transform显示模式：CraftEngine 来源默认NONE，可选 HEAD、FIXED、GUI、GROUND 等；body.anchor控制位置，两者互相独立 - 兼容原版与 ItemsAdder 来源未指定
transform时仍使用 HEAD，旧配置外观不变 - 修复BODY 移动时逐 tick 同步展示实体位置，不再等距离超过 2 格才补位；正常情况仍由乘客挂载跟随
- 优化包含 2.10.3 / 2.10.4 的 R4.1 挂载注册与登录挂载补发修复
登录挂载重发（测试版，已并入 2.10.5）
- 修复R4.1 下同时标记外层「穿戴者 → 模型」挂载，让 ModelEngine 重新发送挂载封包
- 修复生成、重新追踪与显示后于 2 / 10 / 30 tick 补发挂载，只对仍在线且可见的观察者重试，模型移除后停止
ModelEngine R4.1 挂载修复
- 修复修复 ModelEngine R4.1 下 XYZ 偏移失效：PivotOverride 设置前未注册到 PivotOverrideRegistry，导致渲染器读不到自定义偏移、乘客封包也不会发送
- 优化每个模型使用独立的登记 UUID，不覆盖其他插件以玩家 UUID 登记的挂载；模型拆除或初始化失败时清理登记
- 兼容保留 R4.0.9 旧 API 路径与 2.10.2 固定格位、排序功能
时装菜单排版
- 新增新增
order：设置时装排序，数字越小越靠前 - 新增新增
menu-slot：把时装固定在指定格位（从 0 起算） - 新增新增
menu-page：配合menu-slot指定固定页码（从 1 起算） - 新增衣橱与商城支持固定格位与自动排列混合使用
- 兼容旧
slot继续作为排序值，未填order时沿用 - 优化未设置
menu-slot的时装按content-slots填入剩余空格并自动分页 - 修复固定格位冲突、超出范围或占用按钮时记录警告并改为自动排列，不会覆盖其他物品
- 修复没有可用自动格位时显示错误提示并停止打开菜单
模型偏移与配置加载防护
- 修复模型位置检查纳入配置的 XYZ 偏移距离，较大偏移不再被误判为位置异常而反复重建
- 修复模型初始化后若挂载对 象被替换，重新应用动态偏移（玩家与 NPC 时装）
- 优化配置文件按文件名顺序加载；不同文件出现重复时装 ID 时保留第一个有效定义，跳过其余并记录警告
- 优化加载日志新增配置文件路径、时装 ID、XYZ 偏移与模型大小，方便排查配置未生效的问题
图腾冷却提示 · 简体中文默认配置
- 新增不死图腾冷却提示：
totem-notify.mode可选bossbar（BOSS 血条，随冷却缩短）、actionbar（快捷栏上方文字）或none - 新增图腾触发、冷却中、冷却结束三种提示与时间格式全部可在
messages.yml的totem.*自定义，留空即不发送 - 新增PlaceholderAPI 变量：
%cloudcosmetics_totem_remaining%、totem_status、totem_ready、equipped等，可自行放到计分板 / TAB - 优化首次生成的 config、messages、菜单与范例时装全部改为简体中文（大陆用语），数据库时区默认
Asia/Shanghai - 优化指令帮助与提示文字改为简体中文；默认分类 ID 改为
legendary/eternal - 兼容已存在的配置文件不会被覆盖；旧 messages.yml 缺少的图腾提示使用内置默认文字
全新权限组
- 新增新增
cloudcosmetics.*权限组：use、shop、admin以及admin.give / remove / view / card / npc / reload六个子权限 - 新增Tab 补全只显示你有权限使用的子指令
- 优化
/cosmetic reload现在可以在后台执行 - 优化新安装生成的
wings.yml改为完整注释的「星辰之翼」范例，并附 display / equipment / body 模板 - 兼容旧权限
yunyuecosmetics.admin继续有效，已发出的时装卡与数据库完全兼容
- 修复修复玩家登录时数据读取失败，恢复穿戴状态与显示偏好，无需删除数据库
- 新增每件时装可单独设置
lore，支持{default_lore}、{stats}、{price}、{status}等占位符
- 新增衣橱与商城的时装图标支持 CraftEngine 物品（
icon.source: craftengine）
更名 CloudCosmetics 云时装
- 新增正式更名为 CloudCosmetics，数据文件夹改为
plugins/CloudCosmetics，首次启动自动复制旧数据 - 兼容保留旧权限、时装卡、图腾冷却数据键与数据库表名
- 新增BODY 时装支持 CraftEngine 物品来源（
body.source: craftengine）
不死图腾
- 新增时装可启用不死图腾保命效果，支持冷却时间与触发后生命值设置
- 新增冷却按真实时间计算并保存在玩家数据中，重登、重启、重载不清除
- 兼容兼容 ModelEngine R4.1.0，同时保留 R4.0.9 兼容
- 修复修复菜单物品可被拿取的问题，全面拦截取物、Shift、数字键、双击与拖曳
- 修复未安装 Citizens 时核心事件也能正常注册
多版本兼容
- 兼容支持 Paper / Purpur 1.20 – 26.x，自动适配 item-model、Display 插值与实体追踪 API
- 兼容以 Java 17 字节码编译，并对 8 个服务端 API 版本进行自动化回归测试
- 修复时装只发送给真正追踪到穿戴者的玩家，修复重新追踪后客户端挂载丢失
- 优化有观众时每 5 秒补发一次挂载，修复被其他插件覆盖的数据包
- 修复修复 NPC 重生 后时装高度错位
- 优化观众预算排序缓存位置与距离，减少重复计算
时装商城
- 新增新增 Vault 时装商城：分类页、分页、价格、购买状态显示
- 新增购买并发保护与失败自动退款
- 优化BODY 虚拟乘客显示稳定性改进
人多也不卡
- 新增观众模型预算：每位玩家只加载离自己最近的 N 件时装
- 新增远距离玩家模型动画 LOD
分类（等级）菜单
- 新增新增分类选择页
menus/categories.yml，每个cosmetics/*.yml成为一个时装等级 - 优化显示 / 隐藏时装按钮移到分类页
BODY 贴身展示
- 新增新增
type: body，通过虚拟乘客贴身显示且不占盔甲栏 - 新增BODY 支持 ItemsAdder 完整物品与 BODY / HEAD / BACK / FEET 锚点
多渲染模式
- 新增新增
type字段：equipment原版装备外观与display浮空物品
- 新增新增
follow-watchdog：检测模型骨骼冻结并自动重建
- 新增
follow-rotation：可选只跟随位置不跟随朝向 - 新增
ownership.op-has-all：OP 视为拥有全部时装 - 新增默认时装卡外观与衣橱自动分页（
items-per-page）
时装卡与属性 BUFF
- 新增时装卡右键永久解锁
- 新增拥有即生效的属性 BUFF（MythicLib）
- 新增可自定义的衣橱菜单
menus/wardrobe.yml与翻页、卸下按钮 - 新增Citizens 时装 NPC
- 新增隐藏其他玩家时装
- 新增远距离动画优化开关
- 新增渲染距离与可见性设置
- 新增转向模式
rigid/native-body/smooth与自适应平滑参数 - 优化自己时装的显示偏好保存到数据库
首个版本
- 新增ModelEngine 模型时装，按待机 / 行走 / 潜行 / 飞行 / 游泳切换动画
- 新增SQLite / MySQL 数据存储
- 新增时装配置独立为
cosmetics/文件夹，提示消息独立为messages.yml