Flame 引擎 Jenny 对话系统命令详解stop立即终止当前节点执行【免费下载链接】flameA Flutter based game engine.项目地址: https://gitcode.com/GitHub_Trending/fl/flamestop是 Jenny 对话脚本语言Yarn Spinner 的一个 Flutter 实现内置于 Flame 游戏引擎中的内置控制流命令用于立即终止当前节点的求值其行为类似主流编程语言中的return;语句。本文将以 stop.md 为骨架结合 flame_jenny 的源码实现与测试用例系统讲解stop的语法、执行语义、底层原理、典型使用场景及其与jump、visit等命令的协同关系帮助你在游戏对话系统中精确控制流程终止与分支返回。命令概览语法与基本语义stop是 Jenny 的内置命令built-in command属于控制流命令家族。在 命令总览文档 中它被归类为与jump、visit、wait并列的流程控制指令。该命令的完整语法只有一条不接受任何参数stop其核心语义是立即停止求值当前节点效果等同于直接跳到当前节点的结尾。也就是说一旦脚本执行到stop位于其之后的所有语句无论是台词、选项还是其他命令都会被跳过不再执行。执行语义两种场景下的行为差异stop的具体效果取决于当前节点是如何被进入的场景一节点作为对话的起点根调用如果当前节点是通过DialogueRunner.startDialogue()直接启动的根节点那么stop的效果就是终止整段对话。位于stop之后的台词不会显示DialogueRunner会触发onDialogueFinish回调整场对话宣告结束。场景二节点被visit临时访问子调用如果当前节点是被其他节点通过 命令临时跳入的子节点那么stop只会退出当前子节点执行流会返回到父节点中visit之后的位置继续运行。因此官方文档将stop精确类比为许多编程语言中的return;——当它出现在函数节点中时立即结束当前函数的执行如果这个函数是被其他函数调用的则返回调用方继续执行。源码级剖析StopCommand的底层实现命令类的定义在 Jenny 运行时中stop被实现为StopCommand类定义于 stop_command.dartclass StopCommand extends Command { const StopCommand(); override String get name stop; override void execute(DialogueRunner dialogue) { dialogue.jumpToNode(null); } }从源码可以清晰看到name属性返回stop这也是解析器识别该命令的关键字它继承自 Command后者是所有内置命令与用户自定义命令的抽象基类提供了processInDialogueRunner()将命令派发给DialogueRunner.deliverCommand()的默认实现execute()的实际动作是调用dialogue.jumpToNode(null)——传入null表示不跳转到任何节点。jumpToNode(null)的关键作用jumpToNode定义于 dialogue_runner.dart其注释明确说明如果传入的nodeName为null则完全停止对话/// Stops the current node, and then starts running [nodeName]. If [nodeName] /// is null, then stops the dialogue completely. /// /// This command is synchronous, i.e. it does not wait for the node to /// *actually* finish (which calls the onNodeFinish callback). internal void jumpToNode(String? nodeName) { _currentIterator null; _nextNode nodeName; }这段实现揭示了两个重要事实置空迭代器_currentIterator null会立即中断当前节点剩余语句的迭代这正是跳过stop之后所有语句的机制来源置空下一个节点_nextNode null使得主循环_runNode中的while (_nextNode ! null)条件不成立于是整个对话流程结束。对话主循环如何响应_runNodedialogue_runner.dart是 Jenny 对话执行的虚拟机主循环Futurevoid _runNode(String nodeName) async { _nextNode nodeName; while (_nextNode ! null) { final node project.nodes[_nextNode!]; ... while (_currentIterator?.moveNext() ?? false) { final entry _currentIterator!.current; await entry.processInDialogueRunner(this); } _incrementNodeVisitCount(); await _event((view) view.onNodeFinish(node)); _currentNode null; _currentIterator null; } }当stop被处理时jumpToNode(null)同时将_currentIterator和_nextNode置空内层循环与外层循环都会立即退出随后的onNodeFinish与onDialogueFinish回调依次触发对话干净利落地收尾。值得注意的是源码注释指出jumpToNode是同步操作——它不会等待节点真正结束即不会阻塞等待onNodeFinish回调这让stop具有即时生效的特性。与jump、visit的对比为了准确理解stop的定位有必要将它与其他两个控制流命令放在一起对比命令行为编程语言类比参数立即结束当前节点若被访问则返回调用方return;无 停止当前节点并跳转到目标节点goto目标节点 ID 或{}表达式 挂起当前节点执行目标节点后恢复函数调用目标节点 ID 或{}表达式三者共享同一个底层机制jumpToNode(nodeName)jump Target等价于jumpToNode(Target)——_nextNode被设为目标节点名主循环继续执行新节点stop等价于jumpToNode(null)——_nextNode为null主循环终止visit则通过visitNode()dialogue_runner.dart保存当前迭代器后递归运行子节点子节点内的stop只会终止子节点的迭代器返回后父节点迭代器被恢复执行继续。实战示例在完整 Yarn 脚本中使用stop下面的例子展示了一个完整的节点结构关于节点语法可参阅 nodes.mdtitle: Guard_Dialogue --- Guard: Halt! Who goes there? - Im a friend. Let me pass. stop Guard: (这句不会显示) - Nothing to see here. Guard: Then move along. - Attack! jump BattleScene 在该示例中玩家选择我是朋友后stop立即结束Guard_Dialogue节点。由于该节点是对话起点整段对话随之结束玩家选择没事时对话正常继续到下一句台词玩家选择攻击时jump BattleScene接管流程跳转到战斗节点。与visit结合的子节点返回当stop出现在被visit访问的子节点中时它的返回语义尤为明显。参考 visit.md 中描述的用法title: RoamingTrader1 --- if $roaming_trader_introduced Hello again, {$player}! else visit RoamingTraderIntro endif - What do you have for trade? OpenTrade Pleasure doing business with you! #auto title: RoamingTraderIntro --- Trader: First time seeing me? Im the roaming trader. stop Trader: (这行不会显示控制权返回 RoamingTrader1) 当RoamingTraderIntro执行到stop时它只终止子节点自身的执行控制流随后返回父节点RoamingTrader1中visit之后的位置继续显示后续的选项与台词。这正是stop被比作return;的典型场景。语法约束与错误处理stop不接受任何参数。如果传入多余的内容例如stop 5解析器会抛出SyntaxError。这一点由 stop_command_test.dart 中的invalid syntax for stop测试用例直接验证其期望报错信息为SyntaxError: invalid token at line 3 column 8: stop 5 ^从 tokenize 的角度看stop会被切分为三个 tokenToken.startCommand、Token.commandStop、Token.endCommand见同文件中的tokenize stop测试。因此写作脚本时应严格遵守无参数、无空格的规范写法实际解析器对空格是宽容的 stop 同样可被解析但标准写法为stop。测试用例验证执行行为stop_command_test.dart 中的核心测试normal command stop用最简洁的方式证明了命令的截断效果test(normal command stop, () async { await testScenario( input: title: Start --- before stop stop after stop , testPlan: line: before stop , ); });输入脚本中stop之前的before stop台词被正常投递而stop之后的after stop永远不会出现——测试计划中只包含第一行。此外visit_command_test.dart 中的visit node with jumps测试还组合验证了visit、jump、stop三者联动时stop只终止当前节点、执行流最终回到最初父节点的完整链路可作为理解返回语义的参考用例。最佳实践与注意事项用作提前收尾当某条剧情分支需要提前结束对话如 NPC 无话可说、剧情被截断时在分支块末尾放置stop避免后续语句误执行配合visit拆分节点当节点过长时参考 nodes.md 的建议将大节点拆分为若干小节点用visit调用、用stop让子节点提前返回可有效复用公共台词并保持脚本结构清晰区分结束对话与切换节点需要彻底终止对话用stop需要转移到另一个节点用jump需要临时插入内容并返回用visit三者不可混淆保持零参数stop不接受任何参数误加参数会在解析阶段直接报SyntaxError需在脚本编写时留意。总结stop是 Jenny 对话语言中最基础也最重要的控制流原语之一。从 stop.md 的定义出发结合 stop_command.dart 的实现可以看到它本质上是jumpToNode(null)的语法糖通过同时置空节点迭代器与下一个节点引用来实现立即终止当前节点、必要时返回调用方的语义与编程语言中的return;高度一致。掌握它与jump、visit的分工与配合是编写结构清晰、流程可控的 Flame 游戏对话脚本的关键一步。延伸阅读命令总览 · 命令· 命令· 节点语法 · 选项语法 · Jenny 语言总览【免费下载链接】flameA Flutter based game engine.项目地址: https://gitcode.com/GitHub_Trending/fl/flame创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Flame 引擎 Jenny 对话系统命令详解：`＜＜stop＞＞` 立即终止当前节点执行
Flame 引擎 Jenny 对话系统命令详解stop立即终止当前节点执行【免费下载链接】flameA Flutter based game engine.项目地址: https://gitcode.com/GitHub_Trending/fl/flamestop是 Jenny 对话脚本语言Yarn Spinner 的一个 Flutter 实现内置于 Flame 游戏引擎中的内置控制流命令用于立即终止当前节点的求值其行为类似主流编程语言中的return;语句。本文将以 stop.md 为骨架结合 flame_jenny 的源码实现与测试用例系统讲解stop的语法、执行语义、底层原理、典型使用场景及其与jump、visit等命令的协同关系帮助你在游戏对话系统中精确控制流程终止与分支返回。命令概览语法与基本语义stop是 Jenny 的内置命令built-in command属于控制流命令家族。在 命令总览文档 中它被归类为与jump、visit、wait并列的流程控制指令。该命令的完整语法只有一条不接受任何参数stop其核心语义是立即停止求值当前节点效果等同于直接跳到当前节点的结尾。也就是说一旦脚本执行到stop位于其之后的所有语句无论是台词、选项还是其他命令都会被跳过不再执行。执行语义两种场景下的行为差异stop的具体效果取决于当前节点是如何被进入的场景一节点作为对话的起点根调用如果当前节点是通过DialogueRunner.startDialogue()直接启动的根节点那么stop的效果就是终止整段对话。位于stop之后的台词不会显示DialogueRunner会触发onDialogueFinish回调整场对话宣告结束。场景二节点被visit临时访问子调用如果当前节点是被其他节点通过 命令临时跳入的子节点那么stop只会退出当前子节点执行流会返回到父节点中visit之后的位置继续运行。因此官方文档将stop精确类比为许多编程语言中的return;——当它出现在函数节点中时立即结束当前函数的执行如果这个函数是被其他函数调用的则返回调用方继续执行。源码级剖析StopCommand的底层实现命令类的定义在 Jenny 运行时中stop被实现为StopCommand类定义于 stop_command.dartclass StopCommand extends Command { const StopCommand(); override String get name stop; override void execute(DialogueRunner dialogue) { dialogue.jumpToNode(null); } }从源码可以清晰看到name属性返回stop这也是解析器识别该命令的关键字它继承自 Command后者是所有内置命令与用户自定义命令的抽象基类提供了processInDialogueRunner()将命令派发给DialogueRunner.deliverCommand()的默认实现execute()的实际动作是调用dialogue.jumpToNode(null)——传入null表示不跳转到任何节点。jumpToNode(null)的关键作用jumpToNode定义于 dialogue_runner.dart其注释明确说明如果传入的nodeName为null则完全停止对话/// Stops the current node, and then starts running [nodeName]. If [nodeName] /// is null, then stops the dialogue completely. /// /// This command is synchronous, i.e. it does not wait for the node to /// *actually* finish (which calls the onNodeFinish callback). internal void jumpToNode(String? nodeName) { _currentIterator null; _nextNode nodeName; }这段实现揭示了两个重要事实置空迭代器_currentIterator null会立即中断当前节点剩余语句的迭代这正是跳过stop之后所有语句的机制来源置空下一个节点_nextNode null使得主循环_runNode中的while (_nextNode ! null)条件不成立于是整个对话流程结束。对话主循环如何响应_runNodedialogue_runner.dart是 Jenny 对话执行的虚拟机主循环Futurevoid _runNode(String nodeName) async { _nextNode nodeName; while (_nextNode ! null) { final node project.nodes[_nextNode!]; ... while (_currentIterator?.moveNext() ?? false) { final entry _currentIterator!.current; await entry.processInDialogueRunner(this); } _incrementNodeVisitCount(); await _event((view) view.onNodeFinish(node)); _currentNode null; _currentIterator null; } }当stop被处理时jumpToNode(null)同时将_currentIterator和_nextNode置空内层循环与外层循环都会立即退出随后的onNodeFinish与onDialogueFinish回调依次触发对话干净利落地收尾。值得注意的是源码注释指出jumpToNode是同步操作——它不会等待节点真正结束即不会阻塞等待onNodeFinish回调这让stop具有即时生效的特性。与jump、visit的对比为了准确理解stop的定位有必要将它与其他两个控制流命令放在一起对比命令行为编程语言类比参数立即结束当前节点若被访问则返回调用方return;无 停止当前节点并跳转到目标节点goto目标节点 ID 或{}表达式 挂起当前节点执行目标节点后恢复函数调用目标节点 ID 或{}表达式三者共享同一个底层机制jumpToNode(nodeName)jump Target等价于jumpToNode(Target)——_nextNode被设为目标节点名主循环继续执行新节点stop等价于jumpToNode(null)——_nextNode为null主循环终止visit则通过visitNode()dialogue_runner.dart保存当前迭代器后递归运行子节点子节点内的stop只会终止子节点的迭代器返回后父节点迭代器被恢复执行继续。实战示例在完整 Yarn 脚本中使用stop下面的例子展示了一个完整的节点结构关于节点语法可参阅 nodes.mdtitle: Guard_Dialogue --- Guard: Halt! Who goes there? - Im a friend. Let me pass. stop Guard: (这句不会显示) - Nothing to see here. Guard: Then move along. - Attack! jump BattleScene 在该示例中玩家选择我是朋友后stop立即结束Guard_Dialogue节点。由于该节点是对话起点整段对话随之结束玩家选择没事时对话正常继续到下一句台词玩家选择攻击时jump BattleScene接管流程跳转到战斗节点。与visit结合的子节点返回当stop出现在被visit访问的子节点中时它的返回语义尤为明显。参考 visit.md 中描述的用法title: RoamingTrader1 --- if $roaming_trader_introduced Hello again, {$player}! else visit RoamingTraderIntro endif - What do you have for trade? OpenTrade Pleasure doing business with you! #auto title: RoamingTraderIntro --- Trader: First time seeing me? Im the roaming trader. stop Trader: (这行不会显示控制权返回 RoamingTrader1) 当RoamingTraderIntro执行到stop时它只终止子节点自身的执行控制流随后返回父节点RoamingTrader1中visit之后的位置继续显示后续的选项与台词。这正是stop被比作return;的典型场景。语法约束与错误处理stop不接受任何参数。如果传入多余的内容例如stop 5解析器会抛出SyntaxError。这一点由 stop_command_test.dart 中的invalid syntax for stop测试用例直接验证其期望报错信息为SyntaxError: invalid token at line 3 column 8: stop 5 ^从 tokenize 的角度看stop会被切分为三个 tokenToken.startCommand、Token.commandStop、Token.endCommand见同文件中的tokenize stop测试。因此写作脚本时应严格遵守无参数、无空格的规范写法实际解析器对空格是宽容的 stop 同样可被解析但标准写法为stop。测试用例验证执行行为stop_command_test.dart 中的核心测试normal command stop用最简洁的方式证明了命令的截断效果test(normal command stop, () async { await testScenario( input: title: Start --- before stop stop after stop , testPlan: line: before stop , ); });输入脚本中stop之前的before stop台词被正常投递而stop之后的after stop永远不会出现——测试计划中只包含第一行。此外visit_command_test.dart 中的visit node with jumps测试还组合验证了visit、jump、stop三者联动时stop只终止当前节点、执行流最终回到最初父节点的完整链路可作为理解返回语义的参考用例。最佳实践与注意事项用作提前收尾当某条剧情分支需要提前结束对话如 NPC 无话可说、剧情被截断时在分支块末尾放置stop避免后续语句误执行配合visit拆分节点当节点过长时参考 nodes.md 的建议将大节点拆分为若干小节点用visit调用、用stop让子节点提前返回可有效复用公共台词并保持脚本结构清晰区分结束对话与切换节点需要彻底终止对话用stop需要转移到另一个节点用jump需要临时插入内容并返回用visit三者不可混淆保持零参数stop不接受任何参数误加参数会在解析阶段直接报SyntaxError需在脚本编写时留意。总结stop是 Jenny 对话语言中最基础也最重要的控制流原语之一。从 stop.md 的定义出发结合 stop_command.dart 的实现可以看到它本质上是jumpToNode(null)的语法糖通过同时置空节点迭代器与下一个节点引用来实现立即终止当前节点、必要时返回调用方的语义与编程语言中的return;高度一致。掌握它与jump、visit的分工与配合是编写结构清晰、流程可控的 Flame 游戏对话脚本的关键一步。延伸阅读命令总览 · 命令· 命令· 节点语法 · 选项语法 · Jenny 语言总览【免费下载链接】flameA Flutter based game engine.项目地址: https://gitcode.com/GitHub_Trending/fl/flame创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考