类型转换 (Cast)

• 分类: 逻辑 -> 数学与转换
• 内部 ID: cast

节点功能

将输入的数据强制转换为指定的目标类型。这是处理不同节点间数据对接的核心节点。

入参

端口名称	内部 ID	类型	说明
输入	input	任意 (ANY)	需要转换的原始数据。
目标类型	to_type	字符串 (STRING)	目标类型的名称（如 FLOAT, INT, BOOLEAN 等）。

出参

端口名称	内部 ID	类型	说明
输出	output	任意 (ANY)	转换后的数据。

转换规则详解

该节点会根据 目标类型 执行以下逻辑：

目标类型	转换逻辑	失败/空值处理
FLOAT	解析为浮点数（支持科学计数法）。	0.0
INT	先转为浮点数，再进行四舍五入取整。	0
BOOLEAN	仅 true 或 1 会转为 True，其余均为 False。	false
UUID	校验字符串是否符合标准 UUID 格式。	空字符串
STRING	直接转为字符串。	空字符串
LIST	将数据转为列表。支持解析旧版的 `	` 分隔字符串。

使用示例

场景：将计算结果显示在聊天栏

1. 加法 (+): 计算两个浮点数的结果。
2. 类型转换:
   • 将 加法 的结果连入 输入。
   • 目标类型 设置为 STRING（或由系统自动处理）。
3. 打印到聊天栏: 将转换后的结果发送给玩家。

---

提示：虽然大多数节点会自动尝试隐式转换，但使用 类型转换 节点可以确保逻辑的确定性，特别是在需要从 1.9 转换为整数 2 时非常有用。