Game clocks may be used for various purposes, such as keeping an in-game calendar, tracking game effects and events, and limiting characters to acting at a slower pace suitable for a web-based game.
You may view all active game clocks from the Game Clock administration page, as well as create new clocks there. Additionally, you can create new game clocks programmatically with the API provided with the Game Clock module.
To do so, you would create a game clock array as follows:
<?php
$state = array(
'name' => $name, // A unique machine-name.
'title' => $title, // A human-readable title.
'type' => $type, // An optional string. Some modules may act only
// on events by clocks of a certain type.
'status' => $status, // If TRUE, then the clock will begin started.
// If FALSE it begins paused. Defaults to FALSE.
'turn' => $turn, // The current turn to begin the clock.
// Defaults to 0.
'increment' => $increment, // How many seconds before incrementing to the
// next turn. Defaults to 0 (never; must be
// manually incremented).
'block' => $block, // If TRUE, then a block displaying this clock's