通过实体获取实体信息 (Get Entity Info by Entity)
通过实体获取实体信息 节点允许你从一个已有的实体对象中提取各项详细属性,如名称、唯一标识符(UUID)、坐标、生命值等。
节点概览
- 分类: 变量 > 实体
- 内部ID:
mgmc:get_entity_info_byentity 
端口定义
| 端口名称 | 类型 | 说明 |
|---|
| 实体 (Entity) | 实体 (Entity) | 需要提取信息的实体对象。 |
输出 (Outputs)
| 端口名称 | 类型 | 说明 |
|---|
| UUID (UUID) | UUID | 实体的唯一标识符(UUID)字符串。 |
| 名称 (Name) | 字符串 (String) | 实体的显示名称(如玩家名或生物自定义名)。 |
| 类型 (Type) | 字符串 (String) | 实体的类型名称。 |
| 注册名称 (Registry Name) | 字符串 (String) | 实体的注册 ID(如 minecraft:zombie)。 |
| XYZ 坐标 (XYZ) | XYZ | 实体当前所在的位置坐标。 |
| 生命值 (Health) | 浮点数 (Float) | 实体当前的生命值。非生物实体可能返回 0。 |
| 最大生命值 (Max Health) | 浮点数 (Float) | 实体的最大生命值上限。 |
| 是生物 (Is Living) | 布尔值 (Boolean) | 实体是否为生物(LivingEntity)。 |
| 是玩家 (Is Player) | 布尔值 (Boolean) | 实体是否为玩家。 |
| 是否在线 (Is Online) | 布尔值 (Boolean) | 如果是玩家,该玩家当前是否在线。 |
| 权限等级 (Permission Level) | 浮点数 (Float) | 如果是玩家,其当前的 OP 权限等级(0-4)。 |
行为说明
- 信息提取:该节点接收一个实体对象,并直接从中提取出该实体在当前时刻的所有状态属性。
- 纯值处理:这是一个纯值获取节点,不包含执行流。只要任何一个输出端口被引用,它就会执行一次属性提取逻辑并返回结果。
- 安全性:如果输入的实体对象为
null 或无效,所有输出端口都将返回其类型的默认值(如数值返回 0,对象返回 null)。 - 与按 UUID 获取的区别:此节点直接操作实体对象,效率更高,适用于你已经通过其他方式(如事件触发、变量获取)拿到实体引用的情况。