Changelog ​

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased] ​

[0.4.2] - 2026-04-11 ​

Fixed ​

• 通过 DevMode 延后注册界面的其他模组，现会在全部模组加载完成后再挂载，避免面板不出现。
• 在地图上右键替换遭遇后，进入该战斗时不再崩溃（含按楼层覆盖等情况）。

[0.4.1] - 2026-04-10 ​

Added ​

• SpireScratch 可视化脚本 — 内置 Blockly 积木编辑器编写规则，导出为 JSON 存放于模组 scripts 目录，文件变更后自动重载；与钩子系统共用触发点、条件与动作模型。新增 脚本 面板可查看已加载脚本、单独启用/禁用、打开脚本目录或编辑器，并可将现有钩子规则迁移为脚本文件。
• SpireScratch 脚本现支持 WebSocket 实时热重载：编辑器保存后直接推送到运行中的游戏，脚本面板自动刷新，无需重启。
• 消耗牌堆 目标 — 卡牌浏览器的「添加目标」下拉菜单与导航标签页现已包含消耗牌堆（与手牌、抽牌堆、弃牌堆、牌组并列）。dmcard add 控制台命令同样支持 exhaust 参数。
• 卡牌浏览器「添加目标」默认值改为 手牌（原为牌组）。
• 角色 / 卡池筛选芯片 — 卡牌浏览器（全部卡牌标签页）新增一排筛选芯片：铁甲战士、静默猎手、故障机器人、储君、亡灵契约师、无色（角色组）以及先古之民、状态、诅咒、事件、任务、衍生牌（特殊组），可与现有的类型、稀有度、费用筛选自由组合；自动识别 Mod 新增角色并追加对应芯片。

Fixed ​

• 通过 DevMode 添加卡牌后，抽牌堆、弃牌堆（及消耗牌堆）的数量标签不再显示旧值：对绕过飞行动画 VFX 的静默添加路径手动触发 CardAddFinished 事件。同样修复了应用含战斗快照的预设时，这些牌堆数量不刷新的问题。
• 地图遭遇预览 现已对所有节点显示正确的怪物：当前战斗楼层直接读取正在运行的遭遇数据（不再从计数器推算），未来楼层使用地图 DAG 广度优先搜索路径走到目标节点时经过的同类型房间数来计算队列偏移量。已绕过的分支节点则显示「若此刻传送进入将遭遇」的怪物。
• 在地图节点上右键替换遭遇的功能现已对当前战斗位置禁用——战斗已经开始，无法在途中更换敌人。

[0.4.0] - 2026-04-08 ​

Added ​

• 钩子系统 — 新增「钩子」面板，支持定义「触发 → 条件 → 动作」自动化规则（例如每次战斗开始时施加某个能力、每回合开始时添加卡牌等）。
  • 触发点：战斗开始/结束、回合开始/结束、抽牌时、造成伤害时、受到伤害时、使用药水时。
  • 条件：HP 低于/高于百分比、楼层高于/低于、拥有/未拥有能力。
  • 动作：施加能力、添加卡牌、使用药水、保存存档。
  • 规则持久化，可单独启用/禁用。
• 自动施加快捷按钮 — 在能力、药水、卡牌浏览器中新增「添加到自动施加」按钮，一键创建战斗开始时执行的钩子规则。
• 可复制 ID — 所有浏览器详情面板（能力、药水、卡牌、遗物、敌人）现在在 ID 旁边显示「复制」按钮，方便快速复制到剪贴板。
• ID 选择弹窗 — 钩子规则编辑器的 ID 输入框旁新增「…」浏览按钮，可在搜索弹窗中直接从完整列表选取 ID，无需手动输入。
• 钩子规则编辑器中的触发点、动作类型、条件类型、目标类型均改为下拉菜单（OptionButton），不再需要反复点击切换。

[0.3.0] - 2026-04-08 ​

Added ​

• 对局内 存档/读档：指定种子重开，可将卡牌、遗物、金币（可选）带入新对局并指定新种子。
• 主菜单开发者模式：指定种子新建。
• 存档管理 改版：动态槽位、新建/删除槽位、更清晰的槽位列表与详情（含可滚动的卡牌、遗物、Mod 信息）。
• 存档详情展示 对局种子 与 已加载 Mod（名称与版本）。
• dmsave 控制台：新增 list、delete 子命令。

