夜城模组管理器

夜城模组管理器

一个适合初学者的《赛博朋克2077》模组管理器,可在下载前检查模组的前置要求,安全安装模组并支持备份与一键还原,还能管理加载顺序。游戏:《赛博朋克2077》(cyberpunk2077)

Night City 模组管理器 — 安装与使用指南

适用于 1.1.0 版本 · 赛博朋克 2077(PC)· 为新手编写

Night City 模组管理器为你安装赛博朋克 2077 模组,在下载前检查每个模组所需的前置,并能一键将游戏恢复为原版。本指南带你从零开始打造一个已装模组的游戏,随后介绍日常使用方法和出问题时的应对措施。

1. 你需要准备

  • Windows 10 或 11,以及赛博朋克 2077(Steam 或 GOG),并已更新到最新补丁。
  • 一个免费的 Nexus Mods 账号(高级会员可选)。
  • Python 3.10 或更高版本。没有也不用担心:启动器会提示为你安装。
  • 推荐:7-Zip(免费)。部分模组以 .rar 文件形式发布,管理器需要 7-Zip 来解压它们。

2. 安装管理器

  1. 下载 NightCityModManager-1.1.0.zip 并解压。建议放在游戏文件夹内,例如 …\steamapps\common\Cyberpunk 2077\NightCityModManager。
  2. 双击 Start Night City Mod Manager.bat。
  3. 如果未安装 Python,窗口会询问“是否立即自动安装 Python 3.12?”。按 Y,等待安装完成,然后再次双击 .bat。
  4. 首次运行时,它会静默安装一个用于处理 .7z 文件的小型辅助程序。之后管理器窗口就会打开。

提示:右键点击 .bat → 发送到 → 桌面(创建快捷方式),即可从桌面启动它。

3. 首次设置

指向你的游戏

如果管理器位于赛博朋克文件夹内,它会自动找到游戏。否则它会询问你:选择赛博朋克 2077 主文件夹(包含 bin、archive 和 r6 的那个)。之后你可以在“设置 → 文件夹”中更改。

连接你的 Nexus 账号

  1. 转到“设置”选项卡。
  2. 点击“获取我的密钥”。浏览器会打开你的 Nexus 账号 API 密钥页面。滚动到底部,复制你的个人 API 密钥。
  3. 将其粘贴到“个人 API 密钥”中,然后点击“保存并检查”。你应该会看到“✓ 已登录为 <你的名字>”。

(未来的更新将用简单的“使用 Nexus 登录”按钮取代此流程。)

让它接管 Nexus 下载按钮

