Bukkit

WallClock

A clock on a sign that displays the time in the minecraft world, or it can display the time in the real world. Customizable, easy to use, and easy to set up.

A wall of clocks

Making a game clock

Usage

All clocks must be placed exclusively on a wall. Stand alone signs are ignored as clocks.

Basic Game Clock

To create a simple clock showing world time, create a wall sign with the following on the first line:

[gameclock]

Advanced Game Clock

To create a more advanced clock, create a wall sign with the following:

[gameclock]

ClockLabel

(unused)

Format

ClockLabel becomes "as is" line 2 on the clock. When no label is specified, it defaults to "Time" for Minecraft world clocks, and the short hand timezone for clocks showing time in real world.

The third line is unused and any text is ignored.

Format alters how the time is displayed. This text is passed to Java's SimpleDateFormat class, so see that doc for all the formats available. Clocks default to 12hr time, or as otherwise specified in the config file.

Note: All fields are optional and independent of each other

The Real World

To create a clock that displays the real time, make a sign with the following on the first line:

[realclock]

Advanced Real World Clock

To further customize your clock, create a wall sign with the following:

[realclock]

ClockLabel

TimeZone

Format

ClockLabel becomes "as is" line 2 on the clock. When no label is specified, it defaults to "Time" for Minecraft world clocks, and the short hand timezone for clocks showing time in real world.

TimeZone affects the timezone of clocks displaying real time, otherwise it is ignored. By default, the system timezone is used, but it may not be correct depending on what OS the server is running on due to a bug in Java.

Format alters how the time is displayed. This text is passed to Java's SimpleDateFormat class, so see that doc for all the formats available. Clocks default to 12hr time, or as otherwise specified in the config file.

Note: All fields are optional and independent of each other

Example

To create a clock with the label "IRL Time", displaying the Real world time in 24 hour format with a GMT offset of +1 hours, make a sign with the following:

[realclock]

IRL Time

GMT+1

HH:mm

Commands

The idea driving the plugin is the ability to create a clock without leaving the 'world' of minecraft by opening up the chat window, and as such there are almost no commands. The commands presently provided are available to the console and OPs only for maintenance and other mischief tinkers want to get into.

/wallclock save

Manually save all the clocks in the world to disk ("plugins/WallClock/clocks.csv").

/wallclock load

Manually load the saved clocks from disk ("plugins/WallClock/clocks.csv"). This WILL render any new clocks created since the last save non functional.

Source included with the jar