VenturaCalendar | Your own custom calendar [1.13 - 1.21.4]

VenturaCalendar | Your own custom calendar [1.13 - 1.21.4] -----

A highly customizable calendar plugin for all kinds of servers.

From version 1.6.0+
you need to have Java 17 installed.

Minecraft Calendar continuation of the old TheTime plugin.

The plugin is now paid for the people who want to support me and get something in return as well.

The original plugin will stay free but will not be updated.

If you wish to try out the plugin before buying, you can find the resource here:
VenturaCalendar | Your own custom calendar [1.13 - 1.18]

Fully customizable events that take place on specified days, months;
Time synchronization (noon real-time - noon in-game);
Highly customizable, simple & easy to use;
Time manipulation via commands;
New day messages, titles, subtitles;
Simple configuration;
Custom placeholders;
PlaceholderAPI support;
Daily rewards;
Configurable reward months and days;
Console and player sending commands for rewards;
Various actions additionally to command sending;
Automatic command execution on events or new days;
Option to use real world time and have real-time calendar;
HEX color support;

Base command & reload:
/venturacalendar reload

Time manipulation:
/venturacalendar <add/subtract><sec/min/h/d/weeks> <amount>

Set starting year without editing config:
/venturacalendar set startyear <year>

Set the starting date in the config. (resets the world time)
/venturacalendar set date <YYYY/MM/DD>

Calendar GUI command:
/calendar

Real-time calendar:
/calendar realtime

Permission to the base command:
venturacalendar.command.venturacalendar

Permission to the reload the config:
venturacalendar.command.reload:

Permission to open the calendar:
venturacalendar.command.calendar

Permission to manipulate time using add/subtract/set:
venturacalendar.command.changetime

Permission to open real-time calendar:
venturacalendar.calendar.realtime

You can find more information in the wiki:
Usage · M0diis/VenturaCalendar Wiki (github.com)

There are multiple configuration files, most of the configuration is self explanatory and does not require a lot of understandment.

To setup the a Time System you should first understand what it does.
The Time System will be used to calculate the date, it provides information about the length of the different time units like seconds, minutes, hours, etc.

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.

For more information on configuration, go to VenturaCalendar Github wiki page:
Configuration · M0diis/VenturaCalendar Wiki (github.com)

PlaceholderAPI | Optional

You can use the following placeholders with PlaceholderAPI:

%venturacalendar_month_<month-name>_season%
%venturacalendar_month_<month-name>_days%
%venturacalendar_event_<event-config-name>_start%
%venturacalendar_event_<event-config-name>_end%
%venturacalendar_event_<event-config-name>_description%
%venturacalendar_newday_message%
%venturacalendar_actionbar_message%
%venturacalendar_date_event_name%
%venturacalendar_date_event_description%
%venturacalendar_date_tick%
%venturacalendar_date_second%
%venturacalendar_date_minute%
%venturacalendar_date_hour%
%venturacalendar_date_day%
%venturacalendar_date_day_name%
%venturacalendar_date_dayofweek%
%venturacalendar_date_week%
%venturacalendar_date_month%
%venturacalendar_date_month_name%
%venturacalendar_date_season_name%
%venturacalendar_date_year%
%venturacalendar_date_era%
%venturacalendar_date_era_name%

The plugin currently has several events that are dispatched.
You can find some examples below. The rest is on github wiki.
API · M0diis/VenturaCalendar Wiki (github.com)

MonthEventDayEvent
Event is called when the new day (at 00:00) has some event scheduled on it.

Code (Java):

@EventHandler
public void onEventDay (MonthEventDayEvent event )
{
MonthEvent event = event. getMonthEvent ( ) ;
}

NewDayEvent
Event is called on every new day. (at 00:00)

Code (Java):

@EventHandler
public void onNewDay (NewDayEvent event )
{
TimeSystem timeSystem = event. getTimeSystem ( ) ;
}

CalendarClickEvent
Event is called when player clicks on an item in the GUI.

Code (Java):

@EventHandler
public void onCalendarClick (CalendarClickEvent event )
{
Player player = event. getPlayer ( ) ;
ItemStack item = event. getItem ( ) ;
Calendar calendar = event. getCalendar ( ) ; // The GUI itself
}