如何在 Cyberpunk 2077 中安装 Mod（2026）

一篇关于如何在PC上为Cyberpunk 2077****安装模组的指南。我们会介绍两大模组管理器:Vortex和Mod Organizer 2 —— 以及手动安装模组的方法(manual installation)。

本指南聚焦于通过Steam、GOG或Epic Games运行的Cyberpunk 2077Windows版本。

Cyberpunk的模组生态花了一段时间才稳定下来,但如今已经相当成熟。问题在于,大多数模组都依赖于某个框架,而不是直接放进去就能用的文件,所以安装顺序很重要。为了讲得更实际一些,我们会通过每一种方法来安装Cyber Engine Tweaks (CET)以及一个叫做Better Loot Markers的小模组,因为这个模组依赖该框架,恰好能展示两者之间的关系是如何运作的。

前置需求

• 一份PC版的Cyberpunk 2077(Steam、GOG或Epic Games)。
• 7-Zip或其他任意解压软件。
• 一个免费的Nexus Mods账号(可选,但你会想要一个)。
• Microsoft Visual C++ Redistributable —— 没有它CET无法加载。
• 对在Windows上复制和移动文件有基本了解。

Cyberpunk模组究竟是怎么运作的

这一部分绊倒了不少人,所以在你下载任何东西之前很值得先了解一下。大多数Cyberpunk模组并不是独立运作的——它们需要先安装一个框架,而主要的框架有两个,各自负责完全不同的工作。

Cyber Engine Tweaks (CET)

Cyber Engine Tweaks是一个脚本框架兼游戏内控制台。它注入到游戏中,为模组作者提供Lua脚本支持、控制台、TweakDB编辑器,以及一个供模组挂载设置菜单的覆盖层(overlay)。

大量提升体验(quality-of-life)的模组,包括我们的示例模组,都是CET模组。它们放在bin\x64\plugins\cyber_engine_tweaks\mods\里,如果没有安装CET就完全不会起作用。

