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

Recent Updates

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

Recent Reviews

  1. _readdress
    _readdress
    2/5,
    Version: 5.8.1
    when i do /calendar it just says to do /calendar
    .
    .
    .
    .
    .
    .
    .
    .
    .
    .
    .
    .
    .
    .
    .
    .
    .
    .
  2. PigBox1
    PigBox1
    5/5,
    Version: 5.8.1
    Hi. I really like your plugin but i tried to install it in my 1.16.4 SMp and it didn't work :C. Is there any chance you can update it to 1.16x?

    But overall i really like the idea, and the placeholed API support is just great. Keep on going with the good work :D
  3. Atog_
    Atog_
    5/5,
    Version: 5.8.1
    Very good plugin, i using this on my server :)
    ------------------------------------------
  4. HippieSavage
    HippieSavage
    3/5,
    Version: 5.8.1
    This is bugless and amazing for the ones, that want that kind of plugin

    But I'm not that type of person. I miss some features.
    This plugin is a perfect solution for showing players date of server events. I'm shocked It's not included in the plugin.
    Players instead of asking administrators about upcoming events could just open calendar and see the schedule for this month. There could be also visible some seasons, like halloween event that lasts 5 days, or something simillar.
    If you could add this I would be in love. Please.
  5. AydenRocks56
    AydenRocks56
    5/5,
    Version: 5.8.1
    Great plugin! I use this for my server and it works flawlessly! I have never experienced a bug with it!
  6. AlvoriGaming
    AlvoriGaming
    5/5,
    Version: 5.8.1
    It's a great plugin but how to I make to set the Date becuz it's wrong, and how to make it with PlacerHolderApi
  7. Satosis
    Satosis
    4/5,
    Version: 5.8.1
    I like how everything is pretty configurable, and I've made it so that the days change based on minecraft days and its really cool for RP. HOWEVER, I cant for the life of me make it so non OPs can run the /calendar command to see the date. Very frustrating.
  8. Lolok
    Lolok
    3/5,
    Version: 5.8.1
    Good plugin but fix placeholders, they doesn't work
    ------------------------
  9. FishRekt
    FishRekt
    5/5,
    Version: 5.8.1
    I need some help with configuring this plugin, please help me ;_;
    .
    .
    .
    .
    .
    .
    .
    .
  10. Ritchy
    Ritchy
    4/5,
    Version: 5.8.1
    Good, but some add some features. Thanks you! :)**********************************************************