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

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

A highly customizable calendar plugin for all kinds of servers.

Download Now
185.4 KB .jar



Update to 1.21.4
Updated to 1.21.4
----------, Mar 4, 2025

Placeholder fix
Fixed an issue where simple date format is not parsed correctly for %venturacalendar_date_formatted_<SDF>%
----------, Sep 7, 2023

Placeholders
Added tab-complete for /papi parse.

Added new placeholder that supports SimpleDateFormat (Java Platform SE 8 ) (oracle.com) - %venturacalendar_date_formatted_<simple-date-format>%
----------, Sep 7, 2023

Version update
Bump build version to 1.20.1.
----------, Aug 4, 2023

HEX
Changes:
  • Added support for HEX color codes in the '&#123456' format. (ex. '&#ffffff')
----------, Jan 21, 2023

Bug-Fix
Changes:
  • Fixed real-time calendar not opening correctly and throwing errors;
  • Fixed an issue where current day for real-time calendar wouldn't show up if going to next month and going back to current month.
----------, Dec 28, 2022

Era Fix
Changes:
  • Fixed an issue where eras are not calculated for real-time.
----------, Dec 26, 2022

Real-Time calendar command
Changes:
  • Added /calendar realtime (venturacalendar.calendar.realtime) command, so you can open real-time calendar without needing to change the time-system to real-time.
Default /calendar command will still work as usual. If timesystem is defined as real-time, it will open real-time calendar and vice-versa.
----------, Dec 8, 2022

Real-time buttons
Changes:
  • Added an option to change real-time buttons to go through months in CalendarConfig.yml
----------, Nov 18, 2022

Bug-Fix
Changes:
  • Fixed an issue of time-sync being applied without regarding the config option.
----------, Nov 17, 2022

Bug-Fix, event priorities, year specifications, real-time calendar pages.
Changes:
  • Added an option to add a 'year' to an event. This means the event will only happen on the specified year.
  • Added event priorities. If two events are on the same day, the one with the highest priority will be displayed. (material and name, but lores still apply from both).
  • Fixed an issue where you get locked out from accessing inventories.
  • Added ability to go the next or previous month via buttons in real-time calendar.
----------, Nov 14, 2022

Real-time offsets in-game & help command
Changes:
  • Added /vc help command'
  • Added /vc set offset <type> <value> for real-time time offsets.
  • Fixed an issue for time-sync when real-time is not enabled.
  • Real-time configuration has been slightly adjusted. (More info below)
Code (Text):
  real-time:
    enabled: false
    offsets:
      second: 0
      minute: 0
      hour: 0
      day: 0
      week: 0
      month: 0
      year: 0
    # If set to true, first day in calendar will show up as "Sunday".
    first-day-sunday: false
    # If sync is enabled, in-game time will be synced with real-time.
    # This means if it's noon, it will be noon in-game.
    # This will also set DO_DAYLIGHT_CYCLE gamerule to false in all worlds.
    # It regulates the world time ticks (which you can find with '/time query daytime')
    # with equation 'ticks = (24000 - currentHour * 1000 + currentMinutes * 1000 / 60)'.
    sync: false

----------, Nov 12, 2022

World time sync with real-time, placeholders, translations.
Changes:
  • Added config option to enable time sync.
  • Added day, month and season translations for real-time.

If sync is enabled, in-game time will be synced with real-time.
This means if it's noon, it will be noon in-game.
This will also set DO_DAYLIGHT_CYCLE gamerule to false in all worlds.
It regulates the world time ticks (which you can find with '/time query daytime') with equation 'ticks = (24000 - currentHour * 1000 + currentMinutes * 1000 / 60)'.

Code (Text):
translations:
  # These are translations for the real-time calendar.
  real-time:
    # Day names must be exactly from Monday to Sunday and
    # in the same order. Same goes for month names.
    day-names:
    - Monday
    - Tuesday
    - Wednesday
    - Thursday
    - Friday
    - Saturday
    - Sunday
    month-names:
    - January
    - February
    - March
    - April
    - May
    - June
    - July
    - August
    - September
    - October
    - November
    - December
    # These are the names for seasons.
    # From January to March is Winter, from April to June is Spring,
    # from July to September is Summer and from October to December is Autumn.
    season-names:
    - Spring
    - Summer
    - Autumn
    - Winter
----------, Nov 11, 2022

Full real-time calendar implemenation
Changes:
  • Fully implemented highly-customizable real-time calendar.
  • Some features (placeholders) will not work on real-time calendar.

Code (Text):
  real-time:
    enabled: false
    # If set to false, real-time will use local machine time.
    second-offset: 0
    minute-offset: 0
    hour-offset: 0
    day-offset: 0
    week-offset: 0
    month-offset: 0
    year-offset: 0
    # If set to true, first day in calendar will show up as "Sunday".
    first-day-sunday: true

----------, Nov 11, 2022

Java 17 & 1.18+
Changes:
  • Added support for newer versions (1.19.2) and Java 17.
----------, Nov 4, 2022

Fixes
Changes:
  • Fixed some issues causing the plugin to not work properly.
----------, Aug 11, 2022

Remove Debug Message & Bug-FIx
Changes:
  • Fixed an issue with debug messages being sent even when debug is disabled;
  • Fixed a NPE with date while trying to send an actionbar message.
----------, Jun 21, 2022

Allow newer versions
Chages:
  • The plugin will now load correctly (and with a warning if version is unknown) with newer versions.
----------, Jun 19, 2022

