Advent Calendar icon

Advent Calendar -----

Adds a customizable advent calendar so players can receive gifts every day for the holiday season!




[​IMG]
Add holiday spirit to your Minecraft server with this customizable advent calendar! Reward your players with fun gifts and a unique holiday experience!

[​IMG]
If you like this plugin, please consider supporting me! I code plugins and mods in my free time, and it would really help me out!

[​IMG]
  • Full customizability for what commands run when a player claims a gift
  • Run as many commands as you want for each day
  • Customizable time zone, gift claim message, expired claim material, GUI name, filler item, and more
  • Local user data storage so you can see what gifts players have claimed
  • Commands now have support for PlaceholderAPI placeholders!
[​IMG]
/ac- Opens the advent calendar
/adventcalendar, /advent - Aliases for /ac
/ac force <player> - Allows an admin to open the calendar for a specific player
/ac admin preview - Opens a preview of the advent calendar GUI so that admins can test commands and GUI customization without affecting the regular calendar

/ac admin reload - Allows admins to reload the config without having to restart the server
/ac help - Displays a help window with descriptions of each command

[​IMG]
adventcalendar.open - Gives player permission to open the advent calendar for themselves, the calendar will still have a countdown timer until December begins.
adventcalendar.admin - Catch all for admin perms
adventcalendar.admin.reload - Lets you reload the config files
adventcalendar.admin.preview - Lets you open the preview calendar for testing

[​IMG]
Code (YAML):

####################################################################################################
# +----------------------------------------------------------------------------------------------+ #
# |                                      __        ___      ___                                  | #
# |                                 /\  |  \ \  / |__  |\ |  |                                   | #
# |                                /~~\ |__/  \/  |___ | \|  |                                   | #
# |                             __             ___       __        __                            | #
# |                           /  `  /\  |    |__  |\ | |  \  /\  |__)                            | #
# |                           \__, /~~\ |___ |___ | \| |__/ /~~\ |  \                            | #
# |                                                                                              | #
# |                                                                                              | #
# |                  https://www.spigotmc.org/resources/advent-calendar.105930/                  | #
# |                                                                                              | #
# |           If you have any issues or suggestions please join my development discord!          | #
# |                                  https://discord.gg/GMkjWd2Kun                               | #
# |                                                                                              | #
# |  New options are not added to this file automatically. The plugin may break if a config      | #
# |  option cannot be found. The latest config version can be obtained at the link above.        | #
# +----------------------------------------------------------------------------------------------+ #
####################################################################################################

# Used to let the plugin determine if your config is up-to-date, so a
# warning can be printed in the server console. Only edit this if you
# know what you are doing, or have just updated your config to the
# newest version.
config-version
: '1.3.2'

# +----------------------------------------------------------------------------------------------+ #
# |                                                                                              | #
# |                                    LOCALIZATION SETTINGS                                     | #
# |                                                                                              | #
# +----------------------------------------------------------------------------------------------+ #

# The timezone that the advent calendar uses to determine what day it is
# You can find a list of timezones here: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
time-zone
: 'America/Los_Angeles'

# +----------------------------------------------------------------------------------------------+ #
# |                                                                                              | #
# |                                    CUSTOMIZATION SETTINGS                                    | #
# |                                                                                              | #
# +----------------------------------------------------------------------------------------------+ #

# What month the calendar uses as the claim month (the calendar is only able to be opened during this month)
calendar-month
: '12'

# What day the calendar uses as the start date (keep in mind that the calendar only works for one month)
calendar-day
: '01'

# Whether to allow players to claim gifts for previous days
allow-expired-claims
: false

# Whether to have the quantity of items match the day number or just have 1 item per day
display-numbers-on-gifts
: true

# Whether the calendar will display in 24 or 25 day mode
25-day
: false

# +----------------------------------------------------------------------------------------------+ #
# |                                                                                              | #
# |                                         TEXT SETTINGS                                        | #
# |                                                                                              | #
# +----------------------------------------------------------------------------------------------+ #

# Any minecraft color codes are supported, just use the & symbol
# You can also use %player% for the players username and %day% for the claimed day

# The title of the Advent Calendar GUI
title
: '&cAdvent &2Calendar'

# The name that displays on each gift. You can specify a color code here or per item down in days-material
gift-name
: 'Day %day%'

# The name that displays on each gift that has already been claimed, you can specify a color code here,
# or per item down in days-material
claimed-name
: 'Day %day%'

# The name that displays on the close button.
close-name
: '&cClose'

# +----------------------------------------------------------------------------------------------+ #
# |                                                                                              | #
# |                                    GUI MATERIAL SETTINGS                                     | #
# |                                                                                              | #
# +----------------------------------------------------------------------------------------------+ #

# The material for the filler item that goes around the outside of the GUI
filler-material
: 'LIGHT_BLUE_STAINED_GLASS_PANE'

# The material used for the close button
close-material
: 'BARRIER'

