← all modules

A block-driven world tick — one shared clock nobody controls. Derive day/night, seasons and rounds from block height.

Install

Example

import { createClock, BLOCKS_PER_DAY } from "@metanet-games/chainclock";

const clock = createClock({ genesis: 900000 }); // height 900000 = tick 0
clock.on("tick", ({ tick, height, hash }) => advanceWorld(tick));

clock.update({ height, hash, time });            // feed new tips
clock.phase(BLOCKS_PER_DAY, ["dawn","day","dusk","night"]);

Plug it into your game

Feed it chain tips and every block becomes a tick — a schedule every player shares with no time server. Derive day/night, seasons, or rounds from block height. Gate meaningful outcomes on tick/hash; the smooth progress() between blocks is for animation only, never for consensus.