From f32e96053f9bac8cbdb3abeebf8383569ad56d12 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=B0=8F=E7=85=9C?= <2082529121@qq.com>
Date: Mon, 14 Sep 2026 15:22:32 +0800
Subject: [PATCH] docs: add game installation and Blender requirements

---
 README.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b4ca470
--- /dev/null
+++ b/README.md
@@ -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)。