> For the complete documentation index, see [llms.txt](https://docs.myarc.icu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myarc.icu/gong-neng-pei-zhi/projects.md).

# 项目管理器

当服务器里的菜单、过场动画和组件模板越来越多时，记住每个文件的名字和路径会变得很麻烦。项目管理器把服务端上的全部菜单、Effect 过场动画、可复用分组模板、本地 `.arcpack` 作品包以及菜单市场整合在同一个图形界面里，方便你集中创建、查找、预览、配置和打包分享。

管理员安装客户端 ArcMenu Editor 模组并拥有 `arcmenu.admin` 权限后，在游戏内执行以下命令即可打开项目管理器：

```
/arcmenu projects
```

你也可以在可视化编辑器或 Effect 工作区中随时切换到项目管理器，各个页面之间共享统一的导航栏。

## 项目列表与日常管理

进入\*\*项目（Projects）\*\*页面后，系统会按目录树展示服务器上现有的菜单、Effect 和模板。你可以通过顶部的搜索框按名称过滤，使用每行左侧的复选框、`Ctrl + 点击`、`Shift + 连选` 或 `Ctrl + A` 全选来批量选择项目。双击某一行或按下 `Enter` 即可直接打开对应的编辑器，右键点击则会弹出操作菜单：

* **创建（Create）**：新建一张空白菜单或一个空白 Effect 项目。你可以指定项目 ID、存放的子文件夹路径（由字母、数字、下划线或连字符组成）、画布尺寸与访问权限。
* **配置（Configure）**：无需打开画布，直接修改已保存菜单或 Effect 的全局设置。可修改的参数包括：
  * 画布几何参数：`width`（宽度）、`height`（高度）、`pixels-per-block`（每方块像素密度）与 `distance`（设计基准距离），均需填写 `0` 到 `100000` 之间的正数。
  * `depth-mode`：画布深度模式，可选 `perspective`（透视）或 `layered`（平面分层）。
  * `permission`：打开该菜单或播放该 Effect 所需的权限字符串（留空表示不设额外权限）。
  * 菜单专属项：是否设为主菜单（`main-menu`，填 `true` 或 `false`，影响 `Shift + F` 等主菜单入口）以及自定义打开命令列表（`open-commands`）。
* **编辑（Edit）**：进入该项目的可视化菜单编辑器或 Effect 时间线工作区。如果当前已经有另一个未保存的草稿，界面会提示你先保存或确认放弃草稿。
* **导出（Export）**：将当前勾选的一个或多个菜单、Effect 和模板一起打包成 `.arcpack` 作品包。
* **删除（Delete）**：删除选中的项目（单次最多可批量处理 512 个项目）。删除操作带有事务保护，被移除的原始文件会自动备份在 `plugins/ArcMenu/workspace-backups/<事务ID>/` 下；如果文件写入或重载中途出错，系统会自动回滚恢复原状。

在对某个项目执行配置、导出或删除前，请先保存并关闭该项目正在进行的编辑草稿。

## 分组模板预览与管理

在项目列表中筛选**模板（Templates）**，可以浏览存放在 `plugins/ArcMenu/templates/`（含各级子文件夹）中的全部视觉分组模板。

模板是在菜单编辑器里选中某个 `group` 节点后保存而成的复用组件。在项目管理器里双击某个模板或右键选择**预览（Preview）**，游戏视口就会把该模板居中渲染出来，让你直观查看它的外观和尺寸；按下 `Escape` 或点击返回按钮，即可回到刚才的项目管理器或编辑器状态。

模板可以单独勾选导出，也可以和菜单、Effect 一起打包进同一个 `.arcpack` 中分享给其他服务器。

## 本地包与已安装包

导航栏中的另外两个标签页专门用于管理 `.arcpack` 归档文件：

* **本地包（Packages）**：列出 `plugins/ArcMenu/packs/` 目录下已经导出的本地 `.arcpack` 文件，展示包的标题、版本号、简介和封面图。选中一个本地包后，你可以为它重新截取项目预览图、修改发布标题与简介、一键发布到菜单市场，或者删除本地归档文件（删除本地包不会卸载服务器上正在运行的项目）。
* **已安装包（Installed）**：列出当前服务器已经导入或从市场下载安装的外部作品包。你可以在这里输入文件名导入新的本地包，或者卸载不再需要的包。

## 导出一个作品包的流程

如果你想把做好的菜单和动画备份下来，或者分享给其他服主，只需按以下步骤操作：

1. 保存并退出正在编辑的目标菜单或 Effect 草稿。
2. 在项目管理器的**项目**页面中，勾选要打包的所有菜单、Effect 和模板，点击**导出**。
3. 在弹出的表单中填写包 ID（`1`–`64` 位小写字母、数字、下划线或连字符，需以字母或数字开头）、版本号（如 `1.0.0`）、作品标题和详细说明。如果项目中使用了 CraftEngine 等外部自定义物品或音效，勾选允许外部依赖即可记录依赖提示。
4. 确认导出后，编辑器会在后台自动打开每个项目的纯净画面，按 `1280 × 720` 分辨率截取实机渲染预览图并写入包内（排在第一位的项目预览图会自动作为作品封面）。如果截图过程中按 `Escape` 取消，包文件依然会保留在**本地包**列表中，随时可以点击“准备预览”补充截图。
5. 导出完成后，文件会保存在服务端的 `plugins/ArcMenu/packs/<包ID>-<版本>.arcpack`。你可以直接把这个文件复制到其他服务器导入，也可以在**本地包**页面将它发布到在线市场。

关于跨服导入、目录结构、资源自动合并与市场的详细说明，请继续阅读 [ArcPack 与菜单市场](/gong-neng-pei-zhi/arcpack.md)。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.myarc.icu/gong-neng-pei-zhi/projects.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.