ModGate

[size=6][b]ModGate[/b][/size]
[i]你的世界。你的模组。[/i]

[b]让 ModGate 为你完成大部分安装设置。[/b]加入一个 Valheim 服务器，然后一键从支持的来源下载其所需的模组。ModGate 会检查你需要什么、找到对应的软件包、复用已安装的匹配模组，并准备好你的服务器配置文件。你审阅结果、安装并重启，然后再次加入。

保留[b]四个服务器配置档和一个离线配置档[/b]，每个都有各自的模组和配置。切换服务器时，你保存的设置即可随时激活。

[b]服务器和每位加入的玩家都必须安装 ModGate。必须事先安装 BepInEx。[/b]玩家需要先装好 ModGate，下载提示才会出现；服务器无法把这一连接器安装到未修改过的游戏中。

[size=4][b]玩家为何需要它[/b][/size]
[list]
[][b]一键下载服务器所需的全部模组。[/b]对于受支持的软件包，ModGate 会完成检查、软件包查找、下载和配置档准备工作。你不必逐个查找并下载每个模组，也不用依赖整合包。[/]
[][b]大部分工作自动完成。[/b]匹配的已安装模组会被复用，你的服务器设置会被保存。审阅更改，选择 [b]安装并重启[/b]，在游戏重新启动后重新连接。[/]
[][b]保留你的选择。[/b]选择你想要的可选模组和建议依赖项，然后将这些选择及适用的配置保留在该服务器的配置档中。[/]
[][b]轻松切换设置。[/b]激活四个已保存的服务器配置档之一，或返回离线配置档。配置档检查、修复和还原点可在需要时帮助你恢复已保存的设置。[/]
[/list]自动下载使用受支持的 Thunderstore 和 Hexium 软件包。[b]Nexus 下载仍需手动进行：[/b]ModGate 会打开由服务器所有者提供的下载页面。未解析的软件包需要先处理，才能下载。

[size=4][b]服务器所有者为何需要它[/b][/size]
[list]
[][b]让你的玩家轻松加入。[/b]ModGate 会分享你的要求，并通过游戏内下载提示完成他们大部分的安装工作。[/]
[][b]让 ModGate 维护检测到的模组列表。[/b]它会发现已安装的插件并查找受支持的下载。你审阅分类结果并修正任何未解析的映射。[/]
[][b]自定义你服务器的规则。[/b]选择必需和可选模组，让仅服务器模组不进入玩家下载，并指定玩家仅在客户端需要的模组。[/]
[][b]选择玩家能否自带客户端模组。[/b]允许额外的客户端模组，或限制玩家只能使用你批准的列表。你的必需模组规则仍然适用。[/]
[][b]控制版本和更新。[/b]要求你指定的版本或允许更新的客户端版本。启动时为所有模组或选定模组启用符合条件的服务器更新。[b]自动更新默认关闭。[/b][/]
[][b]在游戏内管理设置。[/b]经授权的管理员可以编辑受支持的服务器配置，并通过 ModGate 查看服务器健康状况。[/]
[/list]
[size=4][b]玩家的首次加入[/b][/size]
[list=1]
[]安装 ModGate，并通过你常用的 BepInEx 设置启动 Valheim。[/]
[]加入一个同样运行 ModGate 的服务器。如果你的设置不同，ModGate 会显示所需更改。[/]
[]必需模组已预先选中。选择你想要的任何可选模组和建议项，然后按 [b]下载并审阅[/b]。ModGate 会检查软件包、从受支持的来源下载所需内容，并为你准备好配置档。[/]
[]选择 [b]安装并重启[/b]，或安排在你下次启动时安装。Windows 可以自动重新启动 Valheim；其他启动器可使用手动重启。[/]
[]重启后再次加入服务器。ModGate 会在每次加入时检查当前要求。[/]
[/list]ModGate 会保存服务器配置档以供将来使用。按 [b]Shift+F6[/b] 打开面板、编辑配置档、选择其他设置或激活离线配置档。对已加载模组的更改在重启后生效；Valheim 不会自动重新连接。

[size=4][b]安装[/b][/size]
服务器和每位玩家都需要[b]相同版本的 ModGate[/b]。每次安装都需要以下两个组件：
[code]BepInEx/plugins/ValheimModGate/ValheimModGate.dll
BepInEx/patchers/ValheimModGate/ValheimModGate.Preloader.dll[/code]手动安装时，请关闭游戏或停止服务器，然后将软件包中的 [b]BepInEx[/b] 文件夹复制到对应的 Valheim 安装目录并合并文件夹。升级时保留现有配置和配置档。预加载器 DLL 应放在 [b]patchers[/b] 中，而不是 plugins。

模组管理器可以在 plugins 和 patchers 下使用各自的作者/软件包文件夹。请继续启动同一个外部管理器配置：ModGate 的五个配置档属于该安装，而加载器设置和补丁程序保持全局。

[b]BepInEx 是前提条件。[/b]使用 ModGate 前请单独安装它。ModGate 不会安装或更新 BepInEx，包括当另一个模组将其列为依赖项时。

