玩家进入/离开地图

方法

onPlayerJoin()

当玩家加入地图时触发

输入参数

参数	必填	默认值	类型	说明
handler	是		function	监听到玩家加入时的处理函数

定义于 #L10253

点击查看示例代码

// 玩家进入地图时，向TA发送一条私信。
world.onPlayerJoin(({ entity }) => {
  entity.player.directMessage(`你好，${entity.player.name}`);
});

---

// 玩家进入地图时，开启飞行功能
world.onPlayerJoin(({ entity }) => {
  entity.player.canFly = true;
});

---

const TEST_PLAYER = ['吉吉喵', '搬砖喵', '美术喵', '文档喵']

world.onPlayerJoin(({ entity }) => {
  if (!TEST_PLAYER.includes(entity.player.name)) return; // 如果玩家名称不在列表里，则跳过后续脚本。
  world.say(`${entity.player.name} 出现了！`);
})

---

onPlayerLeave()

当玩家离开地图时触发

输入参数

参数	必填	默认值	类型	说明
handler	是		function	监听到玩家离开时的处理函数

定义于 #L10258

点击查看示例代码

// 玩家离开地图时，在控制台输出玩家的名字。
world.onPlayerLeave(({ entity }) => {
  console.log(`玩家 ${entity.player.name} 退出了地图。`);
});

接口

GamePlayerEntityEvent

当创建或销毁实体时触发的事件

参数	类型	说明
entity	GameEntity	创建的实体
tick	number	事件发生时间