Placeholder fix & Java 8
Changes:
  • Fixed an issue with a placeholder.
  • Added compatibility for java 8.
  • Material compatibility for earlier versions.
----------, Apr 27, 2022

API, Code changes & small fix
- Removed a leftover log message.
- Removed unnecessary code.
- Made a few events for the API.
- Fixed an issue where event file wouldn't reload properly.

All of the events can be found on the github wiki.
API · M0diis/VenturaCalendar Wiki (github.com)
----------, Jan 21, 2022

Event & Time-System Update
PLEASE BACKUP YOUR CONFIG
AND UPDATE TO THE NEW ONE.
READ THE UPDATE LOG​

Timesystems no more.

I've decided to remove the functionality of multiple timesystems, mainly because it's hard to implement placeholders and all the functions for multiple timesystems.
Now there will only be one: "main-time-system". (Do not remove or change it's name).

This update also fixes the
/vc set date YYYY/MM/DD
command.

You can find the updated TimeConfig.yml file here:
VenturaCalendar/TimeConfig.yml at main · M0diis/VenturaCalendar (github.com)

As for the events, here are the changes:
Code (YAML):

events:
  new-year:
    name : '&a| &2New Year''s day'
    month : 'January'
    # You can do "day: 1" if it happens on one (in this case first) day of the month.
    day : 1
    # <...> There rest of the config is the same <...>  

  my-event:
    name : '&a| &2Weekend'
    # You can use a month name, "all" or "any".
    # If it's a month name, then the event will only happen on that month.
    month : ' Any'
    # Event will be displayed on these specific days, on specified month
    day-names :
      - 'Friday'
      - 'Saturday'
      - 'Sunday'
    description :
      - "&6Weekend is here!"
    # If you opt out the "passed:", "current:" and "future:" sections, you can use one material for all the days, like defined below
    display-material : LIGHT_BLUE_STAINED_GLASS_PANE
 
----------, Jan 21, 2022

Hot-Fix & Additional placeholders
Fixed /vc set startyear command. It was using old configuration.

New PAPI placeholders:
- %venturacalendar_event_<event-config-name>_start%
- %venturacalendar_event_<event-config-name>_end%
- %venturacalendar_event_<event-config-name>_description%

Code changes can be found on github.
----------, Jan 15, 2022

Placeholders & Config Update
Additional placeholders
For PlaceholderAPI:
- %venturacalendar_month_<month-name>_season%: returns the season of the specified month.
- %venturacalendar_month_<month-name>_days%: returns the amount of days in the specified month.
- %venturacalendar_newday_message%: returns the new day message.
- %venturacalendar_actionbar_message%: returns the actionbar message.
- %venturacalendar_date_event_name%: returns the name of the current event.
- %venturacalendar_date_event_description%: returns the description of the current event.

Built-in:
- %eventName%
- %eventDescription%

Additional actions
This will play a sound to the player.
The first argument is the sound, the second is the volume and the third is the pitch.
You can find a list of sounds here: https://www.digminecraft.com/lists/sound_list_pc.php
- '[SOUND] ENTITY.PLAYER.LEVELUP, 1.0, 1.0'

This will show a title to the player.
The first argument is the title, the second is the subtitle.
The last three are: fade-in, stay and fade-out times.
- '[TITLE] This is a title, This is a subtitle, 20, 60, 20'
Alternatively you can use opt out the subtitle or the times, or just the subtitle.
- '[TITLE] This is a title'
- '[TITLE] This is a title, 20, 60, 20'

You can send raw messages to the player:
- '[MESSAGE] this will send a message to the player'
- '[TEXT] this will also send a message to the player'

Updated the events configuration
You can now define materials for the days on the event that have passed, for the current day and also the future days.

The config has it's own file now: Events.yml

Code (YAML):
events:
  new-year:
    name : '&a| &2New Year''s day'
    month : 'January'
    days:
      start : 1
      end : 1
    # This will appear in the lore of the event day.
    description :
      - "&6Happy new year!"
    # Will override current days display
    display-material :
       # Display for the current day if it's an event
      current : GREEN_STAINED_GLASS_PANE
      # Display for the passed days if it was on a event
      passed : RED_STAINED_GLASS_PANE
      # Display for the future days if they are on a event
      future : YELLOW_STAINED_GLASS_PANE
    # Leave empty if you don't want to execute any commands:
    # commands: []
    commands :
      - ' [PLAYER ] this will be executed by player'
      - ' [CONSOLE ] this will be executed by console'
Updated calendar configuration
You can now also define materials for the days that have passed, for the current day and future days.

Code (YAML):
items :
   # Item display for current day.
  today:
    toggle : true
    name : '&2 %day% %eventName%'
    material : LIME_STAINED_GLASS_PANE
    amount : ' %day%'
    # Example lore:
    # lore:
    #   - '&7Today is %dayName%.'
    #   - '&7It is the %week% week of the %monthName%.'
    lore :
      - '&r %dayName%'
  passed:
    toggle : true
    name : '&2 %day% %eventName%'
    material : WHITE_STAINED_GLASS_PANE
    amount : ' %day%'
    lore :
      - '&r %dayName%'
  future:
    toggle : true
    name : '&2 %day% %eventName%'
    material : WHITE_STAINED_GLASS_PANE
    amount : ' %day%'
    lore :
      - '&r %dayName%'
----------, Jan 14, 2022

View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 92
First Release: Jan 14, 2022
Last Update: Mar 4, 2025
Category: ---------------
All-Time Rating:
3 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings
Ask Questions / Get Support