# VFSUnity

基于 Unity 2022.3.62f3c1 (URP) 的项目。

## 环境要求

| 工具 | 版本 |
|------|------|
| Unity Editor | **2022.3.62f3c1**（必须一致，建议通过 Unity Hub 安装） |
| Unity Hub | 3.x+ |
| 渲染管线 | Universal Render Pipeline (URP) 14.0.12 |

## 快速开始

### 1. 克隆仓库

```bash
git clone http://199.68.217.153:3000/yangbear/VFSUnity.git
```

> Gitea 要求登录时使用你自己的账号密码即可。
> 如果没有账号，请联系仓库管理员创建。

### 2. 用 Unity Hub 打开

1. 打开 **Unity Hub**
2. 确保已安装 **Unity 2022.3.62f3c1**（在 Installs → Install Editor 中选择此版本）
3. 点击 **Open** → 选择 clone 下来的 `VFSUnity` 文件夹
4. Unity 会自动加载并解析 `Packages/manifest.json` 中的依赖包

### 3. 首次打开等待

- Unity 首次打开会下载项目依赖（URP、TextMeshPro 等），可能需要几分钟
- 等待编辑器完全加载后，在 **Project** 窗口中双击 `Assets/Scenes/SampleScene.unity` 打开主场景

### 4. 运行

- 点击顶部工具栏的 ▶ **Play** 按钮即可运行

## 项目结构

```
VFSUnity/
├── Assets/
│   ├── Scenes/          # 场景文件
│   └── Settings/        # URP 渲染管线配置
├── Packages/            # Unity 包依赖清单
├── ProjectSettings/     # 项目全局设置
└── README.md
```

## 依赖包

核心依赖已在 `Packages/manifest.json` 中锁定版本，Unity 打开时会自动恢复：

- **Universal RP** 14.0.12 — 渲染管线
- **TextMeshPro** 3.0.7 — 文字渲染
- **Timeline** 1.7.7 — 过场动画
- **UGUI** 1.0.0 — UI 系统

## 注意事项

- **不要删除 `.meta` 文件** — Unity 用它们追踪资源和 GUID
- 如果报错缺少模块，检查 Unity Hub 安装该版本时是否勾选了 **Windows Build Support (IL2CPP)**（当前配置了 Burst AOT for Windows）
- 建议在 Unity Hub → Installs → 对应版本 → Add Modules 中补充缺失平台支持