TheTime | The custom calendar! 5.8.1

RPG Calendar for your server! With custom date and time system.

  1. Tonda_
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    TheTime
    The custom calendar!

    Create your calendar today!
    Make your story epic, with a time reference.

    calendar.PNG

    Features
    - Set your own Time-System! Want a year with 30 Months? No Problem
    - Era support! Make great Story with custom eras!

    - Complete GUI skin change! Want to bring medieval felling in your calendar? Just setup the items in the config.
    - Easy configuration!
    - Passive time calculation! TheTime will not touch the Minecraft Time-System and only calculates the date when the command is executed! To keep the resource usage at the lowest level.
    - Use more than one Time-System the time! Make different
    time zones and more!


    Usage

    /calendar
    Desc.: Will open the calendar with the default TimeSystem.
    Permissions: TheTime.calendar.default

    /calendar [TimeSystem]
    Desc.: Will open the calendar of the given TimeSystem.
    Permissions: TheTime.calendar.TimeSystem

    /TheTime reload

    Desc.: Reloads the configuration files.
    Permissions: TheTime.reload

    /TheTime
    Desc.: Shows information about TheTime.
    Permissions: none

    Setup [TimeSystem]

    To setup the TimeSystem you should properly first getting to know what the TimeSystem does. The TimeSystem will be used to calculate the date, it provides information about the length of the different time units like seconds, minutes, hour and so on... It also provides information about your eras and about the different names of the days and months. So it's the most important part of the configuration.

    Now let us start!
    To do so open the TimeConfig.yml file in the folder of the plugin, if there is no such folder try to restart your server.

    You now can see the config. At the top of it there is a section named Time-Systems:
    Code (Text):

    Time-Systems:
      default:
        second:
           ...
     
    Under it you can find the different TimeSystems like default or rome, which are the two pre-configurated ones.
    Code (Text):

    Time-Systems:
      default:
        second:
          ticksPerSecond: 20
        ...
      rome:
        second:
          ticksPerSecond: 20
        ...
     
    For now we will only change the default one, later on you will also be able to create your own TimeSystems.

    Under the default TimeSystem you see different section of time units. Under each section of a time unit you can see a value, this value is used to define the length of the unit. So the value of ticksPerSecond defines how many ticks will tick for one second (In default minecraft there will be 20ticks/second).
    Code (Text):

    Time-Systems:
      default:
        second:
          ticksPerSecond: 20
        ...
     
    There are some time unit which have a extra value to define. One of the is the day unit section, there you have to define, und dayNames, how the days will be named, be careful when setting up the daysPerWeek because you need as many day names defined as you set the value of it. Also notice that the maximum value of daysPerWeek is 8 because of the size of the GUI can only be 9 slots long.
    Code (Text):

    ...
    day:
          hoursPerDay: 24
          dayNames:
            '1':
              name: Monday
            '2':
              name: Tuesday
            '3':
              name: Wednesday
            '4':
              name: Thursday
            '5':
              name: Friday
            '6':
              name: Saturday
            '7':
              name: Sunday
        week:
          daysPerWeek: 7
    ...
     
    At the month section you not only have to define the name of the month, it also depends on the monthPerYear value, you also have to define how many days each months will have. You do this under daysPerMonth.
    Code (Text):

    ...
        month:
          daysPerMonth:
            '1':
              name: January
              days: 31
            '2':
              name: February
              days: 28
            '3':
              name: March
              days: 31
            '4':
              name: April
              days: 30
            '5':
              name: May
              days: 31
            '6':
              name: June
              days: 30
            '7':
              name: July
              days: 31
            '8':
              name: August
              days: 31
            '9':
              name: September
              days: 30
            '10':
              name: October
              days: 31
            '11':
              name: November
              days: 30
            '12':
              name: December
              days: 31
        year:
          zero: 0
          monthsPerYear: 12
    ...
     
    In the section of the year you will find a value named zero, there you can define on which year your time should start. Every value is permitted.
    Code (Text):

    ...
        year:
          zero: 0
          monthsPerYear: 12
    ...
     
    To define a era just copy the era '1' and change the value to '2', or just edit the first pre-configured era. Then you can define you startYear, endYear and of course the name of the era.
    Code (Text):

        era:
          eras:
            '1':
              name: default
              startYear: 0
              endYear: 1
            '2':
              name: 'your era'
              startYear: 10
              endYear: 40
     
    The other setups are mostly self explaining, just read the headers of the CommandConfig.yml and CalendarConfig.yml to find some extra infos.

    Placeholders:
    You can use the following placeholder with PlaceholderAPI:
    %TheTime_date_tick%
    %TheTime_date_second%
    %TheTime_date_minute%
    %TheTime_date_hour%
    %TheTime_date_day%
    %TheTime_date_day_name%
    %TheTime_date_dayOfWeek%
    %TheTime_date_week%
    %TheTime_date_month%
    %TheTime_date_month_name%
    %TheTime_date_year%
    %TheTime_date_era%
    %TheTime_date_era_name%

    Setup successful!

    bug-report.png
    Report bugs in the discussion!



    icon.png
    Thank's for reading!
    Don't forget to rate :)

    ~Joshua


    Icons made by many authors from www.flaticon.com
    Polymetric, Fargus, derkleine and 4 others like this.

