对话与文本系统:变量替换与显示控制

任何游戏里写得最多的脚本都是对话。GB Studio 的 Text 事件看着只是一个文本框,底下却是一条完整的编译流水线:行数估算、窗口高度计算、滚动、变量替换。这一篇把它拆开,让你把对话框调教到随心所欲。

EVENT_TEXT 的编译流水线

你在文本框里写的话(文本字段本身是多行 textarea,可以随意换行分段),编译时会经历这样一条流水线:

  1. 估算行数:按文本内容与窗口宽度估算显示行数;
  2. 计算窗口高度:按最小/最大边界取值,内容多窗口高,内容少窗口矮;
  3. 启用滚动:超过单屏容量的文本自动滚动显示;
  4. 生成指令:编译进 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 时代的历史数据,现行版本的边界以你手上的发布版为准。大段文本动手前,先在模拟器里实测一次滚动和换行效果再定稿。

中文对话的两个实操要点

下一步

对话里那些 $42$ 背后的变量与数组体系,读 脚本系统详解;对话挂在哪个脚本位上,读 世界编辑器核心。

↑