使用指南
语言基础 / 基础值节点
语言基础 / 基础值 节点手册，包含 12 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
用可视化方式表达字符串、数组、对象、集合、日期、JSON 和基础运算。
覆盖范围
- 节点数量：12
- 分类路径：语言基础 / 基础值
典型使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
通用注意事项
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取值类型 | languageBaseValueTypeOf | 1 / 1 | 立即继续 |
| 空值回退 | languageBaseValueCoalesce | 2 / 1 | 立即继续 |
| 是否为 Null | languageBaseValueIsNull | 1 / 1 | 立即继续 |
| 是否为 Undefined | languageBaseValueIsUndefined | 1 / 1 | 立即继续 |
| 是否为空或未定义 | languageBaseValueIsNullOrUndefined | 1 / 1 | 立即继续 |
| 是否为空内容 | languageBaseValueIsEmpty | 1 / 1 | 立即继续 |
| 选择值 | languageBaseValueSelect | 3 / 1 | 立即继续 |
| 严格不相等 | languageBaseValueStrictNotEqual | 2 / 1 | 立即继续 |
| 严格相等 | languageBaseValueStrictEqual | 2 / 1 | 立即继续 |
| 转为布尔值 | languageBaseValueToBoolean | 1 / 1 | 立即继续 |
| 转为数字 | languageBaseValueToNumber | 1 / 1 | 立即继续 |
| 转为字符串 | languageBaseValueToString | 1 / 1 | 立即继续 |
获取值类型
获取值类型：返回一个简短的类型文本，告诉你这个值属于哪一类。 常见结果包括空值、布尔值、数字、文本、对象和函数对应的类型文本。 适合配合 字符串分支 或文本比较节点使用。注意：null 的类型结果是 object，这是本节点的固定输出规则。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueTypeOf |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 值 | 数据 | any | 待检查值 把你想判断、转换或查看类型的值连到这里。可以连接变量、组件读取结果、资产读取结果或其他数据节点输出。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 类型 | 数据 | string | 类型结果 输出游戏运行时类型文本，可继续接到 字符串分支、调试输出或严格文本比较节点。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
空值回退
空值回退：当主值不存在时，自动改用备用值。 只有左侧输入是 null 或 undefined 时，节点才会返回备用值；0、false 和空字符串都会原样保留。 适合为玩家属性、掉落配置或游戏运行时状态准备默认值，避免因为值缺失导致逻辑出错。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueCoalesce |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 主值 | 数据 | unknown | 主值 优先使用的值。只有它是 null 或 undefined 时，节点才会考虑右侧备用值。 | - | 必填 |
fallback | 备用值 | 数据 | unknown | 备用值 当主值不存在时返回这个值。若主值已经有效，这个输入不会改变输出结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | unknown | 输出结果 优先返回主值；只有主值是 null 或 undefined 时才返回备用值。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
是否为 Null
是否为 Null：只判断输入值是否等于 null。 如果你需要把 undefined 也算进来，请改用”是否为空或未定义”。适合区分某个配置被主动清空和从未被设置过这两种不同的空状态。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueIsNull |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 值 | 数据 | any | 待检查值 把你想判断、转换或查看类型的值连到这里。可以连接变量、组件读取结果、资产读取结果或其他数据节点输出。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 是 Null | 数据 | boolean | 判断结果 true 表示输入值正好是 null；undefined、0、false 和空字符串都会返回 false。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
是否为 Undefined
是否为 Undefined：只判断输入值是否等于 undefined。 适合判断某个变量还没有被赋值、或上游节点尚未产出结果的情况。它不会把 null 当成 undefined。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueIsUndefined |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 值 | 数据 | any | 待检查值 把你想判断、转换或查看类型的值连到这里。可以连接变量、组件读取结果、资产读取结果或其他数据节点输出。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 是 Undefined | 数据 | boolean | 判断结果 true 表示输入没有被提供；null 和其他正常值都会返回 false。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
是否为空或未定义
是否为空或未定义：判断一个值是不是”还没有可用内容”。 当输入是 null 或 undefined 时返回 true；数字 0、空字符串和 false 都不会被当作空值。 适合在判断玩家是否有存档数据、读取背包配置后先确认该值是否存在的场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueIsNullOrUndefined |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 值 | 数据 | any | 待检查值 把你想判断、转换或查看类型的值连到这里。可以连接变量、组件读取结果、资产读取结果或其他数据节点输出。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 为空 | 数据 | boolean | 判断结果 true 表示输入是 null 或 undefined；false 表示输入已经有实际内容。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
是否为空内容
是否为空内容：判断一个值是否”有内容可用”。 以下情况会返回 true：null、undefined、空字符串、空数组、没有自有字段的普通对象。 注意：数字 0 和 false 不会被视为空；组件、节点、Vec3 这类对象实例也不会因为”看起来没内容”就被判空。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueIsEmpty |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 值 | 数据 | any | 待检查值 把你想判断、转换或查看类型的值连到这里。可以连接变量、组件读取结果、资产读取结果或其他数据节点输出。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 为空内容 | 数据 | boolean | 判断结果 true 表示输入属于常见“空内容”范围；0、false 和对象实例不会被误判为空。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
选择值
选择值：根据一个布尔条件，在两个候选值之间选出一个结果。 条件为 true 时输出”成立时的值”，条件为 false 时输出”不成立时的值”。 注意：这是数据选择节点，不会像 Branch 那样控制两条执行路径。适合在不同游戏状态（如是否解锁某功能）下切换不同的配置参数。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueSelect |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
condition | 条件 | 数据 | boolean | 判断条件 勾选时输出“成立时的值”，取消勾选时输出“不成立时的值”。 | 开关 默认值：true | 必填 |
trueValue | 成立时的值 | 数据 | unknown | 成立时的值 当条件为 true 时，节点会把这个值送到输出端口。 | - | 必填 |
falseValue | 不成立时的值 | 数据 | unknown | 不成立时的值 当条件为 false 时，节点会把这个值送到输出端口。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | unknown | 选择结果 根据条件，从两个候选值中返回其中一个。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
严格不相等
严格不相等：判断两个值是否不完全相同。 不会自动做数字和文本之间的隐式转换，只要类型或内容有一处不同，就返回 true。 如果你需要的是”两个对象内容看起来是否一样”，这个节点并不适合；它仍然只判断是不是同一个实例。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueStrictNotEqual |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
left | 左值 | 数据 | unknown | 左值 参与比较的第一个值。可连接数字、文本、布尔值、对象或组件实例。 | - | 必填 |
right | 右值 | 数据 | unknown | 右值 参与比较的第二个值。节点会判断两个值是否不完全相同，不会自动在数字和文本之间转换。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 不相等 | 数据 | boolean | 比较结果 true 表示两个输入并不完全相同。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
严格相等
严格相等：判断两个值是否完全相同。 不会自动把数字和文本互相转换。例如数字 1 与文本 “1” 会返回 false。 注意：对象、数组、节点、组件等复杂值会按”是不是同一个实例”比较，而不是逐项比较内容。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueStrictEqual |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
left | 左值 | 数据 | unknown | 左值 参与比较的第一个值。可连接数字、文本、布尔值、对象或组件实例。 | - | 必填 |
right | 右值 | 数据 | unknown | 右值 参与比较的第二个值。节点会判断两个值是否完全相同，不会自动在数字和文本之间转换。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 相等 | 数据 | boolean | 比较结果 true 表示两个输入完全相同；对象、数组、节点和组件需要是同一个实例才算相同。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
转为布尔值
转为布尔值：把任意输入值转换成 true 或 false。 0、空字符串、null、undefined 和 NaN 会得到 false；大多数其他值会得到 true。 如果你想判断”有没有业务内容”，请优先使用”是否为空内容”，不要把两者混为一谈。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueToBoolean |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 值 | 数据 | any | 待检查值 把你想判断、转换或查看类型的值连到这里。可以连接变量、组件读取结果、资产读取结果或其他数据节点输出。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 布尔值 | 数据 | boolean | 转换结果 输入值会按游戏运行时真假判断规则转换成 true 或 false。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
转为数字
转为数字：把输入值转换成数字。 例如文本 ”12” 会变成 12，true 会变成 1，false 会变成 0。 注意：无法识别的文本会得到 NaN（非有效数字），建议配合”是否为有效数字”节点一起使用来检查结果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueToNumber |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 值 | 数据 | any | 待检查值 把你想判断、转换或查看类型的值连到这里。可以连接变量、组件读取结果、资产读取结果或其他数据节点输出。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 数字 | 数据 | number | 转换结果 输入值会按游戏运行时数字转换规则处理；无法识别的文本可能得到 NaN。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
转为字符串
转为字符串：把任意输入值转换成可显示的文本。 数字会变成数字文本，布尔值会变成 true/false，null 和 undefined 也会得到明确的表示。 适合在拼装 UI 文案、构造搜索关键字或准备日志内容前统一转成字符串。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseValueToString |
| 分类 | 语言基础 |
| 二级分类 | 基础值 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 值 | 数据 | any | 待检查值 把你想判断、转换或查看类型的值连到这里。可以连接变量、组件读取结果、资产读取结果或其他数据节点输出。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 文本 | 数据 | string | 转换结果 输入值会按游戏运行时规则转成文本，方便继续用于 UI、日志或字符串节点。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。