脚本系统详解:变量、数组与事件流
你在编辑器里拖的每一个事件,都不是"录好的动作",而是一段会被编译成 GBVM 指令的程序。这一篇讲清楚这条编译链路,以及新版本带来的数组能力——背包、队伍、随机池这些 RPG 标配,从此有了正经的数据结构。
从事件到 GBVM:一条流水线
脚本的本质是编辑器事件序列。编译时,scriptBuilder 把事件逐个翻译成 GBVM 指令,交给引擎执行:
- 算术与逻辑运算 →
VM_RPN(表达式求值) - 变量赋值 →
VM_SET - 条件分支 →
VM_IF_CONST
你在事件面板里看到的"Set Variable""If Variable Compare",落到引擎层就是这几条指令。理解这一点的好处是:脚本不再是黑盒,出问题时你能想到"底层到底发生了什么",排查起来有的放矢。更底层的引擎细节见 GB Studio 进阶篇。
变量只有两种类型
当前版本的变量类型就两种:数字和定长数组。数组是新加入的能力,长度在创建时定死,之后不能伸缩。听起来简陋,但配合下面这套事件,足够撑起绝大多数游戏数据。常量是与变量并列的另一半:编译期就定死、运行期只读,适合放物品价格、伤害系数这类不随存档变化的数值,别拿变量硬扛。
数组全家桶
| 事件 / 函数 | 行为 |
|---|---|
| For Each Array Element | 遍历数组:索引从 0 起,逐元素拷贝到指定变量,自增到长度为止 |
| Shuffle Array | 原地洗牌,打乱元素顺序 |
| Array Set To Values | 批量写入:省略的项填 0,超长的项被忽略 |
| If Value In Array | 检查某个值是否存在于数组中 |
| len() | 表达式函数,返回数组长度,编译期直接算成常量 |
数组特性版本提示
定长数组及这套事件基于 develop 分支源码拆解,旧版发布版本没有这些能力,具体以你手上的发布版为准。
表达式:先变 RPN 再执行
所有表达式在编译期先经过逆波兰(RPN)转换——就是编译原理里的调度场算法——运行时直接栈式求值。len() 在编译期被算成常量,所以 len(array)+1 这样的表达式完全合法;但有一条硬规矩:对下标取 len 会被拒绝,arr[len] 这种写法通不过编译,想取最后一个元素就先用变量把长度存下来。
静态下标与运行时下标
同样是读数组元素,编译结果大不相同:静态下标(写死的数字)编译为地址偏移,零额外开销;运行时下标(变量)走间接指针,多一层寻址。两者功能等价、编译产物不同,是"同一事件、不同写法、不同性能"的典型例子。热循环里优先用静态下标,只有真正需要"按玩家选择取第几个"时才用变量下标。
自定义脚本事件:参数可以传数组
自定义脚本事件(Custom Script Event)的参数现在支持数组引用。这意味着你可以写一次"清空背包""给队伍加人"的通用逻辑存成自定义脚本,游戏里任何地方调用并传入不同数组——积木化复用从"复制粘贴事件"升级成了"传参调用"。
三条实用建议
- 变量务必命名:别用 Var12,用 has_key、gold、quest_stage。变量定义集中在 project/variables.gbsres 里,重命名一次,全局生效;
- 数组装"有序集合":背包格子、队伍成员、随机事件池、关卡分数榜,都是定长数组的本行;
- 洗牌 + For Each 是随机不重复抽取的组合拳:洗一次牌按顺序取,比"反复随机再查重"优雅得多,也省变量。