Bukkit

Overview

Checkers supports Time Controls, which allow you to put a time limit on the length of games. These are the possible time control types:

Setting the Time Control on a Game

There are two ways to set a time control on a game:

1) Using the /checkers tc <time-control> command, e.g.:

/checkers tc M/30

2) Using the Time Control control panel sign. Left-click the sign to cycle through the available predefined time controls, or right-click to cycle backwards through the list. The time control shown on the sign will be used when the game is started. See Predefined Time Controls below for more information on how to add your own definitions.

You must set the game's time control after the game has been created, but before the game has been started. Once the game has started, the time control cannot be changed!

When a time control is active on a game (i.e. not None), the clock displays on the board's control panel will change from showing an elapsed time to a remaining time for each player. In addition, players will be periodically warned when they are running out of time to make a move (by default when 30 seconds remains, but see the time_control.warn_seconds setting in the Configuration.

Default Time Controls

By default, new games do not have any time control associated with them. There are two ways of setting a default time control:

• You can set a global default time control with the time_control.default configuration setting, e.g. /checkers set time_control.default G/60
• You can set a per-board default time control with the default_tc board attribute, e.g. /checkers board set default_tc G/60 (while standing on the board you want to change)

Per-board settings will override the global setting. To remove a per-board setting, do /checkers board set default_tc ""

You can also lock the time control on a per-board basis with the lock_tc board attribute, so that players cannot change it. E.g. to enforce a G/40 time control on a board:

/checkers board set default_tc G/40
/checkers board set lock_tc true

Predefined Time Controls

You can add your own predefined time controls by editing the timecontrols.yml file in the main plugin directory (/plugins/Checkers/). This file contains a list of time control definitions. Here is the file:

# This file contains a set of predefined time controls.  These can be selected via the control
# panel by left- or right-clicking the "Time Control" sign.
#
# Edit this as you please, and run "/checkers reload tc" when finished (or restart the server).
# Be sure to use valid YAML!  No tabs, and consistent indentation!
#
# The "label" must fit on three lines of the sign.  Use ";" for line breaks, no more than 15 
# characters per line.
#
# See http://dev.bukkit.org/server-mods/checkers/pages/time-controls for a description
# of the "spec" string.
#

time_controls:
  - label: None
    spec: None
  - label: 'Move;in 6 minutes;(Official)'
    spec: M/360
  - label: Game in 30;minutes
    spec: G/30