Tobey的Subnautica Below Zero BepInEx包

Tobey的Subnautica Below Zero BepInEx包

BepInEx 是一个通用的 Unity 模组框架。这是为《深海迷航：零度之下》准备的 BepInEx 包，已预先配置，可在 Windows、macOS 和 Linux 系统上直接使用——包括 Steam Deck 掌机！

实用工具

Tobey的Subnautica Below Zero BepInEx包预览查看大图

Tobey的BepInEx包，适用于《深海迷航：零度之下》

这是一个为《深海迷航：零度之下》准备的BepInEx整合包，已预先配置，可在Windows、macOS和Linux系统上直接使用——包括Steam Deck掌机！

BepInEx 是一个通用的 Unity 模组制作框架。BepInEx 包含了工具和库来：

  • 在游戏启动时加载自定义代码（以下简称插件）；
  • 修补游戏内的方法、类甚至整个程序集，无需修改原始游戏文件；
  • 配置插件并将游戏日志输出到指定目标，如控制台或文件；
  • 管理插件依赖项。

BepInEx 是目前 GitHub 上最受欢迎的 Unity 模组工具之一。

此包内容

该整合包已预先配置，可直接用于《深海迷航：零度之下》的模组制作。

特别是，这个包附带：

  • Tobey.Subnautica.ConfigHandler，一个可配置的BepInEx补丁程序，用于自动处理BepInEx配置，以实现与旧版本游戏（例如QModManager）模组的向后兼容性。
  • Tobey.UnityAudio，一个可配置的BepInEx补丁程序，用于在模组需要时自动添加Unity音频支持。还包括一个预配置的Tobey.UnityAudio.cfg，用于《深海迷航：零度之下》。
  • Tobey.FileTree，一个可配置的BepInEx插件，用于记录游戏的文件树以帮助排查问题。
  • Tobey.BepInEx.Timestamp，一个可配置的BepInEx补丁程序，用于记录当前时间戳。
  • Tobey.BZMacProcessFix，一个BepInEx补丁程序，允许具有进程过滤器SubnauticaZero的BepInEx插件在macOS上加载——macOS用户终于可以运行QModManager了！

与QModManager的兼容性

基本总结是QModManager与BepInEx兼容，但有一些需要注意的事项。

简易自动安装

💬 重要 仅安装此包，你在游戏中将看不到任何变化！ 检查文件 SubnauticaZero > BepInEx > LogOutput.log 以确定 BepInEx 是否已加载。

Windows (Vortex)

Vortex是一款用于在Windows上安装和管理模组的工具。它可以为《深海迷航：零度之下》及其他游戏安装各种模组，包括此整合包。

  1. 如果您尚未安装Vortex Mod管理器，请先安装。确保它已完全更新至最新版本。
  2. 点击页面顶部的Vortex按钮进行安装。
  3. 检查Vortex右上角的🔔通知区域：
    • 如果你安装了QModManager，Vortex可能会通知你重新安装/卸载QModManager。按照提示操作即可。
    • 如果你看到通知显示“需要提升权限才能部署”，请点击“提升”并授权提升权限。
    • 如果你看到任何其他通知显示“需要部署”或类似内容，请点击“部署”。
  4. 运行游戏。

macOS (gib)

gib 是一个命令行工具，用于在 macOS 上自动化安装 BepInEx，因为手动安装相当繁琐且容易出错。gib 让安装变得简单，并且拥有手动安装无法获得的额外功能！

  1. 从文件选项卡下载适用于《深海迷航：零度之下》的Tobey's BepInEx Pack。如果您的浏览器没有自动解压，请确保在下载文件夹中解压该文件。
  2. 使用 Launchpad 或 Spotlight 打开终端（按下 ⌘ 空格，输入 terminal，按 Enter）。
  3. 从 [gib README](链接到gib README) 的 Usage 部分复制命令，用 ⌘ V 粘贴到终端中，然后按 Enter 键运行它。
  4. 如果你遇到困难，请参考 gib README 获取帮助。

手动安装

Windows 快速入门

将存档解压到游戏文件夹中，如果提示则替换任何文件，运行游戏一次以生成所有需要的文件和文件夹，然后在主菜单退出游戏，你就可以开始游戏了。

如果事情没有按计划进行，或者你需要进一步的指导，请参考下面的完整说明。别担心，它看起来比实际要难。请不要略读！

