Clockdisplay 1.0

Generates analog clocks with particles - highly customizable

  1. Michel_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:
    • 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:
    Clock1.png
    Clock2.png
    Clocks3.png
    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/.
    Roy7885, NinjaStix and RobiRami like this.

Recent Reviews

  1. patricianko
    patricianko
    5/5,
    Version: 1.0
    Excellent developer.
    Please add REDSTONE particles, black or others, not bugs..
    And add ticks sound, and add dots 360, blue like the photo in my thread on forum.. GREAT
    1. Michel_0
      Author's Response
      Thanks for your reply.
      I alredy thought of adding tick sounds and clock marks. Might be released within v1.1.
      I'm also planning to make COLOURED_DUST custom definable and redesign the configuration structure. Sounds like a nice v1.2 feature.

      However REDSTONE particles are not part of the Spigot 1.8.X API. Maybe i'll Switch over to NMS Particle names to offer more possibilities. Not sure about that yet.
  2. NinjaStix
    NinjaStix
    5/5,
    Version: 1.0
    Very cool plugin to add class to your server :P
    pros: Fully customizable
    cons: Configuration options might confuse some users
    suggestions: Some sort of clock placement tool.
    1. Michel_0
      Author's Response
      Thanks for your reply.
      I'm planning a ingame userinterface by commands to place, setup and modify clocks without writing the configuration file.
      But this probably won't be released before v1.3.