• 阅读REDmodding wiki上的官方安装说明。
• 你需要安装Microsoft Visual C++ Redistributable。
• 以**无边框(Borderless)或窗口化(Windowed)**显示模式运行游戏。全屏模式已知会导致CET覆盖层不显示的问题。
• 首次启动时,CET会要求你为覆盖层绑定一个热键。常见选择是`、F10或*。

REDmod

REDmod是CD Projekt Red自家的模组工具包,随1.6更新以免费DLC的形式发行。它负责处理修改游戏archive、脚本、tweaks、音效和动画的模组,并为你提供正规的加载顺序(load order)。

你可以从你拥有本游戏的任何平台获取它。

• Steam
• GOG

注意 —— CET和REDmod并不是互相替代的选项。很多配置都需要同时用到两者。安装你的模组实际要求的那些即可。

备份你的存档文件!

在安装任何东西之前,先备份你的存档。涉及脚本或tweaks的模组可能会把自身内容固化进存档里,之后移除它们并不总能干净地撤销这种影响。

你的存档位于以下文件夹中。

C:\Users\<username>\Saved Games\CD Projekt Red\Cyberpunk 2077

把这个文件夹复制到安全的地方。它体积很小,只需几秒钟。

提示 —— 在开始之前,记下你的游戏目录也很值得。在Steam上通常是steamapps\common\Cyberpunk 2077,你可以通过右键游戏 -> 管理(Manage) -> **浏览本地文件(Browse local files)**快速找到它。

从哪里下载模组

• Nexus Mods —— 几乎所有Cyberpunk模组都在这里。
• TMC —— 我们自己,不过还很新,目前也没什么可展示的!
• Cyberpunk 2077 Modding Community Discord —— REDmodding社区,寻求帮助的最佳去处。
• REDmodding Wiki —— 工具和框架的文档。

提示 —— 安装前请读完整个模组说明,包括需求部分。相比其他游戏,Cyberpunk的模组更频繁地依赖框架,而“它不起作用”几乎总是因为缺少某个前置条件。

我们的示例模组:CET与Better Loot Markers

Better Loot Markers为战利品容器标记添加了额外细节,让你在走过去之前就能看到里面有什么。它体积小,效果一看就明显,而且需要CET——这使它非常适合用来演示一个框架和一个模组是如何协同工作的。

以下是模组页面Installation部分的说明。

如上所示,作者提到了两点:需要CET v1.37.1+,以及模组内容要放进\path\to\Cyberpunk 2077\bin\x64\plugins\cyber_engine_tweaks\mods\。下面的每一种方法本质上都只是达到这同一结果的不同途径。

通过Vortex安装模组

Vortex是Nexus Mods官方的模组管理器,也是大多数人用来在Cyberpunk 2077中安装模组的方法。

它底层的运作方式是在游戏目录中创建硬链接(hard links),而不是把文件直接复制进去,所以你可以启用和禁用模组,而不会永久改动你的安装。

如果你还没设置好Vortex,或者想了解更多,我们有两篇专门讲Vortex的指南。

• 如何下载并安装 Vortex
• 如何使用 Vortex 及基础操作

重要提示 - Vortex 的模组暂存文件夹需要与你的游戏安装目录位于同一磁盘下，因为硬链接（hard link）就是这样工作的。Vortex 曾就此警告过我，并提出自动修复，它确实修复了，但很不幸，之后我还是得重新安装我的模组才能让它们真正生效。如果你遇到这种情况，请直接重新安装，不要假设仅仅移动文件夹就足够了。

在 Vortex 中管理 Cyberpunk 2077

首先你需要让 Vortex 来管理这款游戏。

1. 点击 Games 标签页：从侧边栏打开 Games 页面。
2. 搜索 Cyberpunk 2077：在搜索栏中输入 cyberpunk。
3. 点击 Manage 按钮：将鼠标悬停在 Cyberpunk 2077 图块上，点击 Manage。

Vortex 对 Cyberpunk 的支持是通过社区扩展提供的，而非内置功能，所以你第一次这样做时会看到一个提示。

1. 下载 CP2077 插件：点击 Download。Vortex 会获取该扩展并要求你重启，重启之后再继续操作。

注意 - Vortex 中 Cyberpunk 图块上标有 COMMUNITY 字样，这只是说明该扩展由社区维护，而非官方出品。这是通过 Vortex 为 Cyberpunk 打模组的标准方式，运作良好。

安装 REDmod DLC

一旦 Vortex 开始管理该游戏，它会检查你是否安装了 REDmod DLC，如果没有会提醒你。

1. 点击按钮安装 REDmod（推荐）：点击 Get REDmod。它是免费的，只需一分钟，而且很多模组都需要它。如果你确定自己的模组都不需要 REDmod，可以点击 Ignore，但直接安装它也没什么坏处。

此阶段你可能还会看到 Deployment not possible 或 Mods can't be deployed 的提示。这些通常会在扩展安装完成并重启 Vortex 后自行消失——如果没有，点击 Fix 并按提示操作（这通常就是前面提到的暂存文件夹不在同一磁盘的问题）。

通过 Vortex 下载模组

前往 Nexus Mods 上的 Cyber Engine Tweaks 模组页面。

1. 点击通过 Vortex 安装：橙色的 Vortex 按钮会直接将下载任务交给该应用。这是你想要的那个。
2. 点击手动下载：Manual 按钮会改为通过浏览器下载压缩包。我们会在后面的手动安装部分用到它。

你的浏览器会请求打开 Vortex 的权限。

1. 按需勾选：勾选 Always allow，这样浏览器就不会每次下载模组时都再询问了。
2. 点击通过 Vortex 下载并安装：点击 Open Vortex。

现在在 Better Loot Markers 页面 上做同样的操作。因为该模组声明了 CET 为前置需求，Nexus Mods 会提议一次性获取两者。

1. 点击下载 CET 和模组：点击 Download。前置需求会列在下方——这里是标注了作者说明 1.32.0 的 Cyber Engine Tweaks。如果你在上一步已经安装了 CET，Vortex 会直接跳过它。

管理已安装的模组

现在两个模组都会出现在 Mods 页面上。

1. 模组状态：下拉菜单可让你启用、禁用和卸载每个模组。
2. 移除/卸载模组：Remove 旁边的箭头会打开包含更多选项的操作菜单。
3. 切换列显示：齿轮图标控制列表中显示哪些列。

Status 下拉菜单提供三种状态。

• Enabled - 模组处于激活状态，会被部署到你的游戏中。
• Disabled - 模组仍安装在 Vortex 中，但不会被部署。这是排查是哪个模组导致游戏出问题的最快方法。
• Uninstalled - 移除已安装的文件，但保留下载的压缩包。

操作菜单涵盖了其余的所有功能。

• Reinstall - 再次运行安装程序。
• Remove related - 移除该模组及与其关联的所有内容。
• Check for Updates - 向 Nexus Mods 查询是否有新版本。
• Manage File Conflicts - 当两个模组写入同一个文件时解决冲突。
• Open in File Manager - 打开该模组的暂存文件夹。对排查 CET 问题非常有用。
• Open Archive - 打开下载的压缩包。
• Refresh Content - 重新读取该模组的文件。
• Create Report - 生成一份关于该模组的报告，在寻求帮助时很有用。
• Open on Nexus Mods - 在浏览器中打开该模组页面。

加载顺序

Load order 页面用于控制哪些 REDmod 优先加载。

Vortex 在右侧解释了这些规则,值得认真读一读。要点如下。

• 只有 REDmods 和已自动转换的旧版 mod 才能排序。我们的两个示例 mod 都是 CET mod,所以这里的列表是空的。
• 你不需要给所有 mod 排序——只需要排序那些有要求或你知道会冲突的 mod。
• 未自动转换的旧版 .archive mod 总是先于所有 REDmod 加载,按字母顺序排列。
• 加载顺序会自动保存,并在 Vortex 下一次部署时生效。
• 涉及 tweak 或脚本 mod 时,REDmod 部署可能需要一些时间,所以在启动游戏前请等待绿色的成功提示。

注意 - 如果你刚安装的 mod 没有出现在这里,点击刷新。另外,如果你用 redMod.exe 或 WolvenKit 在 Vortex 之外部署 REDmod,Vortex 是不会察觉这些变化的。

工具

工具页面列出了与游戏一起运行的外部程序和启动选项。

1. Launch Game with REDmods Enabled - 以启用 REDmod 支持的方式启动游戏。如果你在使用 REDmod,这通常是你要选的那个。
2. REDLauncher (GOG/Steam/Epic) - 打开 CDPR 自家的启动器。
3. REDmod Deploy Latest Load Order - 在不启动游戏的情况下按需运行一次 REDmod 部署。
4. CyberCAT Save Editor - 一个存档编辑器,如果你安装了的话。

你可以用图钉图标将最多五个工具固定到左侧菜单,并通过工具框右上角的 + 按钮添加自己的工具。

偏好设置

偏好设置页面包含 Cyberpunk 专属的 Vortex 设置。

1. V2077 Settings:适用于 Cyberpunk 2077 全局的偏好设置。
2. Mods:适用于单个 mod 的偏好设置。

这里有两个值得了解的开关。

• Automatically convert legacy-style '.archive' mods to REDmods on install - 除非你确定需要,否则请保持关闭。Vortex 自己也标注为不推荐。它只有在你需要用旧的 archive mod 覆盖某个 REDmod 时才真正有用,因为旧版 archive 本来就总是最先加载。
• Don't prompt when reaching the fallback installer - 当 Vortex 无法自行判断某个 mod 的结构时,阻止它询问该怎么做。一旦你熟悉操作后会很方便,但在此之前不太建议开启。

健康检查

健康检查页面会审查你的配置并标出问题。

1. Status is healthy:绿色的 Health check passed 表示 Vortex 对你当前的配置没有意见。如果有问题,它会在这里告知并解释如何解决,这也是你在深挖日志之前应该先查看的地方。

通过 Mod Organizer 2 安装 Mod

Mod Organizer 2 是另一款主流 mod 管理器,它的工作方式与 Vortex 不同。MO2 不会将文件硬链接进游戏文件夹,而是使用虚拟文件系统——游戏能看到这些 mod,但你真正的安装目录不会被改动。有些人非常喜欢这一点。

MO2 还使用**实例(instances)**的概念,每个实例是针对某个游戏的一整套独立的 mod、下载、配置文件和设置。你可以随意在它们之间切换。

我们不会在这里通过 MO2 安装示例 mod——本节的目的只是向你展示 MO2 支持 Cyberpunk,并带你完成较为繁琐的设置过程。

下载 MO2

从 GitHub releases 页面获取最新版本。

1. 安装程序方式(推荐):Mod.Organizer-<version>.exe 是常规安装程序,大多数人应该用这个。
2. 压缩包中的完整应用:Mod.Organizer-<version>.7z 是便携版。你需要自己解压,并从存放位置运行它。

注意 - MO2 也在 Nexus Mods 上有发布,由于历史原因被归类在 Skyrim Special Edition 下。这其实是同一个应用程序,除了 Skyrim 之外还支持很多其他游戏。

创建实例

首次启动时,MO2 会引导你创建一个实例。

1. 阅读后点击下一步:开场说明会解释什么是实例。点击下一步。

1. 点击 Cyberpunk:MO2 会扫描已安装的游戏,通常能自动找到 Cyberpunk 2077 及其路径。
2. 其他受支持的游戏:MO2 检测到的其他游戏。
3. 如果没有显示可以尝试:如果没被检测到,可以用**浏览...**手动指向你的游戏文件夹。

1. 如果需要可以更改名称:为实例命名。默认名称就够用,但如果你打算创建多个实例,像 Cyberpunk 2077 Modding 这样的名字会更清晰。
2. 点击下一步:继续。

关联你的 Nexus Mods 账号

接着 MO2 会提示与 Nexus Mods 关联,这样你就能直接在应用内下载 mod 并检查更新。

1. 通过浏览器链接（推荐）：Connect to Nexus 会打开你的浏览器并自动完成所有操作。
2. 使用 API 密钥链接：如果你更愿意粘贴 Nexus Mods 账户设置中的密钥，选择 Enter API Key Manually。

选择浏览器方式会打开一个授权页面。

1. 点击以将 MO2 链接到 NexusMods：点击 Authorise。

看到成功提示后，你可以关闭浏览器标签页并切换回 MO2。

1. 成功：MO2 会记录每一步，并以 Linked with Nexus successfully 结束。点击 Next。

1. 如需可更改：此文件夹保存该实例的下载内容、模组、配置文件和覆盖数据。如果该驱动器空间充足，默认位置即可；否则请选择一个空间充裕的位置。
2. 点击下一步：继续。

1. 若无错误则点击完成：查看摘要信息并点击 Finish。保持 Launch the new instance 选项勾选。

首次运行时，你还会收到一个教程提示。

如果你之前从未使用过 MO2，点击 Yes。这个教程简短，而且比截图更能说明界面的用法。

MO2 界面

这是实例启动运行后 MO2 的界面样子。

左侧面板是你的模组列表和优先级顺序，右侧面板有 Data、Saves 和 Downloads 三个标签，右上角的下拉菜单用于选择 Run 按钮启动的可执行文件。底部的 Log 面板是出问题时首先要查看的地方——你可以在这里看到它确认游戏插件和安装路径的信息。

手动安装模组（进阶）

即使你使用模组管理器，理解手动安装方式也是值得的。Cyberpunk 的模组通常只是一些镶嵌着游戏自身目录结构的文件夹，所以一旦你做过一次，就很难出错。

阅读模组的安装说明

每次都要先滚动到模组页面的 Installation 部分查看说明。

对于 Better Loot Markers 来说，需要 CET v1.37.1+，并将所有文件解压到 Cyberpunk 2077\bin\x64\plugins\cyber_engine_tweaks\mods\ 中。

下载文件

在模组页面使用 Manual 按钮，而不是 Vortex 按钮。

1. 点击以通过 Vortex 安装：不是这个。
2. 点击手动下载：是这个。

会出现一个确认窗口。

1. 仅手动下载 Better Loot Markers：点击 Manual download。注意这只会下载模组本身——下方列出的需求项不会一并下载，所以你需要在对应的模组页面用同样的方式单独下载 CET。

注意 - 免费的 Nexus Mods 账户在开始下载前会有短暂等待，并且下载速度会受限。这是正常现象。

复制文件

用 7-Zip 解压这两个压缩包。你会发现每个都只包含一个 bin 文件夹。

1. 将 CET 的 'bin' 文件夹复制到你的游戏主目录：整个压缩包就是一个 bin 文件夹。

1. 将该模组的 'bin' 文件夹复制到你的游戏主目录：Better Loot Markers 也是同样的操作。

现在打开你的 Cyberpunk 2077 游戏目录——即包含 archive、bin、engine、r6 和 REDprelauncher.exe 的文件夹。

1. 将 CET 和 Better Loot Markers 的 'bin/' 文件夹复制到 'bin/' 文件夹所在的主游戏目录中：将两个 bin 文件夹粘贴到这里，让 Windows 自动合并它们。系统会询问是否确认替换/合并现有的 bin 文件夹，这正是你想要的操作。

提示 - 这就是为什么这些压缩包被这样组织的原因。模组的文件夹结构镶嵌着游戏本身的结构，因此合并它们会把每个文件都准确放到应有的位置。不要重命名任何东西，也不要自作聪明——只需合并即可。

先安装 CET，运行一次游戏让 CET 生成它的文件夹，然后再添加模组。不按这个顺序也能正常工作，但这样做能在出问题时更明显地看出是哪一步出错了。

确认文件已正确到位

合并完成后，检查 CET 是否已进入 bin\x64\plugins\。

你应该能看到 cyber_engine_tweaks.asi 以及一个 cyber_engine_tweaks 文件夹。如果 .asi 文件不在那里，CET 就绝对无法加载。

然后检查模组本身。

1. 确认游戏文件夹：你需要在 bin\x64\plugins\cyber_engine_tweaks\mods\ 中看到一个 BetterLootMarkers 文件夹。注意地址栏里的完整路径 - 如果你的 mod 放到了别的地方，它就不会加载。

注意 - 在这张截图中你还能看到一个 __folder_managed_by_vortex 文件，这只是 Vortex 用来标记它管理的文件夹的标志。纯手动安装不会有这个文件。

在 REDlauncher 中启用 Mods

不管你用的是哪种方法，有一个开关经常让人栽跟头。CDPR 的 REDlauncher 有一个 mods 开关，如果它是关闭的，无论你的 mod 安装得多正确都不会加载。

1. 点击图标：点击 Play 按钮旁边的齿轮图标。
2. 点击切换开关：确保 Enable mods 已经打开。

注意 - 如果你改用 Vortex 的 Launch Game with REDmods Enabled 工具启动游戏，这一步会自动帮你处理好。

检查你的 Mods 是否加载成功

启动游戏，到主菜单或进入游戏后按下你的 CET 快捷键。

1. CET 菜单已确认可用：Cyber Engine Tweaks 工具栏会出现，包含 Console、Bindings、Settings、TweakDB Editor、Game Log、ImGui Debug 和 Reload all mods。
2. Better Loot Markers 菜单已确认可用：该 mod 自己的设置窗口会以单独面板的形式出现，包含 mod 页面列出的选项（Vertical Mode、Show Default Markers、Marker Scaling、Immersive Mode、Show Item Counts）。

第二个窗口才是真正的确认标志。CET 能加载只能证明框架本身可用 - 看到 mod 的面板才说明这个 mod 本身被找到并加载了。

故障排除

CET 菜单打不开

这是最常见的问题，通常是以下几种原因之一。

• 你正在以全屏模式运行游戏。请切换到无边框或窗口模式。
• 你从未绑定过快捷键，或者绑定了你的键盘布局打不出来的键。大家常用的默认键是 `、F10 和 *。
• 没有安装 Microsoft Visual C++ Redistributable。
• 某个覆盖层吞掉了输入。Steam、Discord 和 GeForce Experience 是常见的元凶。

