跳到主要内容

✦ CloudModel 云模型

适用核心Paper | Purpur适用版本1.20 – 26.x前置packetevents是否付费一次购买 · 永久包更购买价格68R最新版本v1.6.0可选联动MythicMobs | Citizens | CloudCosmetics

同一份 .bbmodel、同一套 MythicMobs 技能,换成更轻的渲染方式。 你在 ModelEngine 里做好的怪物、BOSS、NPC 和时装,不用重做模型、不用改技能,就能交给云模型来显示。

CloudModel 云模型

为什么选择云模型​

模型插件真正的考验在上线之后:BOSS 放技能时动作要准、主城站满 NPC 时服务器不能掉 TPS、玩家走远了也不该继续收封包。 云模型把所有模型都做成「只存在于客户端」的封包显示,服务器上没有任何额外实体;动画、骨骼计算与封包全部在独立的渲染线程完成,主线程每 tick 只读取一次实体位置。

🔁

直接沿用 ModelEngine

配置里填 ModelEngine/blueprints 就能读取原有模型;没装 ModelEngine 时,model、state 等技能原样可用。

🧵

主线程几乎零负担

服务器端没有 display 实体,也没有乘客关系,不会挡传送;动画与封包都在 CloudModel-Render 线程。

🎞️

与 Blockbench 逐帧一致

Linear、Step、Catmull-Rom、Bezier 四种插值与 Molang 关键帧按 Blockbench 的算法取样,技能动作不会「收回来」或抖动。

🧑‍🤝‍🧑

NPC 与玩家伪装

/cm npc 一条指令给 Citizens NPC 套模型,重启、区块重新加载都会自动套回;/cm dis 让玩家变成模型。

👗

完美支持云时装

CloudCosmetics 3.2 起自动使用云模型渲染模型时装:翅膀、背饰贴身跟随零延迟,时装配置一行都不用改。

📦

更小的资源包

PNG 无损重压缩、相同贴图合并、1.21.4+ 每个模型只有一个物品定义;可选缩图与减色,实测 7.5 MB 的手绘贴图压到 0.8 MB。

0个服务器端实体
4种关键帧插值
3档距离降频(LOD)
7个 MythicMobs 技能
1.20 – 26.x同一个 JAR

和 ModelEngine、BetterModel 的完整对比见 对比 ModelEngine / BetterModel。

功能一览​

模块能做什么
模型读取.bbmodel(含 Blockbench「压缩存档」)、子文件夹、额外读取 ModelEngine 的模型文件夹;多线程解析
渲染纯封包 item_display,在客户端骑乘实体,跟随零延迟;1.21.11 起一个骨骼一个 display(方块任意角度、多轴旋转直接写进模型),更旧的版本自动按旋转角度合并
动画4 种插值、Molang 关键帧、循环 / 播放一次 / 停在最后一帧、淡入淡出、播放速度;idle / walk / spawn / death 自动播放
骨骼h_ / hi_ 开头的骨骼跟随头部转向;hitbox 骨骼不渲染;单独设置亮度、显示隐藏、染色
面向玩家Blockbench 的 Billboard 元素与 billboard{} 技能:光晕、刀光等特效在每个玩家的视角都正对自己(1.0.6 起)
展示实体底座套在 block / item / text display 上时可继承它的变换、朝向、插值与亮度,MythicMobs 用展示实体做的技能特效可以直接缩放、旋转模型(1.0.3 起)
受伤变色受到伤害时整个模型泛红(颜色、时长可调)
距离降频每位玩家按距离分近 / 中 / 远三档更新频率;没有人看得到的模型完全不计算、不发封包
MythicMobsmodel state brightness partvis tint defaultstate billboard,名称与参数同 ModelEngine;抛射物 bulletType=MEG 模型子弹原样可用(1.0.8 起);与 ModelEngine 共存时用 cmodel{} 等
ModelEngine 插件ModelEngine 兼容层 让 MCPets 等只支持 ModelEngine 的插件直接用云模型:宠物名称、骑乘与 walking / flying 操控(1.2.0 起)
Citizens/cm npc 给选中的 NPC 套模型并存档,详见 NPC 与伪装
玩家伪装/cm dis 把玩家变成模型,重新登录、重启后自动套回
云时装CloudCosmetics 模型时装的渲染后端,详见 搭配云时装
资源包自动生成文件夹与 resource_pack.zip,可复制进 CraftEngine / ItemsAdder;1.21.4+ 用 item_model,旧版用 CustomModelData
自我检查/cm selftest 检查封包编码与物品组件;/cm stats 查看渲染线程耗时

从这里开始​