docs: add game installation and Blender requirements

This commit is contained in:
2026-09-14 15:22:32 +08:00
commit f32e96053f

57
README.md Normal file
View File

@@ -0,0 +1,57 @@
# 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)。