针对 Steam 覆盖层的问题，右键点击你库中的游戏。

1. 在 Steam 库中右键点击 CP2077：找到 Cyberpunk 2077 并右键点击它。
2. 在下拉菜单中点击 Properties：选择 Properties。

1. 如果菜单没有显示，关闭覆盖层：在 General 下关闭 Enable the Steam Overlay while in-game。

我个人并没有关闭任何覆盖层就让 CET 正常工作了，但足够多的人遇到过这个问题，所以如果你卡住了，值得试一下。

查看 CET 日志

如果 CET 还是不配合，去看看它的日志。在 Vortex 中你可以右键点击 CET mod 并选择 Open in File Manager，或者自己导航到 bin\x64\plugins\cyber_engine_tweaks\。

1. 含调试/错误信息的日志文件：cyber_engine_tweaks.log 和 scripting.log 是你需要的两个文件。用任意文本编辑器打开它们，寻找错误信息。

这里有个有用的技巧：日志文件存在这件事本身就说明了一些问题。如果它们存在并且是最近修改过的，说明 CET 在游戏启动时至少尝试过加载，这说明问题出在配置上，而不是 CET 根本没运行。如果压根没有日志文件，说明 CET 没有被注入 - 回去检查 cyber_engine_tweaks.asi 是否真的放在了 bin\x64\plugins\ 里。