Changed ​

• 存档界面为统一槽位列表（不再单独突出快速存档行）；「指定种子重开」的卡牌/遗物携带默认 关闭。

[0.2.0] - 2026-04-08 ​

Added ​

• 动态主题系统，支持深色、浅色、OLED 和暖色四种颜色模式。
• 开发侧边栏新增房间传送面板。
• 卡牌浏览器新增编辑模式，支持预设。

Changed ​

• 能力面板重新设计为双栏浏览器布局。
• 药水浏览器重建为视觉网格样式。
• 预设管理器新增作用域保存/读取与战斗快照支持。
• 使用自绘 RelicBrowserUI 替代原生遗物选择界面。
• 卡牌浏览器顶部栏替换为自定义 CardBrowserUI，含轨道滑动指示器。
• 统一所有 DevMode 面板为轨道拼接浏览器-面板布局。

Fixed ​

• 修复能力面板中能力应用不生效的问题。
• 修复添加药水 API 不正常的问题。
• 修复 MDI 图标 tree-shaking 回退导致构建后图标丢失的问题。

[0.1.0] - 2026-04-07 ​

Added ​

• 侧边栏面板分类：玩家、物品栏、状态、敌人、游戏。
  • 玩家：无敌、无限护盾/能源/星辉、防御倍率。
  • 物品栏：编辑金币、金钱倍率、商店免费购买、编辑能量上限、编辑药水槽数量。
  • 状态：始终奖励药水、始终升级卡牌奖励、最大卡牌奖励稀有度、最高分数、分数倍率。
  • 敌人：冻结敌人、一击必杀、伤害倍增。
  • 游戏：未知节点→宝藏、游戏速度。
• 运行时状态修改器：上帝模式、击杀全部敌人、无限能量、始终玩家回合、抽牌至上限、每回合额外抽牌、友方怪物自动行动、清除负面效果。
• 数值锁定：锁定金币、当前/最大 HP、当前/最大能量、星辉、宝珠槽位。
• 地图改写：强制所有房间为宝箱/精英/Boss，可保留最终 Boss。
• 能力选择面板，支持 4 种目标模式（自身、全体敌人、指定、友方）。
• 药水选择面板和事件选择面板。
• 卡牌编辑器：编辑基础费用、重放次数、伤害、格挡、消耗、虚无、不可打出、附魔。
• 预设管理器：保存/加载/导出/导入配装预设。
• 控制台命令手册 UI，支持搜索、原生命令和 DevMode 命令分区。
• 新增 10 个控制台命令模块（卡牌、作弊、敌人、事件、游戏、药水、能力、遗物、运行时、存档）。
• 重新设计 DevPanel 为 Apple 风格图标栏，统一覆盖层系统与滑入动画。
• Iconify MDI 适配器，构建时 tree-shaking；所有文字图标替换为真实 MDI 图标。
• 侧边栏面板点击锁定切换。
• 新增常驻开启 DevMode 开关，支持普通（非开发）对局使用。
• 存档/读档面板新增测试按钮。
• 多人游戏兼容补丁（过滤 mod 签名、规范化 ModelDb 哈希）。
• 资源预热服务，支持帧预算纹理/场景预加载。
• 跨版本 API 兼容层（Sts2ApiCompat）。

Changed ​

• 移除 StartingGold 覆盖，改用游戏默认金币。

Fixed ​

• 修复无限护盾在失去后未正确恢复的问题。
• 修复药水槽移除及数值锁定值未实时更新的问题。
• 修复切换标签页时覆盖层叠加而非关闭的问题。
• 修复 changelog 读写编码导致中文乱码的问题。

[0.0.1] - 2026-04-06 ​

Added ​

• 主菜单新增开发者模式面板。
• 支持自定义遗物、卡牌、金币及遭遇战，便于测试。
• 敌人遭遇战系统，含统一选择界面、战斗怪物生成及待机动画预览。
• 国际化支持，提供英文与简体中文本地化。
• 集成 STS2AI 模组，支持 AI 控制面板、速度与动画控制。