Linux 和 Steam Deck 掌上设备的快速入门指南

与Windows相同，但请先遵循以下完整说明中的步骤4。

对于Steam Deck掌机，请切换至桌面模式以遵循说明。一旦全部设置完成，您将可以根据喜好，在桌面模式或游戏模式下畅玩模组。

macOS 快速入门

强烈建议macOS用户使用gib进行安装，因为手动安装过程极其繁琐且容易出错。

如果你是一个喜欢自虐的人，并且决心手动安装，请遵循macOS安装傻瓜指南。

适用于 Windows、Linux 和 Steam Deck 掌机的完整说明

💡 提示 游戏文件夹是包含游戏可执行文件的文件夹（例如 SubnauticaZero.exe）。 Steam用户可以通过在Steam库中右键点击游戏，选择“管理”>“浏览本地文件”来找到此文件夹。

  1. 从文件选项卡下载适用于《深海迷航：零度之下》的Tobey's BepInEx Pack。
  2. 确保游戏未在运行。
  3. 将下载的压缩包内容解压到游戏文件夹中。如果系统提示，请替换任何文件。

ℹ️ 这仅仅意味着打开 .zip 文件（例如双击它），然后将文件和文件夹拖放到游戏文件夹中！

如果操作正确，你的SubnauticaZero文件夹内部应该看起来像这样（粗体条目来自该整合包）：

⚠️ 此列表仅供参考，并非详尽无遗，还会有其他内容，请不要删除任何内容！

  • BepInEx
  • SubnauticaZero_Data
  • doorstop_config.ini
  • SubnauticaZero.exe
  • winhttp.dll

⚠️ 如果您缺少任何这些文件或文件夹，您可能安装到了错误的位置，这个包将无法工作。

  1. 如果您在Windows上玩，请跳过此步骤！

Linux 和 Steam Deck 掌机用户：请前往您的 Steam 库，右键点击游戏，选择“属性...”，并设置启动选项：

WINEDLLOVERRIDES="winhttp=n,b" %command%

⚠️ 如果您在Windows上玩游戏，请不要设置启动选项！ ℹ️ 如果愿意，Linux 用户也可以为游戏设置 Wine 配置（winecfg），通过“库”选项卡添加 winhttp 作为 DLL 覆盖。如果适用，请移除启动选项。完整说明请见此处。

  1. 像平常一样运行游戏。

请注意，如果您在Steam上拥有这款游戏，应始终通过Steam启动——不要直接运行.exe文件（也不要通过.exe的快捷方式启动），因为直接启动.exe文件会导致BepInEx出现问题。您可以在Steam中右键点击游戏，选择"管理" > "添加快捷方式到桌面"，来设置一个兼容BepInEx的桌面快捷方式。

同样的情况可能适用于其他平台，例如Epic Games Launcher、Microsoft Store等。

使用Vortex启动游戏应该也没问题。

  1. 在主菜单退出游戏。

假设你已经正确遵循了这些指示，在SubnauticaZero > BepInEx文件夹中现在会有一个名为LogOutput.log的文件（或者简称为LogOutput - 它们是同一个东西）。这是你的日志文件，每次游戏运行时都会重新生成，其中包含关于你已安装模组的技术和诊断信息，以及游戏过程中可能发生的任何错误。这对于故障排除非常有用，建议在寻求模组帮助时分享它。它相当于你可能熟悉的BepInEx控制台窗口，包含所有相同的信息。

如果缺少此文件，通常意味着您没有正确安装该包，您可能需要从头开始重新尝试。请务必仔细阅读说明，不要略过任何步骤。

否则，您现在可以根据以下部分安装模组。

💬 重要 仅安装此包，您在游戏中将看不到任何变化！ 检查文件 SubnauticaZero > BepInEx > LogOutput.log 以确定 BepInEx 是否已加载。

安装模组

请参阅README的安装模组部分，了解如何安装模组的参考指南。

模组作者的有用链接

问题、疑问等

首先，请确保检查您要查找的答案是否已在此页面的某个地方。使用 Ctrl+F 搜索关键词。

其次，查看常见问题解答，看看那里是否有答案。

如果没有，您可以通过以下渠道寻求帮助：

许可

通过本页面可下载的BepInEx包包含以下项目的二进制文件，这些文件未经修改且根据其许可证重新分发：