Skip to content

地图信息

属性

projectName

本张地图名称,对应项目设置中的名称。

定义于 #L9947


serverId

当前服务器ID

可通过teleport生成服务器ID。

定义于 #L9950


currentTick

默认值:0

世界当前的Tick计数。

定义于 #L9948


url

获取当前地图所在的URL链接地址。

定义于 #L9984


方法

onTick()

这是世界的计时事件,每64毫秒触发一次,Tick计数加1。

监听此事件可以让世界以64毫秒为间隔循环执行代码。

在理想情况下,每Tick为64毫秒。若网络发生延迟,可能会有变化。

输入参数

参数必填默认值类型说明
handlerfunction每64毫秒触发的处理函数

定义于 #L9784

点击查看示例代码
javascript
// 监听此事件,会在控制台持续输出 tick 计数
world.onTick(({ tick }) => {
  console.log('tick ' + tick);
});

javascript
// 当玩家进入地图
world.onPlayerJoin(({ entity }) => { // 每Tick的间隔向控制台输出提示
  const token = world.onTick(() => {
    console.log("tick !")
  }); // 2秒后,结束事件
  setTimeout(() => {
    console.log('cancel tick handler');
    token.cancel();  // 不再记录tick事件
  }, 2000);
});

接口

GameTickEvent

每一刻(tick)触发一次的事件

参数类型说明
ticknumber事件发生时间
prevTicknumber上一个已处理的时刻
elapsedTimeMSnumber两个时刻之间的时间间隔(毫秒)
skipboolean是否因为延迟而跳过了某些 Tick

定义于 #L12457