CradleMC官方WIKI

适用源码:9da0beb8e8fdad85f50d7039408c3d98494e91c7。本文记录源码行为,默认配置不等于实服配置。
设计状态:按现状编写,具体业务批准记录未逐项核定;开发状态:下述能力有实现证据,限制单列;验证状态:完成定向源码核对,未执行自动测试或实服验收。

资源链

正式源模型与已烘焙穿戴资源→client-pack Build 生成显示 JSON、输入 ZIP 和 manifest→同步资源配置→CE 合并分发→客户端接受并验收。
Plugins/CraftEngine/artifacts/flrv-client.zip 是 CE 的输入包,不是可以直接假定玩家下载到的最终包。只传装备配置而漏 ZIP 可导致图标或头盔模型缺失。

三种动作

client-pack.ps1 动作 范围
Materialize 解包到资源工作目录,供贴图编辑等使用
Build 生成显示资源、检查引用并重建 ZIP/manifest,属于写入动作
Check 检查本地输入资源,不代表服务器安装或客户端成功

本阶段没有执行这些动作。Linux 包装入口 client-pack.sh 依赖 pwsh;部分穿戴烘焙另用对应 Node 工具,不能把 PowerShell 打包等同重新生成全部3D穿戴编码。

引用一致性

装备身份、底材、属性和合成由 FoliaPlugin 装备配置维护;CE 为模型与外观接入。skin 注册表需要稳定 ID、类型/部位和资源引用,新增 bbmodel 不自动成为可用皮肤。修改外观不改装备 UUID 或重抽品质。

发布与验收

同步前核对 ZIP、manifest、CE 引用齐全及哈希;保护规则只有正式输入 ZIP 精确例外,不应放开所有压缩包。重启 JAR 与 /ce reload all 责任不同。
客户端分别检查背包图标、头盔、胸甲护腿靴子、武器朝向、UI 背景与文字。缺包时先查分发链,不通过修改业务数据补救。

视觉规范边界

标签生成脚本、字体与配色是项目线索,尚不是获批网站品牌规范。本文不生成 CSS,不修改主题。原图和实机表现需另验。

来源

resource-build/README.md、resource-build/client-pack.ps1、resource-build/client-pack.sh、resource-build/ui-labels.json、ui-labels.ps1(同目录);Plugins/CraftEngine/resources/flrv/configuration/items/ui.yml;docs/装备皮肤与铁匠铺换肤.md。
相关:装备指南、构建部署。