# 🗂️ 资源管理器：在 VS Code 中管理你的游戏资源

在游戏开发中，你需要频繁地在代码和游戏资源（如模型、图片、UI）之间切换。为了简化这个流程，ArenaPro 在 VS Code 中内置了一个强大的**资源管理器**，让你无需离开编辑器，即可轻松管理所有云端地图资源。

> **👉 [一键打开资源管理器](vscode://box3lab.box3arenapro/command?type=ap.file.openArena)**

![Arena 资源管理器概览](/QQ20241129-201037.png)

## 📦 支持的资源类型

在“扩展地图”模式下，资源管理器可以让你访问和管理当前地图及其所有子图的共享资源。

| 资源类型        | 说明                         |
| --------------- | ---------------------------- |
| 🧊 **模型**     | 3D 模型、场景道具            |
| 🖼️ **图片**     | UI 贴图、图标、纹理          |
| 🖥️ **UI 界面**  | 使用 UI 编辑器创建的界面布局 |
| 💾 **数据空间** | 用于存储持久化游戏数据       |
| 👤 **玩家皮肤** | 自定义角色外观               |
| 🎵 **音频**     | 背景音乐、技能音效           |

## ⚙️ 核心功能与操作

### 浏览与复制

资源管理器最核心的功能，就是让你能快速找到资源并获取其路径。

| 操作         | 说明                                               |
| ------------ | -------------------------------------------------- |
| **集中浏览** | 在 VS Code 侧边栏即可浏览所有云端资源。            |
| **路径复制** | **单击**资源即可快速复制其路径，用于粘贴到代码中。 |
| **快捷菜单** | **右键点击**资源，可进行预览、重命名等更多操作。   |

### 刷新机制

为了确保你看到的资源是最新的，资源管理器提供了自动和手动两种刷新方式。

#### 自动刷新时机

| 触发条件          | 刷新行为                       |
| ----------------- | ------------------------------ |
| **初次展开列表**  | 自动拉取最新的资源列表。       |
| **账号登录/登出** | 自动同步当前账号下的地图资源。 |
| **项目配置变更**  | 链接到新地图时，自动刷新资源。 |

#### 手动刷新

当你在神岛编辑器中修改了资源（例如上传了新模型），需要手动同步。

| 操作             | 说明                               |
| ---------------- | ---------------------------------- |
| **点击刷新按钮** | 点击面板右上角的“刷新”图标即可。   |
| **右键菜单刷新** | 在资源面板空白处右键，选择“刷新”。 |

:::tip
**💡 最佳实践**
虽然手动复制路径很方便，但它无法提供编译时的安全检查。对于核心的游戏逻辑，我们更推荐使用 **[类型安全的资源同步功能](./asset-synchronization.md)**，它可以让你在编码时获得自动补全和错误校验。
:::

---
