简体魔域 GUID 检查工具
# 简体魔域 GUID 检查工具
用于批量读取并对比 **bmesh(** .cpkg ) 、**骨架(** .ske ) 、**动画(** .ska ) 中的 GUID,快速发现模型、骨架与动画之间的 GUID 不一致或解析异常。
- 分别扫描 bmesh / ske / ska 文件夹,按资源名(文件名无扩展名)自动对齐
.cpkg、.ske、ska 子文件夹。 - 多层级对比:cpkg 内多个
.bmesh、ske 与 bmesh、ske 与 ska、同文件夹下多个 ska 组内一致性

# 安装与运行
# 系统要求
操作系统:Windows 7 及以上(目标框架
net8.0-windows7.0)运行时(框架依赖发布时):.NET 8 桌面运行时 (opens new window)(x64)
先安装这个.NET 8.0
# ClickOnce Web 安装(推荐)
- 在浏览器打开安装页:
http://anim.nd.com.cn/app/MY-C3S3-GUID-Tools/MY-C3S3-GUID-Tools.application (opens new window) - 运行
setup.exe 或MY-C3S3-GUID-Tools.application完成安装。 - 使用开始菜单 / 桌面快捷方式启动(程序名:简体魔域 GUID 检查工具)。
首次安装若本机未装 .NET 8 桌面运行时,安装程序会引导安装。

# 使用说明
# 1. 准备文件夹
一个角色的 Bmesh , ska , ske 模型,骨架,动作三个文件夹,如下图:

| 栏位 | 文件夹内容 | 扫描对象 |
|---|---|---|
| bmesh 模型 | 含 .cpkg 的目录 | .cpkg(ZIP,内嵌 .bmesh XML) |
| ske 骨架 | 含 .ske 的目录 | .ske(SKLT 二进制) |
| ska 动画 | 按骨架名分子文件夹的目录 | 每个子文件夹内的 .ska(SANM 二进制) |
资源名对齐规则:对比时以「无扩展名的文件名」为键——
hero.cpkg ↔ hero.ske ↔ ska/hero/*.ska。
# 2. 指定路径
打开角色文件夹
- 点击 打开角色文件夹:选择角色根目录后,自动查找其下的
bmesh、ske、ska子文件夹并填入三栏
路径设置后会自动扫描并对比(Busy 时状态栏会显示进度与耗时)。
- 点击 打开角色文件夹:选择角色根目录后,自动查找其下的

分别选择 bmesh,ske ,ska 文件夹
- 将文件夹拖拽到对应栏位的路径框
- 点击 📁 浏览选择文件夹

# 3. 查看结果
界面分为三列结果区:

| 栏位 | 展示形式 |
|---|---|
| bmesh | 树形:.cpkg → 包内各 .bmesh 的 GUID |
| ske | 表格:每个 .ske 的 GUID 及与 bmesh 的对比状态 |
| ska | 树形:骨架子文件夹 → 各 .ska;文件夹行显示参考 ske GUID |
颜色含义:
- 绿色:GUID 与参考一致
- 红色加粗:不一致、缺失、解析失败等异常
对比状态示例:一致、与 bmesh 不一致、与 ske 不一致、组内不一致、解析失败、缺少参考 ske 等。
如下图,ska 动画和 ske 骨骼没有匹配就报错显示红色

# 对比规则
逻辑以 输入 1(bmesh) 为最高优先级参考源(若已填写):
| 已填输入 | 对比关系 | 结果标注位置 |
|---|---|---|
| 1 + 2 | 同名 .ske 与 .cpkg 主 bmesh GUID | ske 栏 |
| 1 + 2 + 3 | .ska 与同名 .ske;.ske 与 bmesh | ska 栏 + ske 栏 |
| 仅 2 + 3 | ska 仍以 ske 为参考;ske 栏不标 bmesh 对比 | ska 栏 |
补充规则:
- 同一 ska 子文件夹下所有
.ska 的 GUID 应相同;否则标记为 组内不一致 -
.cpkg 内若含多个.bmesh,会展开子行分别显示 GUID;包内 GUID 不一致时 cpkg 行会标注
# GUID 提取说明
| 文件类型 | 提取方式 |
|---|---|
.cpkg | ZIP 解压,解析内嵌 .bmesh(C3MeshEx XML)中 <skeleton_guid> 的 guid_a / guid_b(十进制) |
.ske | 二进制 SKLT 头,按版本解析路径与时间戳块后读取 GUID(guid_a,guid_b 十六进制) |
.ska | 二进制 SANM,逻辑与 ske 类似 |
# 版本与联系
- 程序版本见关于对话框(当前工程版本号见
extrat_s3_guid.csproj 中<Version>) - 技术支持:99U:199505 | Email: 738746223@qq.com