常见问题

• 游戏启动时崩溃。 禁用你最近添加的 mod，然后逐个重新启用。Vortex 的 Disabled 状态让这一步变得很轻松。
• 游戏更新后一切都坏了。 Cyberpunk 的补丁经常会破坏 CET 和脚本类 mod。等框架更新后再更新你的 mod。
• 某个 mod 毫无反应。 再检查一次它的前置需求，然后检查 REDlauncher 的 Enable mods 开关。
• Mod 通过 Vortex 能用，但移动 staging 文件夹后就不行了。 重新安装它们。仅仅移动文件夹本身并不总是够的。
• 你需要求助。 REDmodding Discord 非常活跃且乐于助人。记得带上你的日志。

说明

• 我们与 Nexus Mods、CD Projekt Red 或 Cyber Engine Tweaks 团队没有任何关联。这篇指南是我们独立整理出来，帮助大家入门的。
• 本文所有内容在撰写时均为准确信息。Cyberpunk、Vortex、MO2 和 CET 都会定期更新，所以个别截图可能会过时。
• 不要混用不同的 mod 管理器。选择 Vortex 或 MO2 并坚持使用它 - 让两者同时管理同一个安装是让游戏迅速崩坏的捷径。

另请参阅！

• Nexus Mods - Cyberpunk 2077
• Cyber Engine Tweaks
• Better Loot Markers
• REDmodding Wiki
• REDmod（官方模组支持）
• GitHub 上的 Mod Organizer 2
• 如何下载并安装 Vortex
• 如何使用 Vortex 及基础操作
• Cyberpunk 2077 Modding Discord

结语

就是这些！现在你应该已经让 CET 正常运行起来了，也通过适合自己的方式安装好了 Better Loot Markers，并且对 Cyberpunk 模组为何要这样组织结构有了不错的理解。

简而言之——除非有特殊理由，否则请使用 Vortex；在安装模组本身之前先安装它们所需要的框架；并且记得 REDlauncher 里还有一个 Enable mods 开关存在。

我们制作的指南永远欢迎修改和改进，所以如果你有任何建议或发现任何问题，欢迎在我们的 GitHub 仓库上创建 pull request 来参与贡献！

如果你有任何问题，或者在模组制作、或我们的指南方面需要帮助，欢迎加入我们的 Discord 服务器！