90% of ad revenue goes to creators. Go ad-free while supporting creators with Modrinth Plus. Subscribe today!
Add holiday spirit to your Minecraft server with this customizable advent calendar! Reward your players with fun gifts and a unique holiday experience!
If you like this plugin, please consider Buying me a Coffee! I code plugins and mods in my free time, and it would really help me out!
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
/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 editor - Displays a link to the web editor (coming in 2.0.0!)
/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
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
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!
####################################################################################################
# +----------------------------------------------------------------------------------------------+ #
# | __ ___ ___ | #
# | /\ | \ \ / |__ |\ | | | #
# | /~~\ |__/ \/ |___ | \| | | #
# | __ ___ __ __ | #
# | / ` /\ | |__ |\ | | \ /\ |__) | #
# | \__, /~~\ |___ |___ | \| |__/ /~~\ | \ | #
# | | #
# | | #
# | 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.2.6'
# +----------------------------------------------------------------------------------------------+ #
# | | #
# | 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
# +----------------------------------------------------------------------------------------------+ #
# | | #
# | 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, but it is usually determined by
# the color of the present.
gift-name: 'Day %day%'
# The name that displays on the close button.
close-name: '&cClose'
# +----------------------------------------------------------------------------------------------+ #
# | | #
# | GUI MATERIAL SETTINGS | #
# | | #
# +----------------------------------------------------------------------------------------------+ #
# The material used to indicate missed or already claimed gifts
claimed-material: 'COAL_BLOCK'
# 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'
# +----------------------------------------------------------------------------------------------+ #
# | | #
# | 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>'
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'
####################################################################################################
# +----------------------------------------------------------------------------------------------+ #
# | __ ___ ___ | #
# | /\ | \ \ / |__ |\ | | | #
# | /~~\ |__/ \/ |___ | \| | | #
# | __ ___ __ __ | #
# | / ` /\ | |__ |\ | | \ /\ |__) | #
# | \__, /~~\ |___ |___ | \| |__/ /~~\ | \ | #
# | | #
# | | #
# | 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
# 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 an open slot 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!"
Details
Licensed ARR
Published 10 months ago
Updated 10 months ago