⚠️ 注意：这个 Mod 不再维护薄荷尖塔的维护者已经手搓了一个，安全性应该比我这个 Vibe 的强，请您务必安装他们的： https://github.com/erasels/StS2-Quick-Restart
或者你喜欢薄荷尖塔2？ https://github.com/erasels/Minty-Spire-2
这个 Mod 的 Star 怪多的，在这里放些 Mod 使用指南好了。
尖塔2官方已支持 Modding，并提供了大量钩子和 Harmony 支持。
安装：
- 在游戏目录下创建
mods文件夹 - 将
.pck或.dll文件放入该文件夹。每个 mod 必有一个 mod_manifest.json 来描述，而这两个文件是可选的 - 启动游戏
mod_manifest.json 例如下：(来自 Alchyr ModTemplate)
{
"id": "ModTemplate",
"name": "ModTemplate",
"author": "{ModAuthor}",
"description": "Slay the Spire 2 mod created from a template for use with BaseLib",
"version": "v0.0.0",
"has_pck": true,
"has_dll": true,
"dependencies": ["BaseLib"],
"affects_gameplay": true
}提示： 如果您的 Mod 加载有问题（尤其是 Linux 和 MacOS 用户），请前往安装 BaseLib 来解决一些编译器差异。
MacOS 因为 arm 似乎有另一个加载问题，但是在 0.99 中似乎已经得到修复。
关掉 Mod 模式：
您可以在主菜单的设置中切换每个 mod 的开关，或者在 Steam 启动选项中添加 --nomods 关闭所有 Mod。如果您不确定是否是 Mod 导致了游戏启动问题，建议先使用 --nomods 来排查。
联机： 杀戮尖塔 2 强制所有联机的玩家都必须使用完全相同的游戏版本，并都加载了具有相同版本号的联机 mod。
部分平台的热更新似乎是滞后的。让朋友拷贝安装目录（Steam -> 塔2 -> 列表右键/启动按钮右边的右边的设置图标 -> 管理 -> 浏览本地文件） release_info.json 给您， 就可以欺骗游戏认为您的版本和他们完全一样了。不保证安全性。
mod_manifest.json 里规定了 mod 是否会影响游戏内容 affects_gameplay，即 mod 是否需要多人都装。 affect_gameplay 的 mod 联机者必须都装，否则除了“我们有而房主没有的mod”这一提示之外也很有可能提示“联机超时”。
Mod ID 和版本号必须完全匹配。请让您的朋友们也安装相同的 Mod 。
另外，杀戮尖塔 2 的应用层网络结构是：客户端 Client 向 房主 Host 发送请求，然后 Host 再广播给所有 Client（不包括 Host 自己）。 Client 总会被再广播一次自己的请求，但是 Host 的请求只会广播 1 次而不会发送到自身。如果您的 Mod 在客户端和房主表现不同，请排查这里。
按 ` （这个键在横排数字 1 的左边，Tab的上面） 打开控制台，输入 open saves 可以快速打开存档目录，往上出去几层文件夹直到看到 profile1, 2, 3 和 modded 文件夹。
将 profile1 复制到 modded 中覆盖原文件夹，即可恢复存档。
或者您可以通过 Steam 云同步目录来修改：
[Steam 目录]/userdata/[SteamID]/2868840/ (Windows / Linux / macOS 均适用) 下有另一个存档目录。
由于这是 Steam 云同步目录，在您回到 Steam 之后，Steam 会提示**“云冲突”，此时选择“保留本地文件”**即可。
如果您的 Steam 云或者《杀戮尖塔 2》坚持不懈地覆盖您的存档，则前往下面的本地目录手动覆盖：
-
Windows:
%APPDATA%/SlayTheSpire2/steam/[SteamID]/2868840/ -
Linux:
~/.local/share/SlayTheSpire2/steam/[SteamID]/2868840/ -
MacOS:
~/Library/Application Support/SlayTheSpire2/steam/<SteamID>/ -
(注：
~/是您的家目录，即/home/[你的名字]或者/Users/[你的名字]) -
(这么看的话其实三端的本地目录都是 %APPDATA% 或 $XDG_DATA_HOME 或 Application Support 这种用户数据目录，然后再加上 SlayTheSpire2/steam/[SteamID]/2868840/` 这个路径 )
打开方式：按 ` (反引号) 键。这个键在横排数字 1 的左边，Tab的上面。
在未开启 Mod 的情况下，控制台默认只支持一些基本的调试命令。您可以加载一些简单的 Mod 来启用完整的控制台功能，或者在不开启 Mod 的情况下手动启用：
- 如上打开存档目录，
- 向上两级目录，找到
settings.save文件 - 用文本编辑器打开，在开头添加
"full_console": true,：{ "full_console": true, "aspect_ratio": "auto" } - 保存文件，重启游戏
- Tab: 自动补全命令或参数
- ↑ / ↓: 快速浏览历史命令
- F11: 切换全屏/半屏显示
- Ctrl + L: 清除屏幕信息
- Ctrl + A / E: 光标移至行首/行尾
- Ctrl + U / K: 删除整行 / 删除至行尾
- Ctrl + W: 删除光标前的一个词
- Escape / Ctrl + C: 关闭或隐藏控制台
- 是的这是 Emacs 风格的快捷键，习惯了就好。
带 ✅ 标记的命令支持在多人联网模式下同步状态到其他玩家，带 ❌ 标记的命令则仅在本地生效
点击展开：资源与数值修改
| 命令 | 参数 | 描述 | 联网 |
|---|---|---|---|
gold |
<数量> |
增加或减少金币 | ✅ |
stars |
<数量> |
增加或减少星星 | ✅ |
heal / damage |
<数值> |
恢复生命值 / 受到伤害 | ✅ |
energy |
<数值> |
获得能量 | ✅ |
block |
<数值> |
获得格挡值 | ✅ |
点击展开：卡牌、遗物与物品
| 命令 | 参数 | 描述 | 联网 |
|---|---|---|---|
card |
<ID> [牌堆] |
生成卡牌到指定位置（默认手牌） | ✅ |
upgrade |
<卡牌ID> |
升级指定的卡牌 | ✅ |
remove |
<卡牌ID> |
从牌组中移除卡牌 | ✅ |
enchant |
<卡牌ID> |
为卡牌施加附魔 | ✅ |
relic |
[add/remove] <ID> |
添加或移除指定的遗物 | ✅ |
potion |
<药水ID> |
获得指定的药水 | ✅ |
draw |
<数量> |
立即抽取指定数量的牌 | ✅ |
点击展开：战斗与进程控制
| 命令 | 参数 | 描述 | 联网 |
|---|---|---|---|
fight |
<战斗ID> |
跳转到特定的敌人战斗 | ✅ |
win / die |
- | 立即获得胜利 / 立即死亡 | ✅ |
kill |
<目标> |
击杀场上指定目标 | ✅ |
act |
<Act-ID> |
跳转到指定的章节（Act） | ✅ |
room |
<类型> |
进入特定类型的房间 | ✅ |
event |
<事件ID> |
强制触发特定事件 | ✅ |
god |
[on/off] |
开启/关闭无敌模式 | ❌ |
instant |
[on/off] |
开启/关闭即时动作模式 | ❌ |
点击展开：系统与调试
| 命令 | 描述 | 联网 |
|---|---|---|
help [cmd] |
显示命令的详细帮助信息 | ❌ |
clear / exit |
清除屏幕 / 关闭控制台 | ❌ |
unlock <ID> |
解锁指定的游戏内容 | ✅ |
achievement |
解锁指定的 Steam/游戏成就 | ❌ |
log [level] |
设置日志记录级别 | ❌ |
dump |
导出当前的调试信息快照 | ❌ |
multiplayer |
进入多人游戏调试工具 | ❌ |
trailer |
开启适合拍摄预告片的演示模式 | ❌ |
在 Steam 启动选项或命令行中使用：
| 参数 | 用途说明 |
|---|---|
--force-steam[=on|off] |
强制启用或禁用 Steam 集成 |
--autoslay |
（调试用） 启动时自动开始新游戏 |
--seed <seed> |
指定特定的游戏种子（Seed） |
--log-file <path> |
自定义日志文件的保存路径 |
--bootstrap |
以引导模式启动游戏 |
--fastmp |
快速多人模式 |
--clientId <id> |
指定客户端 ID |
--nomods |
禁用所有模组加载，以原生状态启动 |
+connect_lobby <id> |
启动后自动加入指定的 Steam 大厅 |
如果 Mod 使您的游戏无法正常启动，您可以使用 --nomods 参数来禁用 Mod 加载，恢复到原生状态。
--force-steam=off + --fastmp + --cliendID 可以让您快速测试多人模式相关的 Mod，而不需要每次都找别人的账号，用法如下：
--fastmp [type]：host host_standard host_daily host_custom load join
--clientId [id]：指定客户端的 NetGameService ID。fastmp 时 host ID 必须1，client 必须 1000 ~1002，否则无法进行“多人读档”操作。
或者，如果您喜欢，您也可以使用 gbe_fork 来模拟 Steam API 。
如果您想要协助 Mod 作者调试，在上面的“本地存档目录” .../SlayTheSpire2/中找到 logs 文件夹，将日志文件按照对应时间戳发给作者。 或者使用 --log-file 参数指定一个日志文件路径。
目前已经有相当多的 Mod 出现和在路上：
- Slay the Spire 2 Discord: 英语官方社区，内有专门的 Modding 频道。此帖子 包含了早期 Mod 的列表和链接。
- 中文 Mod 统计表格 (腾讯文档): 中文，标注了已在制作中和已发布的 Mod（中文社区较多），欢迎补充（我会不定期与 Discord 同步）。主阵地在下面的核心开发群，开发群内讨论偏向技术，如果您无意开发请勿加入。
玩家交流群：
- 哔哩哔哩 UP 主 蝴蝶是幼虫 的泛 Mod 群：
1048696711
- Glitched Reme 的塔2 Mod 教程（中文，持续更新中）
- EarlyStS2ModdingGuides：Mod 开发入门指南（英文）。
语言与引擎基础： 如果你打算把 Mod 开发作为学习 C# 的机会，建议系统学习：
- C# 语言: C# Learning (En) / C# 学习 (中)
- Godot 引擎:Godot (En) / Godot (中) (注：微软和 Godot 的官方中文翻译可能不完善，推荐看英文原版并配合大模型/翻译插件)
如果你希望长期从事简单 Mod 开发，你可能需要长期和下面几个家伙打交道，学习一下：
- Harmony Lib：Harmony Patch，塔2 内置，必看。
- MonoMod。
- BepInEx：一个流行的 C# Mod 框架，通过注入 winhttp.dll 来加载 Mod。
（这三者是互有关联的，Harmony 负责补丁，MonoMod 负责修改和重写代码，BepInEx 负责在游戏不主动加载 Mod 的情况下强行注入 Mod。）
推荐参考 Alchyr 的样板，一键构建：
- ModTemplate-StS2：一个开箱即用的尖塔2 C# Mod 工程模板，内置构建 csproj 脚本和基础目录结构，克隆后改改就能上手。
- BaseLib-StS2：类似塔1 BaseMod 的基础库（开发中），目前提供了 ModelPool 的钩子和 i18n ，值得一用。
代码反编译： 尖塔2没有进行任何混淆，可使用 ilSpy 或dnSpyEx 反汇编出游戏源代码。 资源解包： 使用 GD RE Tools 的 gdsdecomp 将游戏的资源解包。
资源打包：
- 您需要将资源打包成
.pck文件才能被识别。 - 尖塔2使用的是 Godot 4.5.1 的一个魔改版本 MegaDot，您也可以使用正常的 Godot 4.5.1 存档版本来打包资源。(更新的 Godot 版本打包出的 pck 会被游戏拒绝)。
- Spine 资源提示：Godot 使用 Spine Runtime for Godot 这一 GDExtension 来打包 Spine 资源。您需要将它安装到您的 Godot 项目中。（GDExtension 是 项目级的而非全局的，所以您似乎需要在每个项目中都安装一次，我也不确定是否有更好的方法来全局安装。）
- 无美术资源打包：如果您不想要任何的美术资源，可以使用 PCK Explorer 来创建一个仅包含
mod_manifest.json的平凡 pck 文件。命令行参数的版本号请设为3.4.5.1。
- 引擎变化：塔1使用 Java 编写，塔2 迁移到了 C# (Godot)。Mod 脚本需要完全重写。
- Spine 动画变化：塔1使用 Spine 3.4 且为 JSON 骨架；塔2使用 Spine 4.2 且为二进制 (
.skel) 骨架。 - 转换工具：建议使用SpineSkeletonDataConverter 进行二进制迁移。 （尽管如此，这个转换工具最低也只支持 Spine 3.5 ，打开塔 1 的 JSON 强行将 version 字符串改成 3.5 才能开始工作，不保证兼容性）
- 注意事项：请注意动画键名和缩放比例都发生了改变。经测试，塔1“故障机器人”迁移后的缩放比例大约是 10 倍（应用在 root 骨骼上），但不同的 Mod 角色情况可能有所不同。
- 动画：塔1 的骨架文件仅内置了 待机 和 受击 两种动画轴，大部分攻击动画是独立的，死亡是立绘； 塔2 则内置了 6 种。
(注：开发群内讨论偏向技术，如果您无意开发请勿加入)
- 哔哩哔哩 UP 主 蝴蝶是幼虫 的开发群：
812670568 - GlitchedReme 的教程群：
542370192
我会不定期到处分发一些测试版 Mod，您可以在各种群碰碰运气。 如果对我们的工作感兴趣，请前往 GitHub 组织 ModinMobileSTS 查找关于尖塔1/2移动端 Mod 的相关信息（受版权原因影响，可能有部分内容未公开，敬请见谅）。