[size=4][b]服务器设置[/b][/size]
在安装了两个 ModGate DLL 的情况下启动一次服务器。其检测到的模组列表维护在：
[code]BepInEx/config/ModGate/server-mods.json[/code]在邀请玩家之前，请审阅分类并解决任何缺失的下载映射。[b]side[/b] 字段接受：
[list]
[][b]required[/b] — 加入的玩家也需要的必需服务器模组。[/]
[][b]optional[/b] — 玩家可以选择是否包含它。[/]
[][b]serverOnly[/b] — 在服务器上运行，从不提供给玩家。[/]
[][b]clientOnly[/b] — 玩家必需；其常规插件实例在专用服务器上被抑制。[/]
[/list]新发现的名称中包含 "Server Side" 或 "Serverside" 的模组默认设为仅服务器。请审阅列表：名称无法可靠地确定每个模组的预期角色。现有的所有者分类会被保留。

对于没有自己软件包文件夹的散装 DLL，请将原始软件包的 [b]manifest.json[/b] 放入 [b]BepInEx/config/ModGate/manifests/[/b] 下生成的文件夹中。每个文件夹标识真实的插件 GUID。软件包元数据有助于查找；已安装的 DLL 仍然是插件身份和版本的权威依据。

随附的 [b]docs/SERVER-OWNER-GUIDE.md[/b] 说明了下载映射、版本选择、更新和管理员访问。[b]server-mods.example.json[/b] 是参考示例，并非你服务器的现成列表。

[size=4][b]不止于下载[/b][/size]
[list]
[][b]按配置档的配置：[/b]编辑受支持的 BepInEx 设置、在创建配置档时复制适用的设置，或在配置档之间同步它们。配置文件会在各自的按钮下方展开。从磁盘重新加载受支持的运行中模组配置。[/]
[][b]恢复：[/b]配置档检查、定向修复、还原点、设置日志、重试控件和支持报告。覆盖可以继续不完整的准备工作，但无法让缺失的依赖项加载，也无法强制服务器接受它。[/]
[][b]记住的密码：[/b]Windows 可以在成功加入后记住服务器密码。此功能默认启用，可以禁用。保存的密码使用 Windows 帐户加密。[/]
[][b]服务器管理：[/b]现有的管理员列表成员资格加上所有者签发的访问代码，保护远程配置和健康状况。查看服务器 CPU/内存、请求延迟和抖动、网络流量、玩家、会话运行时间和更新时间。不支持的测量值显示为不可用；不收集 GPU 和温度。[/]
[][b]清晰的控制：[/b]配置档侧边栏、单独的模组详情选项卡、可见的进度和错误报告链接。ModGate 窗口打开时会阻止游戏操作和相机输入。[/]
[/list]
[size=4][b]安装保护措施[/b][/size]
[list]
[]下载内容单独暂存，安装前由玩家审阅和批准。[/]
[]HTTPS、证书验证和提供商主机检查适用于下载重定向。[/]
[]拒绝压缩包路径遍历、符号链接和冲突的目标位置。拒绝下载命令脚本、可执行文件以及加载器/核心/补丁程序安装器；软件包无法覆盖 ModGate 的策略。[/]
[]逐文件 SHA-256 暂存回执在激活前会再次检查。缺失、被篡改、重复或未列出的暂存文件会被拒绝。[/]
[]日志化的配置档更改、回滚、备份和还原点支持恢复。加载器设置受到保护。[/]
[]远程管理工具需要服务器验证的管理员成员资格和所有者密钥身份验证，并具备会话绑定、重放保护和速率限制。[/]
[/list]这些检查保护安装完整性。模组仍以游戏权限运行代码，因此只接受来自你信任的服务器的下载。ModGate 不会更新自身或 BepInEx。

[size=4][b]来源、兼容性和实际限制[/b][/size]
自动设置使用受支持的 Thunderstore 和 Hexium 软件包。你可以选择首选来源顺序；明确的服务器软件包固定项会保留其来源。Nexus 条目会打开所有者提供的下载页面供手动安装。ModGate 不会将任意模组文件直接从服务器复制给玩家。

匹配列表只是安装检查，并不保证每种模组组合都能协同工作。缺失的硬依赖项仍可能导致 BepInEx 无法加载某个模组。更新的替代版本无法绕过服务器的版本策略。

Windows 支持自动重新启动和加密密码存储。其他启动器/平台可以使用常规密码输入和手动下次启动选项。可用磁盘空间限制了你能够保留的配置档副本、下载内容和还原点的数量。

[b]版本 0.4.4 是早期版本。[/b]自动化测试覆盖了设置和恢复逻辑；实际渲染、主机权限和模组交互仍需要在你自己的环境中验证。

[size=4][b]帮助、错误报告和源代码[/b][/size]
打开 [b]活动[/b] 或 [b]打开设置日志[/b] 查看准备详情。报告问题时，请附上 ModGate 版本、确切错误以及你当时正在做什么。面板可以生成支持报告；请勿分享密码或你服务器的管理员访问密钥。

[url=https://discord.gg/AaVzBfPcYH]在 Discord 上报告错误或获取帮助[/url]
[url=https://github.com/octerockman/ModGate]GitHub 上的源代码[/url]
[url=https://github.com/octerockman/ModGate/releases/tag/v0.4.4]版本 0.4.4 发布[/url]

MIT 许可。Valheim 由 Iron Gate 开发；ModGate 是一个独立的社区模组。