自动消耗热石

一个用于 龙之信条2：黑暗觉者 的小型体验优化（QOL）模组，当游戏检测到寒冷/冰冷状态时，会自动使用一个 热石。
我做这个模组是因为在诺甘白化期间，仅仅为了使用一个热石而不断打开物品栏实在太烦人了。这个模组只做一件事，而且仅此一件：
寒冷激活 → 自动使用一个热石。
仅此而已。

[heading]功能特性[/heading]
[list]
[]当寒冷/冰冷状态激活时，自动使用 一个热石。[/]
[]使用游戏原生的物品使用函数。[/]
[]仅针对合法的 热石 物品。[/]
[]在运行时验证目标物品的名称确实为
[code]Heatstone[/code]，然后才会使用。[/]
[]检查你的物品栏中是否确实拥有热石。[/]
[]使用 一次性锁存，因此不会快速消耗掉你整组热石。[/]
[]只有在之前的寒冷状态清除并开始新的寒冷事件后，才能再次使用新的热石。[/]
[]包含额外的冷却时间作为另一层保障。[/]
[]可随时通过 REFramework UI 启用或禁用。[/]
[]极其轻量。[/]
[]无需快捷键。[/]
[]无需操作物品栏菜单。[/]
[/list]
[heading]为什么锁存很重要[/heading]
该模组 不会 像自动点击器那样运作。
一旦它使用了一个热石，就会进入锁存状态，并在同一寒冷状态持续期间拒绝使用另一个。
换句话说：
一次寒冷事件 = 最多一次自动使用热石。
模组必须先观察到寒冷状态清除，才能为下一次寒冷事件重新武装。
这可以防止意外快速消耗多个热石。

[heading]安全性[/heading]
该模组刻意保持范围狭窄且保守。
它 不会：
[list]
[]生成物品。[/]
[]添加物品。[/]
[]直接删除物品。[/]
[]手动扣减物品栏数量。[/]
[]修改耐力。[/]
[]修改生命值。[/]
[]修改状态数值。[/]
[]修改随从。[/]
[]修改装备。[/]
[]修改任务。[/]
[]挂钩游戏函数。[/]
[]执行原始内存写入。[/]
[]直接编辑存档数据。[/]
[/list]脚本执行的唯一改变游戏玩法的操作是游戏原生的 使用物品 函数。
在此之前，模组会检查预期的物品 ID 在运行时是否解析为确切的名称：
[code]Heatstone[/code]如果验证失败，模组不会执行任何操作。

[heading]前置需求[/heading]
[list]
[]REFramework[/]
[]推荐使用 Fluffy Mod Manager 进行安装[/]
[]龙之信条2：黑暗觉者[/]
[/list]
[heading][size=5]安装[/size][/heading]
通过 Fluffy Mod Manager 安装压缩包并启用模组。

[heading][size=4]使用 Fluffy Mod Manager 安装[/size][/heading]
[list=1]
[]确保 REFramework for Dragon’s Dogma 2 已安装并正常工作。[/]
[]下载 AutoHeatstone ZIP 压缩包。
请勿手动解压该 ZIP 文件。[/]
[]打开 Fluffy Mod Manager 并选择 Dragon’s Dogma 2。[/]
[]打开 Mod List。[/]
[]使用以下任一方法将 AutoHeatstone 添加到 Fluffy：
[list]
[]拖放方法： 在 Windows 资源管理器中点击并按住下载的 AutoHeatstone ZIP 文件，将其拖到打开的 Fluffy Mod Manager 窗口上，然后松开鼠标按钮。Fluffy 应会自动将 ZIP 导入其模组列表。[/]
[]Add Mod(s) 方法： 使用 Fluffy 的 Add Mod(s) 选项，浏览到下载的 AutoHeatstone ZIP 文件，选择它并确认。[/]
[/list][/]
[]如果 AutoHeatstone 没有立即出现在列表中，请点击 Refresh Mod List。[/]
[]在模组列表中找到 AutoHeatstone，并使用模组旁边的复选框/开关启用它。[/]
[]启动龙之信条2。[/]
[]进入游戏后，按 Insert 打开 REFramework 菜单。[/]
[]展开：[/]
[/list]Script Generated UI → AutoHeatstone v1.0
如果 AutoHeatstone 面板出现在那里，说明模组已正确加载。
安装的 Lua 脚本最终应位于：
[code]Dragon's Dogma 2\reframework\autorun\AutoHeatstone.lua[/code]

** [size=4]卸载？[/size]**
关闭游戏，打开 Fluffy Mod Manager，在 Mod List 中禁用 AutoHeatstone。
你也可以在游戏运行时通过打开以下内容临时禁用该模组：
REFramework → Script Generated UI → AutoHeatstone v1.0
并取消勾选 Enabled。


[size=4]** 致不使用 Fluffy 的 REFramework 用户 -** [/size]

[size=4]** 安装 ** [/size]-

脚本/文件/.lua 文件放置于：
[code]reframework/autorun/AutoHeatstone.lua[/code]正常启动游戏。

[size=4]** 卸载？** [/size]
[size=4]1. 关闭游戏[/size]
[size=4]2. 删除该 lua 文件。[/size]
[size=4]完成。 [/size]


[heading]游戏内控制[/heading]
打开 REFramework 并前往：
Script Generated UI → AutoHeatstone
有一个 Enabled 复选框。
取消勾选它会立即禁用当前会话的自动使用热石功能。
如果你希望模组在多次启动之间完全禁用，请通过 Fluffy Mod Manager 禁用它。

[heading]工作原理[/heading]
该模组通过玩家的状态条件控制器监控游戏的寒冷状态。
当寒冷状态激活时：
[list=1]
[]模组确认目标物品确实是 热石。[/]
[]它确认你至少拥有一个。[/]
[]它会等待连续多次寒冷状态检查，以避免瞬时触发。[/]
[]它请求游戏使用恰好一个热石。[/]
[]它会锁存，并在寒冷清除之前拒绝使用另一个。[/]
[/list]没有物品栏刷屏，也没有重复使用循环。

[heading]兼容性[/heading]
由于这是一个小型 REFramework Lua 脚本，不替换任何游戏文件，因此通常应能与其他模组良好共存。
然而，与任何 REFramework 模组一样，未来的龙之信条2或 REFramework 更新可能会改变游戏内部 API。
如果发布了重大的游戏或 REFramework 更新，建议暂时禁用该模组，直到兼容性得到确认。
[heading]
致谢[/heading]
感谢 REFramework 项目让轻量级运行时脚本成为可能。
同时感谢 ItemBelt, Zephyr 的作者。ItemBelt 当前的黑暗觉者实现对于确认正确的热石物品数据以及游戏原生物品使用路径极为有用。
感谢 jeremy bentham 启发我让人们快乐！图片是 jeremy bentham 的。
GPT 5.6（中高思考模式）。