HomeJavaModsTheTime | The custom calendar!
TheTime | The custom calendar!
TheTime
The custom calendar!

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

Spoiler: How it look's like
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.
Spoiler
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!

GitHub-Mark.png
Project repository!


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

~Joshua


Icons made by many authors from www.flaticon.com

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

TheTime | The custom calendar! is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 10,357 times (via Spigot). Download it and open it directly in the game.

Explore more