# 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)。