杀戮尖塔2 Mod 安装教程：Steam 创意工坊、手动安装与存档
杀戮尖塔2 Mod 安装的完整分步教程：Steam 创意工坊订阅、Nexus 手动安装、v0.108.0 的存档复制机制，以及常见问题排查。
开始之前
杀戮尖塔2现在有两条实用的 Mod 安装路径：大多数玩家优先用 Steam 创意工坊订阅；Nexus 发布版、本地开发版、尚未上工坊的 Mod 则走手动文件安装。
重要提示：带 Mod 的 run 仍然使用独立于原版的存档路径。从 `beta v0.108.0` 起，首次以 Mod 模式启动时，游戏会自动把原版存档复制到 Mod 存档目录，并用弹窗说明这件事。更旧版本可能仍需要按下方步骤手动复制。
第一步：找到游戏文件夹
安装位置取决于你的平台：
Steam（Windows）：在 Steam 库中右键点击杀戮尖塔2 → 管理 → 浏览本地文件。这会打开游戏根目录。
Steam（Mac）：在 Steam 库中右键点击游戏 → 属性 → 已安装文件 → 浏览。导航到 SlayTheSpire2.app/Contents/MacOS/。
独立版/其他：导航到你的游戏安装位置。寻找包含 SlayTheSpire2.exe（Windows）或 SlayTheSpire2.app（Mac）的文件夹。
- Windows Steam 路径：Steam\steamapps\common\Slay the Spire 2
- Mac Steam 路径：~/Library/Application Support/Steam/steamapps/common/Slay the Spire 2/SlayTheSpire2.app/Contents/MacOS/
- 确保你在包含游戏可执行文件的文件夹中，而不仅仅是应用包。
第二步：创建 Mods 文件夹
在你的游戏文件夹中（与可执行文件相同的目录），创建一个名为 mods（全小写）的新文件夹。这是所有 Mod 文件的存放位置。
文件夹结构应该如下：
- Slay the Spire 2/
- SlayTheSpire2.exe（或 .app）
- mods/ ← 创建这个文件夹
第三步：从 Steam 创意工坊或 Nexus Mods 安装
如果 Mod 已经在 Steam 创意工坊上架，优先直接订阅。Steam 会负责下载、更新，并由官方启动器加载。只有在作者尚未发布工坊版时，再使用 Nexus Mods 或手动文件。
手动 Mod 通常会以文件夹或压缩包形式提供，里面包含代码、manifest / 配置文件，有时还有资源或本地化文件。解压后按作者说明放置，通常是放进 mods/。
除非作者明确要求，否则不要把 Mod 包里的文件拆散平铺。很多当前 STS2 Mod 都依赖原本的文件夹结构。
- 有 Steam 创意工坊版本时优先订阅。
- 手动 Mod 通常作为完整文件夹放进 mods/。
- 保留作者提供的文件夹结构。
第四步：以 Mod 模式启动
当你启动杀戮尖塔2时，游戏会检测到你的 mods/ 文件夹并提示你选择 Mod 模式或原版模式。选择 Play Modded（游玩 Mod 版）以加载你已安装的 Mod。
如果你在 `beta v0.108.0` 或更新版本首次用 Mod 启动，游戏应该会自动把原版存档复制到独立的 Mod 存档目录。你的原版存档不受影响。
- 通过 Steam 或快捷方式正常启动游戏
- 出现提示时选择 Play Modded（游玩 Mod 版）
- 如果没有出现提示，检查 mods/ 文件夹是否在正确位置
第五步：检查存档文件（通常会自动完成）
在 `beta v0.108.0` 或更新版本，首次 Mod 启动应该会自动复制原版存档。只有当你的进度没有出现在 Mod 模式里，或你仍在更旧的正式服 / beta 版本时，才需要手动检查这一步。
- Windows 原版存档：%APPDATA%\Roaming\SlayTheSpire2\steam\[SteamID]\profile1\saves\
- Windows Mod 存档：%APPDATA%\Roaming\SlayTheSpire2\steam\[SteamID]\modded\profile1\saves\
- Mac 原版存档：~/Library/Application Support/Steam/userdata/[SteamID]/[GameID]/remote/
- Mac Mod 存档：~/Library/Application Support/Steam/userdata/[SteamID]/[GameID]/modded/
- 只有在 v0.108.0 自动迁移未触发、或进度缺失时才手动复制
常见问题排查
如果你的 Mod 无法正常工作，请检查以下常见问题：
- Mod 不显示：确保 mods/ 文件夹与游戏可执行文件在同一目录，而不是在任何子文件夹中。
- 启动时崩溃：逐个移除 Mod 以确定哪个 Mod 导致崩溃。某些 Mod 可能已过时或与当前游戏版本不兼容。
- 存档未继承：在 `beta v0.108.0` 或更新版本，先重启一次并确认是否出现迁移弹窗。更旧版本按第五步手动复制。
- Mod 未按预期工作：查看 Steam 创意工坊或 Nexus 页面获取具体安装说明。某些 Mod 可能需要依赖或特定的文件夹结构。
- Mac 上找不到游戏文件夹：右键 SlayTheSpire2.app → 显示包内容 → Contents → MacOS。
卸载 Mod
要移除 Mod，只需从 mods/ 文件夹中删除其文件。大多数 Mod 只包含同名的一个 .dll 和一个 .json 文件。删除这两个文件即可完全移除该 Mod。
要完全禁用所有 Mod，你可以删除 mods/ 文件夹中的所有内容，或者直接以原版模式启动游戏。
- 删除 ModName.dll 和 ModName.json 以移除单个 Mod
- 删除 mods/ 中的所有文件以移除所有 Mod
- 以原版模式启动即可在不删除文件的情况下不使用 Mod 游玩
参考来源
视频教程
杀戮尖塔2 Mod 安装教程