当玩家移动

• 分类: 事件 > 玩家事件
• 内部 ID: on_player_move

节点功能

该节点是蓝图逻辑的入口点。当服务器上的玩家发生位移（移动距离超过一定阈值）时，该节点将被触发。它不仅开启执行流，还会实时输出该玩家的位置信息、移动速度以及身份标识。

入参

无入参

出参

端口名称	内部 ID	类型	说明
输出	exec	执行流 (EXEC)	玩家移动后的逻辑执行出口。
X	x	浮点数 (FLOAT)	玩家当前的 X 坐标。
Y	y	浮点数 (FLOAT)	玩家当前的 Y 坐标。
Z	z	浮点数 (FLOAT)	玩家当前的 Z 坐标。
速度	speed	浮点数 (FLOAT)	玩家当前的移动速度（单位距离/每5刻）。
UUID	uuid	唯一标识符 (UUID)	移动玩家的唯一标识符。

使用示例

场景：检测玩家是否进入危险区域

如果你想在玩家移动到特定高度（例如 Y < -64）时给予警告：

1. 新建 当玩家移动 节点。
2. 将 Y 端口连接到 数值比较 中 小于（<） 节点的 A
3. 小于（<） 节点的 B 填写 -64
4. 小于（<） 节点的 条件 接口连接到 分支节点的条件接口，当玩家移动 节点的输出接口连接到 分支节点的输入接口。
5. 分支节点的 当条件为真 接口连接到 打印到聊天栏 节点，打印到聊天栏 节点的 消息 接口填写 落入虚空

---

提示：该节点由服务器每 5 刻（约 0.25 秒）检测一次，只有当玩家移动距离平方超过 0.25 时才会触发，以平衡性能与灵敏度。