Clockdisplay 1.0

Tested Minecraft Versions:

• 1.8

Clockdisplay

This plugin allows you to place analog particle clocks anywhere in your worlds.
You can define as many clocks as you want in the configuration file.
Each single one can be defined in detail seperately.

Features:

• Multi-world supported
• Unlimited clocks
• Rotatable by custom yaw & pich, allows any rotation
• Custom definable viewdistance
• Custom definable size
• Custom definable clock-hands:
  Each clock has its own 3 particle types for their hands
• Custom definable particle spawn interval

Configuration:

Code (YAML):

# --------------------------------
# Syntax:
#
# 1.: unique clock name
#     could be any string
#
# 2.: clock position definded by: 'world,X,Y,Z,yaw,pitch,viewdistance'
#     world: a valid worldname of your server, where the clock should be
#     X,Y,Z: coordinates as decimal number eg.: 0.0,64.0,0.0 -> X = 0, Y = 64, Z = 0
#     yaw: Rotation by y axis eg.: 0.0,180.0 -> horizontally, 12 o'clock facing east; 180.0,180.0 -> horizontally, 12 o'clock facing west
#     pitch: Rotation by Yaw axis eg.: 90.0,90.0 -> vertically with front north; 270.0,90.0 -> vertically with front south
#     viewdistance: Define, how far your clock should be visible. Players won't see it, if they're farer away than the viewdistance.
#
# 3.: clock radius (clock hand length)
#     second-hand will be 100%, minute-hand 80% and hour-hand 60% of length
#
# 4., 5., 6.: clock hand particles defined by: 'particlename,particle-count,particle-speed,particle-data-id,particle-data'
#     Particles will be spawn by a static distance of 0.2 blocks for each hand.
#     particlename: see here https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Effect.html
#     particle-count: Use this value to define how many particles should spawn at the each spawnlocation at the same time
#     particle-speed: velocity of particles (0.0 is recommended to display non-deformed clock hands)
#     particle-data-id, particle-data: unknown. see here https://hub.spigotmc.org/javadocs/spigot/org/bukkit/World.Spigot.html -> play effect
#
# 7.: particle spawn interval by ticks
#     in general 20 ticks = 1 second, set it so, that your hands will be displayed nicely (depending on your chosen particle)
#
# --------------------------------
# I defined 3 example clocks for you (a, b, c). These are showing some suitable particles and example rotations
# Delete them, if you managed to define your own.
# You can mix up the particles just as you want.
#
# --------------------------------
clocks:
  a:
    location: 'world,0.0,67.5,-10.0,270.0,135.0,127'
    radius: 4
    particle-hour: 'PARTICLE_SMOKE,10,0.0,0,0'
    particle-minute: 'PARTICLE_SMOKE,10,0.0,0,0'
    particle-second: 'COLOURED_DUST,5,0.0,0,0'
    interval: 10
  b:
    location: 'world,-8.0,67.5,-10.0,270.0,90.0,127'
    radius: 4
    particle-hour: 'SMALL_SMOKE,20,0.0,0,0'
    particle-minute: 'HAPPY_VILLAGER,1,0.0,0,0'
    particle-second: 'FLAME,1,0.0,0,0'
    interval: 10
  c:
    location: 'world,-16.0,67.5,-10.0,0.0,180.0,127'
    radius: 4
    particle-hour: 'FOOTSTEP,1,0.0,0,0'
    particle-minute: 'WATERDRIP,1,0.0,0,0'
    particle-second: 'POTION_SWIRL,20,0.0,0,0'
    interval: 20

This customizability brings many advantages, but only one problem. You need to define all those custom things. I tried to explain as best as I could how clocks where defined within the configuration header, read it attentive.
Also the 3 example clocks should help to understand what's what.
I also tested all 1.8 particles and found many suitable for a clock:

Spoiler: suitable particle effects

• HAPPY_VILLAGER: recommended
• FLAME: recommended
• COLOURED_DUST: recommended
• NOTE: ok to use
• LAVADRIP: ok to use
• PARTICLE_SMOKE: ok to use
• WATERDRIP: ok to use
• SMALL_SMOKE: ok to use
• FOOTSTEP: for slow moving hands (hour / Minute)
• CLOUD: maybe...
• SLIME: maybe...
• LARGE_SMOKE: maybe...
• SPELL: only for horizontally clocks (particles flying up)
• INSTANT_SPELL: only for horizontally clocks (particles flying up)
• WITCH_MAGIC: maybe... only for horizontally clocks (particles flying up)
• POTION_SWIRL: maybe... only for horizontally clocks (particles flying up)
• POTION_SWIRL_TRANSPARENT: maybe... only for horizontally clocks (particles flying up)
• VILLAGER_THUNDERCLOUD: maybe... only for horizontally clocks (particles flying up)
• FIREWORKS_SPARK: only for horizontally clocks (particles falling down)
• CRIT: only for horizontally clocks (particles falling down)
• PORTAL: only for horizontally clocks (particles falling down)
• FLYING_GLYPH: maybe... only for horizontally clocks (particles falling down)
• HEART: maybe... only for horizontally clocks (particles falling down)
• SNOW_SHOVEL: maybe... only for horizontally clocks (particles falling down)

All other particles where not really suitable to create stable clock hands. But can be used, too of course.
New 1.9 particles untested, but should work.

• No external API used (only Spigot)
• No other plugins necessary
• Detailed tested on Spigot 1.8.8 without any problems
• Compiled by Java 8 SDK, your Server should be running on Java 8 JRE to use this plugin

Need additional Features or got some interesting ideas?
Leave a reply and i'll add this or other functions if requested.

Special thanks to @patricianko who gave me the idea of this plugin (here).

Replys, ratings and suggestions welcome.

Some screenshots:

Spoiler: Screenshots

I would love to see some of you sharing your own designed clocks, just make a screenshot and show us here: https://www.spigotmc.org/threads/clockdisplay.134600/.