# The material used for each day in the advent calendar.
# If the material is PLAYER_HEAD, the head will be whatever is specified in texture
# day-color is the color that the gift-name text will appear in, if you want a different color
# for different days
# custom-model-data is used for applying custom models to items with texture packs, if set to 0
# it will be ignored.
# claimed-* is the same as above, but for the claimed / expired version of the item
# NOTE: for the texture field they MUST be textures.minecraft.net links, or the calendar will error out.
days-material
:
  "1"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "2"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "3"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "4"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "5"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "6"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "7"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "8"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "9"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "10"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "11"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "12"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "13"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "14"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "15"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "16"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "17"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "18"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "19"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "20"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "21"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "22"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "23"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "24"
:
    color
: '&a'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/81e42e3725c2b4ae6900580c4e2a6b830f6eca0211f7a3641433fc67fbc43d3f'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0
  "25"
:
    color
: '&c'
    material
: 'PLAYER_HEAD'
    texture
: 'http://textures.minecraft.net/texture/5726d9d0632e40bda5bcf65839ba2cc98a87bd619c53adf00310d6fc71f042b5'
    custom-model-data
: 0
    claimed-color
: '&c'
    claimed-material
: 'COAL_BLOCK'
    claimed-texture
: ''
    claimed-custom-model-data
: 0


# +----------------------------------------------------------------------------------------------+ #
# |                                                                                              | #
# |                                   ADVENT CALENDAR COMMANDS                                   | #
# |                                                                                              | #
# +----------------------------------------------------------------------------------------------+ #

# When typing commands, do not include the '/' before the command.
# To use the player as a placeholder use %player%
# An example command would be 'give %player% minecraft:diamond 10'
# If you want to give a player in game currency, and you have Essentials, you can do 'eco give %player% <amount>'

# slots-required is used for give commands to make sure the player has enough inventory space before claiming an item
# if you are not giving the player an item, set this to 0, if you are giving the player 3 stacks of items, set this to 3
rewards
:
  "1"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "2"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "3"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "4"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "5"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "6"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "7"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "8"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "9"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "10"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "11"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "12"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "13"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "14"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "15"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "16"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "17"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "18"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "19"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "20"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "21"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "22"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "23"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "24"
:
    slots-required
: 1
    commands
:
     - 'say test'
  "25"
:
    slots-required
: 1
    commands
:
     - 'say test'
 

Code (YAML):

####################################################################################################
# +----------------------------------------------------------------------------------------------+ #
# |                                      __        ___      ___                                  | #
# |                                 /\  |  \ \  / |__  |\ |  |                                   | #
# |                                /~~\ |__/  \/  |___ | \|  |                                   | #
# |                             __             ___       __        __                            | #
# |                           /  `  /\  |    |__  |\ | |  \  /\  |__)                            | #
# |                           \__, /~~\ |___ |___ | \| |__/ /~~\ |  \                            | #
# |                                                                                              | #
# |                                                                                              | #
# |                  https://www.spigotmc.org/resources/advent-calendar.105930/                  | #
# |                                                                                              | #
# |           If you have any issues or suggestions please join my development discord!          | #
# |                                  https://discord.gg/GMkjWd2Kun                               | #
# |                                                                                              | #
# |  New options are not added to this file automatically. The plugin may break if a config      | #
# |  option cannot be found. The latest config version can be obtained at the link above.        | #
# +----------------------------------------------------------------------------------------------+ #
####################################################################################################

# +----------------------------------------------------------------------------------------------+ #
# |                                                                                              | #
# |                                           STRINGS                                            | #
# |                                                                                              | #
# +----------------------------------------------------------------------------------------------+ #

# Any minecraft color codes are supported, just use the & symbol
# Gradients are also supported in this version, see the syntax here:
# https://github.com/Iridium-Development/IridiumColorAPI/blob/master/README.md
# You can also use %player% for the players username and %day% for the claimed day

# This value will be inserted wherever you use %prefix%
prefix
: "&aAdvent Calendar >>"

# Message that sends to the player after they claim the gift
claim-message
: "&aGift Successfully Claimed! Happy Holidays, %player%!"

# Message that displays when a gift is expired
error-expired-message
: "&cThis gift can no longer be claimed."

# Message that displays when a gift is already claimed
error-claimed-message
: "&cThis gift has already been claimed."

# Message that displays when a user's inventory is full when attempting to claim
error-inventory-message
: "&cYou don't have enough space in your inventory to receive this gift!"

# Message that displays when the calendar is not unlocked yet
# Note: The %s get autofilled with the time, so don't touch them unless you know what you are doing.
error-calendar-message
: "&cThe Advent Calendar doesnt open for %s days %s hours %s minutes %s seconds."

# Message that displays when a gift has not unlocked yet
# Note: The %s get autofilled with the time, so don't touch them unless you know what you are doing.
error-gift-message
: "&cYou can claim this item in %s days %s hours %s minutes %s seconds."

# Message that displays when a user runs /reload
reload-message
: "&aThe config has been successfully reloaded!"
 
[​IMG]
If you encounter any issues instead of leaving a negative review, please join my development discord:
https://discord.gg/GMkjWd2Kun
I also welcome any suggestions for improving the advent calendar!
Resource Information
Author:
----------
Total Downloads: 2,704
First Release: Oct 26, 2022
Last Update: Dec 6, 2024
Category: ---------------
All-Time Rating:
16 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings