Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

如何将变量代入参数

由 Qwen3 优化了语法和格式,内容已经过验证。

在《文字游戏世界》中,开发者可以通过变量代入语法将游戏运行时的动态数据(如变量值、开关状态等)嵌入到事件参数中,从而实现内容的动态化与交互性。本文档详细说明变量与开关的代入方法、适用范围及注意事项。


1. 基本语法

《文字游戏世界》使用前缀标识符来区分不同类型的动态数据:

  • 变量(Variable):使用 v:变量名
  • 开关(Switch):使用 s:开关名

这些标识符可直接作为参数值写入事件配置中,引擎将在运行时自动解析并替换为实际值。

注意:变量名与开关名需与项目中定义的名称完全一致(包括大小写与空格)。


2. 应用示例

2.1 修改位置参数(pos

假设已定义一个名为 变量X 的数值变量,希望打字机事件的 X 坐标动态跟随该变量值:

"pos": [
  "v:变量X",
  0
]

此时,打字机文本的水平位置将实时反映 变量X 的当前数值。

2.2 控制遮挡逻辑(is_on_top_of_player

若希望打字机是否遮挡玩家由名为 开关Y 的布尔开关控制:

"is_on_top_of_player": "s:开关Y"

开关Y开启(true) 时,打字机文本将显示在角色上方;关闭(false)时则不会遮挡。

2.3 动态显示文本内容(texts

重要限制:打字机的 texts 字段不支持字符串拼接。若要显示变量或开关的值,texts 必须完全等于一个变量或开关的引用,不能包含其他静态文本。

✅ 正确用法:

"texts": "v:变量X"

"texts": "s:开关Y"

❌ 错误用法(不会按预期工作):

"texts": "当前分数:v:变量X"  // 静态文本 + 变量 → 只显示变量

替代方案:如需组合静态文本与动态值,建议使用多个打字事件;或是与固定物件拼接而成。


相关文档