勾选“处理 Nexus 上的‘模组管理器下载’按钮(nxm:// 链接)”。现在,当你在任意赛博朋克模组页面点击“模组管理器下载”时,文件会直接进入管理器。

注意:只有一个程序能占用该按钮。如果你同时使用 Vortex,两者会争抢它,所以请只选择一个管理器。

值得了解的选项(设置 → 选项)

  • 下载完成后自动安装模组:默认开启。
  • 按下“启动”时自动应用更改:默认开启,这样你就不会忘记应用。
  • 控制 .archive 加载顺序:写入 archive\pc\mod\modlist.txt,使你的列表顺序即为游戏的加载顺序。
  • 使用硬链接:当管理器和游戏位于同一驱动器时节省磁盘空间。

4. 安装必备框架(请先完成此步)

大多数赛博朋克模组都建立在六个“框架”模组之上。请先安装它们:

  1. 在“模组”选项卡中点击“获取必备框架…”。
  2. 保持所有缺失项处于勾选状态,然后点击“下载勾选项”。
  3. 免费账号:会为每个框架打开一个 Nexus 页面。在每个页面上点击“慢速下载”,文件就会进入管理器。高级会员:它们会自动下载。
框架 作用
RED4ext 加载插件模组。ArchiveXL、TweakXL 和 Codeware 需要它。
Cyber Engine Tweaks (CET) 游戏内覆盖层、模组菜单和 Lua 模组。
redscript 使脚本模组(.reds 文件)生效。
ArchiveXL 允许模组添加新服装、物品和外观。
TweakXL 允许模组更改游戏数值和记录。
Codeware 许多脚本模组依赖的库。

窗口右上角的条形栏会在每个框架处于活动状态时以绿色显示。

5. 获取模组

添加模组的三种方式

  • 模组管理器下载按钮(最简单):在模组的 Nexus 页面打开“文件”选项卡,点击你想要文件的“模组管理器下载”。
  • 从 Nexus 链接安装…:粘贴模组的页面链接。高级会员会立即开始下载;免费用户会被带到正确的文件处点击下载。
  • 从文件安装…:用于你已下载的 .zip/.7z/.rar 文件。如果文件名来自 Nexus,管理器仍能识别该模组。

请始终选择“主要文件”部分中最新的文件,而不是“旧文件”中的文件。旧版本是脚本错误的头号原因。

前置需求检查

在模组下载之前,管理器会读取其在 Nexus 上的“前置需求”列表,以及这些模组的前置需求。如果有任何缺失,你会看到一个窗口,将每一项显示为:

  • ✓ 已安装:无需操作。
  • ✗ 缺失:已勾选;将随你的模组一起下载。
  • 已安装但已关闭:勾选“开启”以重新启用。
  • ↗ 不在 Nexus 上:DLC 或来自其他网站的下载。点击“页面”查看所需内容。

阅读每一项下方的灰色注释。有时某个前置是可选的。然后点击“获取此模组 + 勾选项”,或者如果你更清楚,点击“仅此模组”。

可能遇到的询问

  • 选择版本:该模组有多个变体(例如不同的体型)。通常只需选择一个。
  • 安装选项:部分模组有自己的安装向导。选择你的选项,点击“下一步”,然后点击“安装”。
  • 已安装:对于较新版本选择“替换(更新)”,对于同一页面上的可选附加文件选择“单独添加”。

如果在管理器最小化时弹出询问,窗口会自动回到前台,状态栏会显示“正在等待你在弹出窗口中的回答…”。

6. 应用并开始游戏

  1. 点击“应用更改”。这会将你启用的模组复制到游戏中。在完成此操作之前,黄色横幅会提醒你更改尚未进入游戏。
  2. 点击 ▶ 启动游戏。如有需要,它会先应用更改。
  3. 首次使用 CET 启动:一个“CET 首次设置”框会要求你设置一个覆盖层按键。点击“未绑定”并按下某个键(~ 键、Insert 或 F1 比较常用)。此后该键将在游戏内打开 CET 菜单。

7. 加载顺序与冲突

  • 当两个模组更改同一内容时,列表中位置更高的模组获胜。将模组向上或向下拖动,或使用“上移 / 下移”。
  • 新模组会被添加到顶部。
  • “冲突”选项卡 → “扫描冲突”会列出所有涉及相同文件的模组对、谁获胜以及共享多少个文件。双击某一行可查看这些文件。许多冲突是有意为之的(补丁和兼容性模组),因此只有在游戏内出现异常时才更改顺序。

8. 日常使用

  • 开启/关闭模组:点击其复选框,或选中它并按空格键。然后应用。
  • 卸载:选中它并按 Del(或点击“卸载”)。然后应用。
  • 检查更新与前置需求:检查你从 Nexus 获取的每个模组是否有更新版本和缺失的前置需求。有更新的模组会显示“有可用更新”。选中一个并点击“更新此模组”。
  • 详细信息面板(右下角):版本、文件数量、模组所需内容,以及其 Nexus 前置需求(带 ✓/✗)。
  • 状态颜色:橙色表示需要注意(缺失前置或重复)。灰色表示该模组已关闭。

9. 游戏更新之后

当赛博朋克更新时,管理器会显示警告。框架(RED4ext、CET、redscript 等)在补丁后通常需要新版本,模组作者通常在几天内发布。

  1. 点击“检查更新与前置需求”,更新任何有新版本的模组,框架优先。
  2. 如果游戏崩溃或显示错误,点击“关闭所有模组” → 应用 → 游玩,然后一次重新开启几个模组。

同时确保游戏本身是最新版本。在 Steam 中,右键点击赛博朋克 2077 → 属性 → 测试版应显示为“无”。新框架拒绝在旧游戏版本上运行。

10. 故障排除

游戏启动时提示“REDScript 编译失败”

  1. 打开 Cyberpunk 2077\r6\logs\redscript_rCURRENT.log。ERROR 行会指出出错的模组和文件。
  2. 如果提示框说某个模组“依赖 Codeware/TweakXL 但你未安装它”,而你实际上已安装,则说明 RED4ext 未运行。检查 red4ext\logs。出现类似“请确保你的游戏已更新到补丁 X”的行,意味着你的游戏已过时:请在 Steam 中更新它。
  3. 如果它列出了某个模组并带有“未解析的类型/引用”错误,该模组通常已过时或为旧文件。请从其“主要文件”中重新安装最新版本。

游戏启动时崩溃

关闭所有模组,应用,并检查游戏能否启动。然后仅启用框架,再以小批量启用你的模组,以找出罪魁祸首。

橙色显示的“需要…”或“与…重复”

需要:安装它列出的内容(获取必备框架…或该模组的前置需求)。重复:同一模组或框架被安装了两次。卸载标记为“重复”的那个。

“赛博朋克 2077 正在运行。请先关闭游戏”

游戏打开时管理器不会更改文件。退出游戏后重试。

无法解压 .rar 或 .7z

安装 7-Zip,然后重试。

完全从头开始

点击“恢复原版游戏”。它会移除管理器添加的所有内容,并还原它替换过的任何原始文件。你的模组仍保留在管理器中,因此你可以稍后再次应用它们。若要获得 100% 干净的游戏,之后使用“设置 → 帮助 → 在 Steam 中验证游戏文件”。

11. 文件位置

文件夹 / 文件 内容
ModManagerData\mods 你已安装的模组,每个一个文件夹
ModManagerData\downloads 已下载的模组文件(可安全删除以释放空间)
ModManagerData\backups 模组替换的原始游戏文件(请勿删除)
ModManagerData\recovered 游戏更改过、被管理器保留而非删除的文件
manager.log 管理器执行的所有操作。寻求帮助时请附上它。
config.json 你的设置和 Nexus 登录信息。切勿分享此文件。

12. 卸载管理器

  1. 先点击“恢复原版游戏”,以免游戏内残留任何模组文件。
  2. 在“设置”中取消勾选“处理‘模组管理器下载’按钮”。如果你之前使用 Vortex,这会将按钮归还给它。
  3. 删除 NightCityModManager 文件夹。

13. 获取帮助

在该模组的 Nexus“帖子”选项卡中发帖,或提交 Bug 报告。请包含你当时在做什么、任何错误的截图,以及你的 manager.log。

Night City 模组管理器与 CD PROJEKT RED 或 Nexus Mods 无关联。赛博朋克 2077 是 CD PROJEKT S.A. 的商标。