Skip to content

数据类型

在 Maingraph for MC 中,节点之间通过不同类型的数据进行交互。你可以通过端口的颜色快速识别数据的类型。

类型列表

类型名称内部 ID端口颜色说明就像
执行流EXEC#FFFFFF控制逻辑运行的顺序,不传递具体数值。EXEC的图标
字符串STRING#DA00DA文本数据,如玩家名称、聊天消息等。STRING的图标
浮点数FLOAT#36CF36数字数据,支持小数。用于坐标、生命值、计算等。FLOAT的图标
布尔值BOOLEAN#920101逻辑值,仅包含 真 (True)假 (False)BOOLEAN的图标
列表LIST#FFCC00一组数据的集合,支持存储任何数据类型。LIST的图标
UUIDUUID#55FF55实体或玩家的唯一标识符。UUID的图标
枚举ENUM#FFAA00预定义的选项集合(如实体类型)。ENUM的图标
对象OBJECT#00AAFF复杂的对象数据。N/A
任意类型ANY#AAAAAA可以接受或输出任何类型的数据(如通用的 设置变量 节点)。ANY的图标

类型概念

1. 执行流 (EXEC)

  • 白色箭头代表执行流。
  • 逻辑总是沿着执行连线从左向右运行。
  • 如果一个节点的执行输入端口没有连线,该节点将永远不会被触发(事件节点除外,它们是执行的源头)。

2. 数据流

  • 彩色圆点代表数据端口。
  • 数据端口用于在节点之间传递具体的信息(如数字或文本)。
  • 注意: 你不能直接将一个类型的输出连接到不同类型的输入(除非使用“类型转换”节点)。

3. 类型转换 (Cast)

如果你需要将一个类型强制转换为另一个类型(例如将数字转换为字符串以便打印),请使用 逻辑 -> 数学与转换 -> 类型转换 节点。

4. 自动类型提升与原生流转 (v0.1.2+)

自 v0.1.2 版本起,引擎去字符串化 (De-stringification)

  • 原生流转:数字、布尔值和列表在引擎内部不再转换为字符串,而是以原生 Java 对象形式直接传递,这极大地提升了复杂脚本的执行效率。
  • 智能兼容:即使连接了不匹配的类型,引擎也会尝试在底层进行“无损转换”(例如在需要字符串的地方自动将数字转为文本),但在设计蓝图时,遵循颜色匹配依然是最佳实践。

欲了解更多关于新旧蓝图格式的区别,请参阅 蓝图格式版本

基于 VitePress 构建