翎风脚本语言规约

本文把翎风引擎 CHM 帮助文档整理成脚本语言阅读入口。完整命令、检测、触发、数据库字段和示例仍以 结构化资料索引 的原文条目为准。

脚本模型

翎风脚本是面向事件和标签的行式脚本。一个脚本文件由若干标签段组成，标签段以 [@标签名] 开始，后面跟条件块、动作块、对话块或普通文本。

常见结构：

[@main]
#IF
检测命令 参数
#ACT
动作命令 参数
#SAY
对话文本
#ELSEACT
失败动作
#ELSESAY
失败对话

核心执行关系：

• [@label] 定义入口。
• #IF 下的检测命令全部成功，才执行后续 #ACT 或 #SAY。
• #OR 下的检测命令任意一个成功，就执行后续 #ACT 或 #SAY。
• NOT 取反紧随其后的单条检测命令。
• #ELSEACT 和 #ELSESAY 是上一组条件失败时执行的分支。
• GOTO @label 改变执行位置。
• BREAK 中止当前执行流。
• CLOSE 关闭对话框。

入口和触发

常见入口标签包括：

需要确认某个标签是否存在、出现在哪些原文页面里，优先查 Symbol 索引。

变量和文本

翎风文档中大量使用脚本变量、替换变量和文本占位符：

• P/D/M/N/S/I/G/A/U/T 等变量族用于保存数值或字符串。
• N$变量名、S$变量名 这类自定义变量在原文示例中频繁出现。
• <$...> 是替换变量，常用于对话、消息、路径或命令参数。
• %s、%d 等百分号占位符用于某些消息或文件格式。

变量、替换变量和文件名的反查入口是 Symbol 索引。

文件和资料层

翎风 CHM 里除了脚本命令，还包含数据库资料、地图参数、FAQ、技能资料、NPC 图片资源和更新记录。结构化页面按原始目录归类：

• 功能操作命令
• 脚本检测命令
• 特殊触发功能
• 游戏功能详解和文件格式
• DB 数据库资料
• 部分脚本实例
• 兼容 HeroM2 资料
• 常见问题解答
• 原始资源附件

查单个命令或文件格式时，先用 结构化资料索引；需要核对抽取是否完整时，再看 原始文档库。