对话与文本系统:变量替换与显示控制
任何游戏里写得最多的脚本都是对话。GB Studio 的 Text 事件看着只是一个文本框,底下却是一条完整的编译流水线:行数估算、窗口高度计算、滚动、变量替换。这一篇把它拆开,让你把对话框调教到随心所欲。
EVENT_TEXT 的编译流水线
你在文本框里写的话(文本字段本身是多行 textarea,可以随意换行分段),编译时会经历这样一条流水线:
- 估算行数:按文本内容与窗口宽度估算显示行数;
- 计算窗口高度:按最小/最大边界取值,内容多窗口高,内容少窗口矮;
- 启用滚动:超过单屏容量的文本自动滚动显示;
- 生成指令:编译进 textDialogue 对应的 GBVM overlay 指令——
VM_LOAD_TEXT(装载文本)与VM_DISPLAY_TEXT(分段显示)。
也就是说,"一段话"在引擎层是分段装载、逐段显示的,窗口高度是编译期算出来的,不是运行时猜的。
行为选项:模态与否是关键
Text 事件有一组行为开关,决定了对话怎么出现、怎么消失:
| 选项 | 行为 |
|---|---|
| 模态(默认) | 等窗口出现、文本显示完、玩家按 A 才关闭,脚本阻塞在此 |
| 文本完即关 | 文字显示完自动关闭,不再等按键 |
| 非模态 | 不阻塞后续脚本,适合边走边弹的世界观提示 |
| 关闭按钮 | 可设置,给玩家一个明确的"继续"提示 |
| 延迟 | 可设置,控制窗口出现或关闭的节奏 |
剧情对话保持默认模态最稳;快速过场提示用"文本完即关";想做一个不挡路的漂浮说明牌,就用非模态。拿不准就先模态——它是行为最可预期、最不容易出时序问题的选择。
变量替换:让文本活起来
文本里写 $42$,显示时会替换成变量 42 的当前值,并支持 %d 这类格式化写法——用它把金币、伤害值补齐成固定位数,数字对齐会好看很多。两个要点:替换发生在显示时,变量变了文本跟着变;引用了不存在的变量时补 0——不会报错,但会显示出一串莫名其妙的 0。所以看到对话里凭空冒出 0,第一反应应该是检查变量编号是不是写错了。这套变量与 脚本系统的变量是同一套数据,变量命名规范在这里同样适用。
字体:编译进 ROM 的资源
对话字体不是运行时加载的图片,而是编译后的字体资源,直接打进 ROM。历史版本支持最高 128px 高的字体 PNG,图块从 ASCII 0 起映射。这对中文创作者是个好消息:128px 的高度给了你排布整个常用汉字集的空间——前提是你得有一张含中文字形的字体资源。想显示中文,字体里必须有对应汉字,漏字会显示成空白。完整的中文显示与汉化流程,见 GB 游戏汉化指南。
别拿老教程的行宽数字规划排版
你在旧教程里可能见过"每行最多 52 字符(带头像 48)、最多 4 行"的说法——那是 2.0-beta5 时代的历史数据,现行版本的边界以你手上的发布版为准。大段文本动手前,先在模拟器里实测一次滚动和换行效果再定稿。
中文对话的两个实操要点
- 分行靠手动:textarea 里的换行就是实际的分行,按 R36S 屏幕宽度手动控制每行长度,别依赖自动折行;
- 字形覆盖要查全:把全部台词导出来核对一遍用字,字体资源里缺哪个字,玩家就会看到哪个空格——上线前的逐字检查值得花十分钟。