Recent Updates

  1. 1.11.2 support!
  2. 1.11 Support
  3. Added PlaceholderAPI support!

Recent Reviews

  1. Ritchy
    Ritchy
    4/5,
    Version: 5.8.1
    Good, but some add some features. Thanks you! :)**********************************************************
  2. SamB440
    SamB440
    5/5,
    Version: 5.8.1
    This plugin looks good - and seems to be the only one around. But I would like the time announced in a title when the player joins, and when a new day or month or era arrives.
    1. Tonda_
      Author's Response
      Thakn's for your review!
      This is sadly not possible, because of how the core of TheTime is working. TheTime only calculates the current time when the command is run.
  3. Vreya
    Vreya
    5/5,
    Version: 5.8.1
    This is a very amazing plugin. I'm surprised the isn't more time managing plugins like this. Yours is unique. Please keep updating it, I have a lot of suggestions. I would even buy it if you set it to premium, or if you created a premium version. I seriously love it.

    I don't know why I can't get it to start on day 1. I've manage to set the year to 0, the month to the first month, but the day always starts on three. I've tried setting /time set 0. I've tried everythin.
    1. Tonda_
      Author's Response
      Thanks for your review!
      I'm very sorry, but at the moment I'm not able to add any suggestions, because I'm very bussy. But the hole project is open-source, so if you have any dev in your team he could use it as a base.

      When your world isn't new, the day will not start at 0, because TheTime takes the ticks since the world was created an calculates the date out of it. When you want to start at 0 you could probably set the day zero to -3.
  4. MiguelTeirlinck
    MiguelTeirlinck
    4/5,
    Version: 5.7
    [?] How do you make it so the reallife date is the same as the serverdate?
    [Review] It's a great plugin! It's a nice plugin for a roleplayserver where eras are important!
    1. Tonda_
      Author's Response
      You can setup the config so that a day is 24 hours long means 1.728M ticks. After that just add so many ticks to your world time that the current date appears. This could be quit complicated to make for you through. I can help you if you like to, just PM me.
      Because you gave 4/5 stars: Is there anything you would like to see?

      ~Joshua
  5. Ayxa
    Ayxa
    5/5,
    Version: 5.6.3
    Good plugin, could you add PlaceholderAPI support? please, I need put the time and the day in featherboard, menus and more.. Thank you.
    1. Tonda_
      Author's Response
      Thank you so much for this review! :)
      That's an great idea. I actually never worked with PlaceholderAPI before, but i will look into it and try to bring it with the next update!

      Best regards
      ~Joshua
  6. MoreApplesForUs
    MoreApplesForUs
    5/5,
    Version: 5.6.2
    Very awesome and unique server! I've been hearing from some of my friends that recommended this plugin to me, that the author/developer of this plugin is fairly nice.

    Although I said those things, I have to say some things on my mind that would be great for you to add.

    Would you be able to add a feature that you are able to add an event to the calendar as a reminder to other players who look at it, that would be awesome.

    Thank you so much for spending your time creating this plugin.
    1. Tonda_
      Author's Response
      Thanks for this awesome review!
      I'am very happy that you like the plugin that much.
      So you mean an event where the calendar get's opened, like the calendar get's opened on join as an example?
      Would love to help you with this, maybe you could explain it in the discussion?

      Thank's!
      ~Joshua
  7. Sviatoslav
    Sviatoslav
    4/5,
    Version: 5.4
    Add something like rewards for playing: Every sunday player can click on [this Sunday] ( if it is sunday ) and gat his free item ( with cmd and something like %player% support ). Or on any ( configarable ) day player can gat special item. Also this feature should be configurable. So it would be like advent calendar.
    Is plugin usigh minecraft time system? or real time? I really want real-time support with autosave every minute ( configurable ) to create real time holidays on the server.
    Sorry for my poor english :(
    1. Tonda_
      Author's Response
      Hey!
      Thanks for the review! Please keep in mind that the review is not for future requesting.
      It's not motivating to review with 4 Stars just because you want a future. If you want to add a future you could either ask in the disscusion or hire a Dev who can ise the open-source code of the plugin to add the Features you want. Just so you get the point this resource is not only for you it's for everybody so of you want a new future you may post it in the disscussion and also other people can say there oppinion about it. I would love to hear you ideas, but could explain a bit more what do you mean with save every minute?

      ~Joshua
  8. Dolostar
    Dolostar
    5/5,
    Version: 5.0
    Nice! .
    1. Tonda_
      Author's Response
      Thanks! ;)
  9. GreeKHacK
    GreeKHacK
    4/5,
    Version: 2.4
    Very nice plugin but some something like what server add when you click at the glass.For example Day 4 adding /potions
    1. Tonda_
      Author's Response
      Thanks!
      Good idea, but keep in mind next time you should do Feature request in the disscusion.
      ~Joshua
  10. Hmmcrunchy
    Hmmcrunchy
    5/5,
    Version: 2.4
    Excellent plugin looking forward to time keeping in the plugin instead of trying to track all our dates and lore times
    1. Tonda_
      Author's Response
      Thank you very much!
      Foe this useful ThwTime should be exelent! If you need any features don't be shy to ask ;)