# 烽沙 ModelSwapFramework AuthorKit 模型作者工具包
**版本：1.2.0（基于烽沙 Steam build 24965163）**
## 简介
这是面向****模型 Mod 作者****的离线制作工具，用于配合 ModelSwapFramework 框架制作烽沙（MOProject）的角色 / 服装模型替换 Mod。
你只需在 UE5.6 中按原游戏路径制作 `SkeletalMesh` 并打包为 IoStore 三件套，本工具会自动完成最繁琐的部分：定位真实对应的官方 `_Ins` 资产、骨骼映射、权重压缩与写入、LOD 链生成，并输出可直接发布的 `zzzz_*_AutoIns_P` 伴随三件套。
**普通玩家不需要本工具。** 玩家仍从 Steam 正常启动游戏；本工具只由模型作者离线运行。玩家端请安装【烽沙 ModelSwapFramework 模型换装框架（玩家端）】。
## 功能特性
**全自动管线**：识别作者 Pak 中的原路径 `SkeletalMesh`，从当前烽沙 Pipeline 静态目录取得 `SK → _Ins → Mesh → MOSkeleton → BoneMap` 关系，**不要求作者编写 Manifest、JSON 或 BoneMap**。
**精准定位**：找到真正对应的游戏 `_Ins`，不会仅按文件名猜测。
**完整权重处理**：过滤 Socket 骨并按名称映射目标 BoneMap；支持超过四权重的源模型，自动保留最大的四个可映射权重并重新归一化；把权重写入官方 `_Ins` 的最后两套 UV，把 Bone ID 写入 Vertex Color。
**按目标资产布局适配**：4 UV 资产写入 UV2/UV3，3 UV 资产写入 UV1/UV2，不再强制套用单一格式。
**完整 LOD 链**：按目标资产生成完整 LOD 链；简化器达到拓扑下限时安全复用上一有效 LOD，保持 LOD 链非递增且可加载，不再让整项转换失败。
**输出标准容器**：生成正确原路径和 Package ID 的伴随 IoStore 容器，名称以 `zzzz_` 开头，确保在作者原 Pak 之后挂载。
**游戏更新友好**：游戏更新导致 `D_Characters_Chr` 内部对象编号移动时，工具按完整 BoneMap hash 唯一重定位骨架；只有对应 BoneMap 或目标 `_Ins` 结构真的发生变化时，才只禁用受影响的资产，不会因为 build id 变化禁用全部模型。
**缓存与诊断**：按作者三件套哈希缓存结果；每次运行输出 `ModelSwapFramework-Reports/<run-id>/` 诊断报告。
**内置 catalog**：基于烽沙 Steam build `24965163` 的 Pipeline、Mappings 和 59 条模型关系（58 条已通过结构验证）。
## 安装要求
- Windows 64 位系统；
- 本机已安装烽沙（用于读取当前版本官方 `_Ins` 基底，工具通常会自动找到 Steam 游戏目录）；
- Unreal Engine 5.6（用于制作和 Cook 模型资产）。
本工具为绿色软件，解压即用，无需安装。
## 使用说明
### 最短流程
1. 在 Unreal Engine 5.6 中把 FBX 制作成****原游戏路径****的 `SkeletalMesh`。
2. Cook 并打包为同名 PAK/UTOC/UCAS 三件套。
3. 执行：
```text
ModelSwapFrameworkAuthorTool.exe "D:\MyMod\YourModel_P.pak"
```
也可以把 `.pak` 文件直接拖到 `ModelSwapFrameworkAuthorTool.exe` 上。
4. 工具会在作者 Pak 旁生成：
```text
zzzz_YourModel_AutoIns_P.pak
zzzz_Yo
评论加载中
正在读取真实评论数据。
