对话反应框架

这是一个MMAPI模组，需配合以下方式安装： 莫米作为一个 框架 供希望玩家能够对与NPC的对话做出反应的对白模组制作者使用。它应被用作 依赖，自身不产生任何效果。

你是否曾想让玩家对霍尔特的冷嘲热讽感到不悦，或被心仪恋爱对象调情后脸红？这个模组让这一切成为可能！

工作原理（简要说明）：

你的模组应包含一个名为以下名称的TOML文件 对话反应 在一个名为“fiddle”的文件夹里，里面的表格大致是这样的：

[海登_与阿里约会_吠叫测试]
npc_owner = "hayden"
脸红

这个TOML文件将包含Ari能够“反应”的每一段对话。表名和“npc_owner” 必须匹配 你尝试附加反应的对白，以及“npc_owner” 必须定义 对于每张表都要避免因对话恰好使用了相同表名而触发。 （这在恋爱对象的对话中很常见。）

我额外附带了一个使用此框架的示例模组，以便让你了解它的运作方式。要查看相关内容，请安装两个模组，然后与海登交谈。不要使用“t2 converse”这个烦人的命令，因为它不会触发此框架的任何代码。


完整参考

什么是“吠声”？
“Bark”是FoM开发者用来称呼NPC、有时是动物、以及过场动画中Ari（玩家）头顶经常出现的对话气泡和思考气泡的术语。在过场动画中，Mist文件可以执行Ari、Void Ari、玩家宠物甚至动物的bark。然而，日常对话（基本上是.c.toml）被硬编码为只允许NPC发出bark，因此需要这个框架。在这个框架中，bark值就是对话气泡或思考气泡内要使用的精灵图，正如MOMI wiki中关于对话的说明所述。 这里它的功能与NPC的常规吠叫动作完全相同。

其他选项
虽然必须定义“npc_owner”和“bark”，但还有第三个选项“bubble”：

[塞琳_双关]
所有者 = "霍尔特"
bark = "恼火"
bubble = “thought”

如果你愿意，你可以使用“thought”来显示思考气泡。默认行为是显示对话气泡，NPC也是如此。

限制
实现方式是通过提供一个 close_callback() 函数，该函数会在玩家关闭对话的最后一个对话框时运行。Ari 只会在对话结束时发出短促语音，而不是在对话中的某一句之后。（NPC 的短促语音也是如此。在整个对话表中指定的任何短促语音都只会在对话结束时触发，无论它们被放在哪里。）

一些极为小众的对话已经在使用close_callback()函数，因此由于此框架会覆盖现有的函数，它 不应用于编辑那些 对话这主要适用于约会接受对话，它们是最典型的例子。不过，约会接受台词本来就已经以阿里和其约会对象发出爱心叫声作为结尾了。


故障排除

与其他基于MMAPI的模组一样，此模组的日志位于你的本地应用数据中，具体路径为： 

%LOCALAPPDATA%/FieldsOfMistria/mod_data/jnk_ari_bark/logs/jnk_ari_bark.log

错误信息会显示在那里。

如果您正在尝试使用 混蛋 用“t2 converse”命令来测试你添加的短对话是行不通的，因为这个模组使用的是“dialogue.path”钩子，该钩子只在游戏调用play_conversation()函数时才会触发。“t2 converse”这个调试命令并不会调用play_conversation()，而是直接实例化一个对话驱动器来查看对话内容，因此不会出现玩家反应。我建议将你的测试对话优先级设置为priority = "max"，以便看到对话连同反应一起播放，正如我在提供的示例模组文件中所做的那样。 


特别鸣谢

特别感谢FoM模组Discord社区对我MOMI维基工作及其他模组项目的一贯支持，特别是Crys、ATD、Felix、Anna和Gareth。让我们继续在创作中互相支持！

这个框架是真正的零级水平。在任何时候、出于任何原因，都没有使用生成式AI、AI工具或AI代理。我创作是因为这是我的热情所在，也是为了磨练我的技能。