版本隔离工具

版本隔离工具

按游戏版本区分 Mods 文件夹,启动时自动切换。再也不用担心更新后丢失 Mod 配置。每个版本还支持多个 Mod 包。

[size=4][b]版本化模组管理器[/b][/size]
[size=3]游戏会自动加载与其自身版本匹配的 Mods 文件夹。[/size]
[size=2]按版本区分的模组文件夹 · 启动时自动切换 · 多个模组包 · 永不丢失[/size]



[b][color=#ff3333][size=3]⚠ 警告:仅限 STEAM 版本![/size][/color][/b]
[size=2]本工具读取 Steam 的 appmanifest 并挂接到 Steam 启动选项。它[b]不[/b]适用于 Microsoft Store / Game Pass 版本或任何非 Steam 安装(在那里不会出问题——只是无法检测版本)。不提供此类支持。[/size]

[size=3][b][color=#9acd32]它有什么作用?[/color][/b][/size]
每次 7DtD 重大更新往往会破坏旧模组,而回滚游戏意味着你的模组早已不见。本工具在你的安装目录中为[b]每个游戏版本保留一个独立的 Mods 文件夹[/b]:

[code]7 Days To Die\
├─ Mods ← NTFS 联接点(游戏读取此位置,完全无感知)
│ ↓ 指向
└─ VersionedMods\
├─ Mods_v3.0.1\ ← 3.0.1 的模组
├─ Mods_v3.1.0\ ← 3.1 的模组
└─ Mods_v3.2.0\ ← 3.2 的模组[/code]
每次启动前,它会[b]完全离线[/b]读取 Steam 的 appmanifest(优先使用 BetaKey,以 buildid 作为稳定的后备),检测当前游戏版本,并立即将联接点重新指向匹配的文件夹。零文件复制,零游戏文件改动。

[size=3][b][color=#9acd32]功能[/color][/b][/size]
[list]
[*]按版本隔离模组——更新不会破坏你的配置;随时回滚,旧模组会原样恢复[/*]
[*]全自动:Steam 启动选项钩子在游戏启动前同步,且绝不会阻止启动[/*]
[*]检测到新游戏版本 → 自动创建文件夹,并自动携带 [b]0_TFP_Harmony[/b] 加载器[/*]
[*][b]每个版本支持多个模组包[/b]——通过菜单切换;选择会保持固定,直到游戏版本变化(安全自动释放)[/*]
[*]单一入口:带编号的主菜单[/*]
[*]兼容性提示:标记那些自身文本声明与当前运行版本不同的模组[/*]
[*]一键卸载,恢复为完全原版的 Mods 文件夹[/*]
[*]英文版和中文版,共享同一数据存储[/*]
[/list]
[size=3][b][color=#9acd32]要求[/color][/b][/size]
[list]
[*][b]仅限 Steam 版 7 Days to Die。[/b]不支持 Microsoft Store / Game Pass 和非 Steam 安装。[/*]
[*]Windows 10 / 11[/*]
[*]PowerShell 5.1(Windows 内置)——[b]无需管理员权限[/b][/*]
[*]无需其他。无网络访问,不修改游戏文件,不注入进程。[/*]
[/list]
[size=3][b][color=#9acd32]安装——每一步点击,逐步说明[/color][/b][/size]

[b]第 1 步——放置文件[/b]
[list=1]
[*]将下载的压缩包解压到任意位置。[/*]
[*]选中所有解压出的文件 → 右键 → [b]复制[/b]。[/*]
[*]打开你的游戏文件夹,例如 [font=Courier New]X:\SteamLibrary\steamapps\common\7 Days To Die\[/font](在 Steam 中:右键游戏 → 管理 → 浏览本地文件)。[/*]
[*]在此处新建一个文件夹,名称必须完全为 [b]VersionedMods[/b](右键 → 新建 → 文件夹)。[/*]
[*]打开它并粘贴(Ctrl+V)。结果:[font=Courier New]...\7 Days To Die\VersionedMods\7dtd-versioned-mods-en.ps1[/font] 以及 readme 文件。
[/list=1]

[b]第 2 步——首次运行(这会创建启动器)[/b]
下载包是[b]纯源码,不含 .cmd 文件[/b],因为模组站点会自动隔离它们。工具在首次运行时生成两个极小的启动器——以下是启动方法:
[list]
[*][b]方式 A(仅用鼠标):[/b]在 VersionedMods 文件夹中,右键 [font=Courier New]7dtd-versioned-mods-en.ps1[/font] → 点击[b]“使用 PowerShell 运行”[/b]。会打开一个蓝色/黑色窗口并显示主菜单。[/*]
[*][b]方式 B(如果方式 A 被策略阻止):[/b]点击文件夹的地址栏,输入 [font=Courier New]powershell[/font] 并按回车,然后粘贴以下内容并按回车:
[code]powershell -NoProfile -ExecutionPolicy Bypass -File ".\7dtd-versioned-mods-en.ps1" main[/code][/*]
[/list]你会看到此菜单(此时脚本旁边已创建两个启动器文件 [font=Courier New]Tool-Menu-EN.cmd[/font] 和 [font=Courier New]steam-hook-en.cmd[/font],以后直接双击 [font=Courier New]Tool-Menu-EN.cmd[/font] 即可):
[code] [1] 显示状态
[2] 立即同步
[3] 启动游戏(先同步)
[4] 切换模组包
[5] 将旧模组复制到新版本
[6] 接管 Mods 文件夹
[7] 卸载 / 恢复
[8] 复制 Steam 启动选项字符串
[0] 退出[/code]
[b]第 3 步——接管现有模组(菜单 [6])[/b]
[list=1]
[*]输入 [b]6[/b] 并按回车。[/*]
[*]等待几秒。你当前 Mods 的全部内容会被移动到 [font=Courier New]VersionedMods\Mods_<当前版本>\[/font],原来的 Mods 位置变为指向它的联接点。[/*]
[*]当你看到[i]“完成!Mods 现在是指向 ... 的联接点”[/i]时即成功。没有丢失任何内容——模组只是移深了一层,现在由版本管理。
[/list=1]

[b]第 4 步——Steam 启动选项(菜单 [8])—— 实现全自动[/b]
[list=1]
[*]在菜单中输入 [b]8[/b] 并按回车 → 启动字符串现在已在你的剪贴板中。[/*]
[*]打开 [b]Steam[/b] → 确认你在[b]库[/b]标签页。[/*]
[*]在左侧游戏列表中找到 [b]7 Days to Die[/b] → [b]右键[/b]它 → 点击[b]属性...[/b][/*]
[*]停留在[b]常规[/b]标签页,向下滚动到名为[b]启动选项[/b]的底部字段。[/*]
[*]点击空字段内部并按 [b]Ctrl+V[/b]。应显示为(盘符调整为你的):
[code]"X:\SteamLibrary\steamapps\common\7 Days To Die\VersionedMods\steam-hook.cmd" %command%[/code][/*]
[*]关闭属性窗口(右上角 X)—— Steam 会立即保存,没有确定按钮。
[/list=1]
此后:每次你按[b]开始游戏[/b],钩子会先运行(将 Mods 同步到检测到的游戏版本,写入日志到 [font=Courier New]hook-last-run.log[/font]),然后游戏 100% 正常启动——启动器、EAC、Discord 等一切均不受影响。即使工具出错,游戏仍会启动。

[b]第 5 步——验证(菜单 [1])[/b]
输入 [b]1[/b] + 回车。你应该会看到类似:
[code]Game version : v3.2.0 (buildid: 24994517)
Current Mods : [junction] -> ...\VersionedMods\Mods_v3.2.0
---- Version folders ----
Mods_v3.1.0 (70 mods)
Mods_v3.2.0 (12 mods) <-- currently loaded[/code]就这样。安装完成——照常游玩。

[size=3][b][color=#9acd32]日常使用——各种场景[/color][/b][/size]

[b]▸ 安装模组[/b] —— 和往常一样:将模组文件夹放入 [font=Courier New]...\7 Days To Die\Mods\[/font]。它会自动落入当前版本的文件夹。无需额外步骤。

[b]▸ 游戏有小更新(版本号相同)[/b] —— 什么都不用做。继续使用同一文件夹。

[b]▸ 游戏更新到新版本(例如 3.2 → 3.3)[/b]
[list=1]
[*]直接启动游戏。工具会创建一个空的 [font=Courier New]Mods_v3.3.0[/font](自动携带 0_TFP_Harmony)并切换到它。你的 3.2 模组原封不动地留在旧文件夹中。[/*]
[*]想在新版本中使用旧模组?菜单 [b][5][/b] → 回车。它会从最近一个旧文件夹复制所有内容(同名项会跳过)。任何仍然报错的模组需要其作者更新——只需删除该文件夹。
[/list=1]

[b]▸ 将游戏回滚到旧版本[/b]
[list=1]
[*]Steam → 右键游戏 → [b]属性[/b] → [b]测试版[/b]标签页。[/*]
[*]打开下拉菜单,选择旧分支(如果字段要求输入分支密钥则输入),关闭窗口,等待下载完成。[/*]
[*]正常启动——工具会自动切换回该版本的文件夹,你的旧模组又会原样出现。
[/list=1]

[b]▸ 同一版本的多个模组包[/b]
[list=1]
[*]打开 [font=Courier New]VersionedMods\[/font],右键 → 新建 → 文件夹。以 [b]Mods_[/b] 开头命名,例如 [font=Courier New]Mods_v3.2.0_Hardcore[/font]。[/*]
[*]将该包对应的模组文件夹复制进去(每个模组文件夹必须像往常一样包含其 ModInfo.xml)。[/*]
[*]菜单 [b][4][/b] → 你会得到一个带模组计数的所有文件夹的编号列表 → 输入你的包编号 → 回车。[/*]
[*]你会看到[i]“已切换并固定”[/i]。该包现在会在每次启动时保持加载,直到:你再次切换(菜单 [4])、游戏版本变化(自动释放)、或你卸载([7])。
[/list=1]

[b]▸ 只是查看已加载的内容[/b] —— 菜单 [b][1][/b]。标有 [i][!][/i] 的行表示该模组自身文本声称它为不同游戏版本制作(仅供参考)。

[b]▸ 不使用 Steam 启动选项?[/b] —— 通过菜单 [b][3][/b] 启动游戏(会先同步)。直接从 Steam 启动而不使用钩子只会跳过自动同步。

[size=3][b][color=#9acd32]卸载——逐步说明[/color][/b][/size]
[list=1]
[*]菜单 [b][7][/b] → 联接点被移除,当前版本的文件夹恢复为普通的 [font=Courier New]Mods[/font] 文件夹。游戏 100% 原版。[/*]
[*]Steam → 右键游戏 → 属性 → 常规 → 清空启动选项字段。[/*]
[*]可选:删除 VersionedMods 中你不再需要的版本残留文件夹——[b]请先检查其中是否有你仍需要的模组[/b]。
[/list=1]

[size=3][b][color=#9acd32]故障排除[/color][/b][/size]
[list]
[*][b]“已禁用运行脚本”[/b] —— 使用第 2 步中的方式 B(命令包含 -ExecutionPolicy Bypass)。[/*]
[*][b]切换时出现“...正被另一进程使用”[/b] —— 关闭游戏以及任何显示 Mods 文件夹的资源管理器窗口,然后再次同步(菜单 [2])。[/*]
[*][b]模组完全未加载[/b] —— 菜单 [1]:如果显示[i][真实文件夹][/i],运行 [6](接管);如果指向错误的版本文件夹,运行 [2](同步)。[/*]
[*][b]重装 / 移动了游戏[/b] —— 工具会在下次运行时自动重新检测;如果缓存了旧路径,只需删除脚本旁边的 [font=Courier New]game-dir.txt[/font]。[/*]
[*][b]备份软件 / OneDrive[/b] 可能跟随联接点并复制模组数据——请排除 VersionedMods 文件夹。[/*]
[/list]
[size=3][b][color=#9acd32]常见问题[/color][/b][/size]
[spoiler][list]
[*][b]这安全吗?VAC / EAC 会封禁吗?[/b] —— 不修改游戏文件,不注入任何东西,完全离线;Steam 文件验证不受影响。7DtD 官方支持模组;EAC 服务器拒绝模组是游戏自身长期以来的规则,此处未做改变。[/*]
[*][b]我的 Mods 显示为 <JUNCTION> —— 是病毒吗?[/b] —— 原生 NTFS 功能(文件系统级指针),故意创建。它正是实现即时切换的关键。[/*]
[*][b]在 Steam 中切换了版本但什么都没发生?[/b] —— 工具在启动时而非版本切换时运行。按开始游戏。[/*]
[*][b]为什么大更新后新文件夹是空的?[/b] —— 设计如此:旧模组可能导致新版本崩溃。菜单 [5] 可将其迁移过来。[/*]
[*][b]新文件夹中的 0_TFP_Harmony 来自哪里?[/b] —— 从上一版本的文件夹自动复制。如果未来更新对 Harmony 报错,请从新文件夹中删除它(仅 XML 的模组仍可工作)或替换为匹配版本。[/*]
[*][b]我可以重命名文件夹吗?[/b] —— 模组文件夹:可以(但名称决定加载顺序,0_/ZZZ_ 前缀是有意为之)。Mods_* 文件夹:仅限当前未加载的文件夹,保留 Mods_ 前缀。.ps1:不可以。[/*]
[*][b]Steam“验证完整性”或更新会删除我的东西吗?[/b] —— 永远不会。VersionedMods 不属于游戏的文件清单。[/*]
[/list][/spoiler]

[size=3][b][color=#9acd32]备注 / 权限[/color][/b][/size]
[list]
[*]一切都是纯文本 PowerShell —— 可用记事本打开,几百行,零网络请求。下载包提供纯源码;两个极小的 .cmd 启动器在首次运行时本地生成,因此不会被自动隔离的内容从不上传。[/*]
[*]欢迎翻译、镜像或将其包含在模组包中——请注明出处,请勿重新上传作为你自己的作品。[/*]
[/list]
[size=3][b][color=#9acd32]我的其他 7 Days to Die 模组[/color][/b][/size]
[list]
[*][b][url=https://www.nexusmods.com/7daystodie/mods/12047]Sleep To Any Time - Time Skip[/url][/b] —— 在床上/睡袋上按住 E,选择小时,立即跳转。(基于 Adam42503 的 Simple Sleep Mod 修改)[/*]
[*][b][url=https://www.nexusmods.com/7daystodie/mods/12070]Mouse Gestures - Quick Move[/url][/b] —— 中键移动整叠,滚动逐个移动,与原生左键/右键零干扰。[/*]
[*][b][url=https://www.nexusmods.com/7daystodie/mods/12102]GoreCamouflage[/url][/b] —— 制作血腥伪装工具包,化身死者:从尸群旁走过,搜刮 POI,逃脱追击。[/*]
[*][b][url=https://www.nexusmods.com/7daystodie/mods/12103]HunterPulse[/url][/b] —— 按 Q 发出声纳脉冲,勾勒出僵尸(狂暴=橙色,辐射=绿色)、动物和未搜刮的容器。7 级感知树,5 级可穿墙。[/*]
[*][b][url=https://www.nexusmods.com/7daystodie/mods/12200]StatCombinePlus[/url][/b] —— 合并武器现在会将属性随机值相加,而非仅取最佳一项——你辛苦刷出的每一点都在合并中保留。[/*]
[*][b][url=https://www.nexusmods.com/7daystodie/mods/12305]PoiLocator[/url][/b] —— 找到世界中的每栋建筑:坐标、距离与罗盘方位——放置原生路点后步行前往。[/*]
[*][b][url=https://www.nexusmods.com/7daystodie/mods/12354]BigMap - Waypoint Management[/url][/b] —— 将原生的小地图窗口放大到屏幕约 80%:同等缩放级别下多看约 2.1 倍地形。[/*]
[*][b][url=https://www.nexusmods.com/7daystodie/mods/12653]CookingOil[/url][/b] —— 在任意营火处从玉米榨油,并与动物脂肪 1:1 互换:无需狩猎即可制作炖菜、火把和锻炉燃料。[/*]
[/list][/*]
[/list][/*]
[/list][/*]
[/list][/*]
[/list][/*]
[/list][/*]
[/list][/*]
[/list]