闽公网安备35010302000678号
一、Mod 简介
本 Mod 是专为《杀戮尖塔 2》打造的卡牌禁用管控模组，在不改动游戏底层数据的前提下，实现卡牌自由禁用 / 解禁、禁用状态持久化与随机卡池精准过滤，让你彻底告别不想见到的废卡，随心打造专属构筑体系，大幅提升爬塔的策略性与游戏体验。
项目开源仓库：liwenhao0427/STS2_CardDisableControl: 杀戮尖塔2卡牌禁用. 百科大全、卡牌总览中使用中键、b键切换禁用状态
二、核心功能
双方式禁用 / 解禁：支持卡牌总览界面快捷键B/鼠标中键快速操作、卡牌详情界面勾选操作，两种方式操作便捷高效标记：被禁用的卡牌会在总览界面显示红色 【禁用中】 覆盖标记
精准卡池过滤：禁用卡牌会被过滤出长期随机出卡来源，包括奖励 / 事件随机卡池、商店随机卡池、非战斗转化随机卡池，战斗内临时生成的卡牌不受影响，不破坏战斗内游戏节奏
持久化配置：禁用 / 解禁操作会立即写入配置文件，无需重复设置，重启游戏后禁用状态依然保留，配置永不丢失
三、下载地址
夸克网盘下载：夸克网盘分享
GitHub 发布页：liwenhao0427/STS2_CardDisableControl: 杀戮尖塔2卡牌禁用. 百科大全、卡牌总览中使用中键、b键切换禁用状态
四、安装教程
《杀戮尖塔 2》原生支持模组加载，无需额外安装模组管理器，直接手动安装即可，使用 Mod 管理器可自动完成安装步骤，更省心。
- 打开 Steam 游戏库，右键《Slay the Spire 2》，选择「管理」→「浏览本地文件」，打开游戏根目录
- 在游戏根目录中，新建名为mods的文件夹（若已存在则无需重复创建）
- 下载 Mod 压缩包并解压，将解压后的CardDisableControl.dll与CardDisableControl.pck两个文件，放入mods文件夹内
- 启动游戏，在主界面的「模组」菜单中，找到本 Mod 并勾选启用（默认启用），重启游戏后即可生效
五、使用说明
快捷键快速操作：在卡牌总览界面，将鼠标悬停在需要操作的卡牌上，按下鼠标中键或B键即可快速禁用 / 解禁该卡牌，操作即时生效
详情页勾选操作：点击卡牌进入详情界面，在「查看升级」选项旁会新增「禁用卡牌」勾选项，勾选即禁用，取消勾选即解禁，适合精细操作
禁用效果生效：完成禁用操作后，被禁用的卡牌将不再出现在奖励、事件、商店等长期随机出卡场景中，战斗内临时生成的卡牌不受限制，保证战斗的流畅性
配置文件查看：禁用配置文件存储在%APPDATA%\SlayTheSpire2\mods\CardDisableControl\settings.json，可手动打开查看禁用的卡牌 ModelId，不建议手动修改，避免配置出错
六、更新日志
v0.0.2（2026-03-15，最新版本）
实现卡牌禁用控制核心功能，支持快捷键 / 详情页勾选双方式操作
完成随机卡池过滤逻辑，精准过滤非战斗场景随机出卡
实现禁用配置即时写盘，支持持久化保存
禁用通用日志输出，优化模组运行效率
七、注意事项 & 常见问题
重要注意事项
存档独立说明：启用模组后，游戏将使用独立的模组存档，与原版存档互不影响，关闭 Mod 后即可恢复原版存档进度，使用 mod 管理器可以快速复制存档
使用范围：本 Mod 仅支持单机游玩，联机模式下请禁用，避免出现游戏异常
版本适配：游戏处于抢先体验阶段，版本更新可能导致 Mod 失效，若出现异常请等待作者更新适配版本
兼容性：本 Mod 基于游戏原生 baselib API 开发，与大部分功能性 Mod 兼容，若出现崩溃、功能异常，可尝试禁用其他 Mod 排查冲突
卡池范围：本 Mod 仅过滤长期随机出卡来源，战斗内临时生卡（如技能、遗物触发生成）不受影响，这是正常设计，并非 Bug
常见问题 FAQ
Q：安装后游戏里找不到 Mod 怎么办？
A：请检查以下几点：
确认文件是否正确放入游戏根目录的mods文件夹，而非子文件夹内
确认CardDisableControl.dll与CardDisableControl.pck两个文件均已放入，缺一不可
Q：按下 B 键后卡牌没有被禁用，是什么原因？
A：请确认鼠标是否准确悬停在卡牌上，且处于卡牌总览界面，详情页无法使用快捷键操作，需通过勾选选项完成禁用。
Q：禁用卡牌后，商店 / 奖励中还出现该卡牌怎么办？
A：请先确认是否为战斗内临时生成的卡牌（该类卡牌不受过滤），若为常规商店 / 奖励卡，可尝试重启游戏，或在 GitHub 仓库提交 Issue 反馈卡牌 ModelId。
Q：想恢复所有卡牌的可用状态，该怎么操作？
A：可手动删除配置文件%APPDATA%\SlayTheSpire2\mods\CardDisableControl\settings.json，重启游戏后所有卡牌将恢复为可用状态；也可逐个在游戏内解禁卡牌。
八、相关说明
本 Mod 为开源免费项目，请勿用于商业用途
模组支持规则化禁用策略扩展，后续将根据玩家建议持续更新功能
若你有功能建议或 bug 反馈，可前往 GitHub 仓库提交 Issue，或在相关演示平台留言反馈
