Skip to content

地图信息

属性

projectName

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

## serverId

当前服务器 ID

可通过teleport生成服务器 ID。

## currentTick

默认值:0

世界当前的 Tick 计数。


url

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


方法

onTick()

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

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

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

输入参数

参数必填默认值类型说明
handlerfunction每 64 毫秒触发的处理函数
点击查看示例代码
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