block-o-clock

A Spigot (Bukkit) Minecraft plugin that allows to create clocks of blocks in the world

Features [WIP]

• Clock creation with lots of settings
  • location in the world
  • time format
  • time zone / non-synced (acts like a timer or a stopwatch)
  • foreground and background block types
  • font and its size
• Clock list display
  • in order
  • sorted by distance
• Clock deletion
• Clock starting and stopping (freezing)
• Non-synced clock settings
  • time
  • direction
• Handy tab-completion
• Clock protection (players cannot break clock's blocks)
• Clock info serialization into custom config to keep running after server restart
  • Temporary behaviour: deleting all clocks before plugin disable (configurable)

Usage

Commands

/blockoclock is the main plugin command, which has an alias /boc.

Command	Description
/boc help [command]	Show help for given command, for available commands otherwise
/boc list <nearest|ordered> [page=1]	List all clocks in the world (with IDs) with given sorting
/boc create <*settings>	Create new clock in the world (and print its ID)
/boc delete <id>	Delete the clock (and fill it with air)
/boc start <id>	Start stopped clock
/boc stop <id>	Stop the clock (won't update until calling /boc start for it)
/boc set time <id> <HH:mm:ss.tt>	Set given time on non-synced clock (if the time unit is not displayed its value can be just zeros)
/boc set direction <id> <up|down>	Set given direction on non-synced clock
/boc reload	Reload config

/boc create syntax

/boc create <dim> <xyz> ±<x|y|z> ±<x|y|z> <hour|min|sec|tick> <hour|min|sec|tick> <±hh[:mm]|none> <block|none> <block|none> <font> [size=3]

• <dim> - minecraft dimension: overworld, nether, end
• <xyz> - coordinates of top left corner of the display area
• ±<x|y|z> (2 times) - directions of the horizontal and vertical axes respectively (example: -x +z)
• <hour|min|sec|tick> (2 times) - largest and smallest time units to display (example: min tick will show mm:ss.tt)
• <±hh[:mm]|none> - timezone to sync with (examples: +03, -10, +06:45) or none for manual control
• <block|none> (2 times) - foreground and background block IDs respectively (none will not fill, while air will fill with air)
• <font> - font type: minecraft, digital (seven-segment-like)
• [size=3] - digital font size, default is 3 (ignored if minecraft font is specified)

Configuration (default)

• Default digital font size
• /boc list page size
• Temporal: whether to delete all clocks before plugin disable
• Plugin messages
  • info
  • error
  • help

Permissions

Permission node	Default	Description
blockoclock.help	true	Allows to use /boc help (lists only available commands)
blockoclock.list	op	Allows to use /boc list
blockoclock.create	op	Allows to use /boc create
blockoclock.delete	op	Allows to use /boc delete
blockoclock.start	op	Allows to use /boc start
blockoclock.stop	op	Allows to use /boc stop
blockoclock.set	op	Allows to use /boc set
blockoclock.reload	op	Allows to use /boc reload
blockoclock.use	op	Refers to blockoclock.list, blockoclock.start, blockoclock.stop and blockoclock.set by default
blockoclock.manage	op	Refers to blockoclock.create, blockoclock.delete and blockoclock.use by default
blockoclock.admin	op	Refers to blockoclock.reload and blockoclock.manage by default

Special thanks to:

• Legitimoose for amazing Paper (Bukkit) plugin (in Kotlin) project setup tutorial
• BeBr0 for Spigot (Bukkit) plugin development tutorial [RU] with very clear API explanation

Copyright

The project itself is distributed under GNU GPLv3.