Set Time

Play 0x71, server → client.

play · 0x71 · clientbound (server → client)

Synchronizes world time. gameTime is the total world age in ticks; clockUpdates carries the day-time clock, whether it advances, and at what rate. The server sends it every 20 ticks so the client’s sky and clocks stay in sync.

Sent by the server, read by the client. Listen for it with client.on("SetTime", (data) => …) on the receiving side.

Fields

Send it

await client.sendPacket("SetTime", {
  gameTime: 0n,
  clockUpdates: [
    { clock: 0, totalTicks: 6000n, partialTick: 0, rate: 1 }, // 0 = day/night clock; 6000 = noon
  ],
});

// Freeze the sun at noon.
await client.sendPacket("SetTime", {
  gameTime: 0n,
  clockUpdates: [{ clock: 0, totalTicks: 6000n, partialTick: 0, rate: 0 }],
});

gameTime is the world’s total tick count. Each clockUpdates entry sets one clock: totalTicks is its current value, rate how many ticks it advances per server tick on the client (0 stops it). Clock 0 is the day/night cycle (0 sunrise, 6000 noon, 12000 sunset, 18000 midnight). The vanilla server sends this every 20 ticks.

Field aliases listed under Notes are accepted as alternative keys when writing.

Source: src/Core/Versions/776/Packets/play/clientbound/SetTime.ts