6.4 KiB
Mod Manager — 模组、游戏及其文档
Mod Manager 是主菜单中的模组与合集屏幕。在这里可以查看装了哪些模组、了解每个模组的用途、从在线目录安装或更新模组、停用模组，也可以翻看现成游戏的内部构成，弄清它们由哪些模组搭建。
它属于随菜单一起始终加载的外壳，因此在启动任何游戏之前就能使用。
打开方式
在主菜单选择模组与合集。该屏幕有两个标签页：
- 模组 — 游戏认识的所有模组：已安装的和目录提供的。
- 合集 — 现成的游戏，以及每款游戏由哪些模组搭成的结构。
← 菜单返回主菜单。右上角的 ？ 按钮，或按 F1，开启上下文提示：把鼠标悬停在控件上看它的作用，点击可固定提示，按 Esc 退出。
浏览模组
每张卡片显示模组的封面、标题、作者、来源目录、有多少游戏在用它（在 4 个合集中）、状态与版本，以及一个开关。
- 搜索模组... 按标题、作者或标识符过滤。
- 按名称 / 按作者 / 按状态 调整列表排序。
- 左侧的筛选按状态（未安装、已安装、有可用更新、有旧版本可用、本地已修改、已停用）和分类（例如剧情、玩法、视觉、音频、库、引擎、工具）收窄列表。重置清除筛选和搜索。
- 刷新目录下载当前已发布模组的列表。
本地已修改表示已安装的文件与目录上同一版本的副本不一致——例如你正在自己改动的模组。
查看模组介绍
点击卡片打开它的页面：封面、版本选择器、各种操作、来自 manifest 的简短描述，以及模组提供时的文档——一份像这样的完整指南。
文档是已安装版本的指南。如果在版本选择器里选了别的版本，提示会提醒你：下面的指南仍属于已安装的那一版。
文档语言。 文档标题右侧的选择器默认为自动 · 界面语言：指南跟随游戏界面语言。若模组没有该语言的指南，管理器会先显示模组的默认指南，再退回英文，最后退回第一份可用的指南；指南上方一行会标明实际显示的语言（例如 EN）。你也可以自己在选择器里挑语言。没有任何指南的模组会继续显示 manifest 描述。
给模组作者：把指南放进 docs/en.md（译文放 docs/<语言>.md，或 docs/default.md），图片放在旁边，例如 docs/assets/screen.png，以 assets/screen.png 引用。查看器支持标题、段落、列表、引用、代码块、链接和 PNG/JPEG/WebP 图片；不会运行 HTML、表格或动画。
安装、更新、停用、删除
模组页面上的按钮和卡片上的开关：
- 安装 / 更新 / 降级 / 重新安装把所选版本从目录下载到你的用户目录（
user://mods/）。 - 停用 / 启用（或卡片上的开关）决定模组是否被加载。停用的模组保留文件和存档中的数据。
- 删除在确认后移除一个下载来的模组。
任何一项操作之后都会出现横幅：重启游戏后更改才会生效。Mod Manager 自己无法在自己的屏幕上被删除或停用。
已安装不等于在用。 游戏只加载它合集里列出的模组，外加菜单外壳。安装只是让模组可用；只有当游戏的合集包含它时，它才会进入游戏。
游戏与合集
合集标签页首先展示现成的游戏。游戏就是一个合集：一组有名字的模组，加上起始地点。
卡片会告诉你游戏需要的东西是否都装齐了（可以开始游戏，或缺少 N / 安装（N） / 启用（N））。一个按钮即可安装或启用缺失内容。编辑结构打开游戏的内部构造；＋ 打造你自己的游戏从新建合集开始。
游戏的结构
结构图展示游戏的机制（诸如 Story、Assets、2D engine 的区块）和其中的模组。箭头从依赖指向需要它的模组。卡片位置和区块只是用于阅读：它们不决定加载顺序。
选中一个区块或模组，它就会出现在检查器里。在那里可以修改游戏要求的版本：任意版本、不低于、精确版本、版本分支（^1 接受任何 1.x）等。这是游戏的要求，不是你已安装的版本。检查列出问题；计划显示应用该合集会安装或启用什么。
结构图的其他按钮：+ 机制和添加模组修改游戏，复制生成你自己的副本（并提议一并复制存档），JSON显示原始定义，保存和重置保留或放弃更改，应用合集安装并启用计划中列出的内容。改过的内置游戏可用恢复内置版本还原；存档保留。
对游戏的更改在下次启动时生效。游戏的存档在模组变动后依然可用：离开游戏的模组数据被单独保存，随模组回归。
出现问题时
- 某个模组没有进入游戏。 检查它是否已启用、游戏的合集是否包含它（打开编辑结构）。
- “安装失败”。 检查网络连接，再点一次刷新目录。
- 游戏卡片显示缺少或有 问题。 打开它的结构和检查标签页：里面列出缺失的模组、版本差距和冲突。
- 目录冲突。 同一模组同一版本被两个目录以不同内容发布；相信你信任的那个目录。
- 没有文档区。 该模组还没有
docs/指南；此时显示的是 manifest 描述。