Files
SVS_Character_Exporter/README.md

58 lines
2.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# SVS Character Exporter
用于 **Summer Vacation Scramble** 的游戏角色导出插件,可直接生成 FBX 和 Blender 文件。
**电脑必须安装 Blender 5.0 或更高版本。Blender 无需安装任何额外插件,导出后直接打开 `.blend` 文件即可。**
## 安装前准备
- 游戏已安装并能正常使用 **BepInEx 6(IL2CPP)**。
- 电脑已安装 **Blender 5.0 或更高版本**。导出时会自动在后台调用 Blender,因此即使只打算使用 FBX,也必须安装 Blender。
## 安装到游戏
1. 关闭游戏。
2. 将发布包中的 `BepInEx` 文件夹合并到**游戏根目录**,也就是游戏主程序所在的文件夹。
3. 确认插件文件位于以下位置,然后重新启动游戏:
```text
游戏根目录/
└─ BepInEx/
└─ plugins/
└─ SVSExporter/
└─ SVS_Exporter.dll
```
如果只有 `SVS_Exporter.dll`,也可以手动创建上述目录并放入 DLL。更新时替换原来的 DLL,避免保留多份同名插件。
## 导出角色
1. 进入游戏的**角色编辑器**。
2. 点击 **角色导出 · FBX + Blender**。
3. 按需选择 T 型姿势、服装骨架分离等选项,点击 **导出 FBX + .blend**。
4. 等待导出完成,文件会保存在:
```text
游戏根目录/Export_FBX/<时间>_<角色名>/
├─ model.blend
├─ model.fbx
└─ model.fbm/
```
在 Blender 中选择 **文件 → 打开 → model.blend** 即可使用。使用或移动 FBX 时,请保留同目录下的 `model.fbm` 贴图文件夹。
## 提示找不到 Blender 时
插件会尝试自动查找 Blender。如果自动查找失败,在首次启动游戏生成的 `BepInEx/config/SVSExporter.cfg` 中,找到 `[Blender]`,填写 `blender.exe` 的完整路径:
```ini
[Blender]
Executable = D:\Blender\blender.exe
```
将示例路径改为自己电脑上的实际位置,保存配置并重新启动游戏。这里填写的是 **`blender.exe` 文件路径**。
## 致谢
本项目基于 [Illusion_ClothingStateMenu](https://github.com/ManlyMarco/Illusion_ClothingStateMenu) 和 [KKBP_Exporter](https://github.com/FlailingFog/KKBP_Exporter)。