Quick rating

Advent Calendar

No reviews yet

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

Mod Loaders

Paper

Spigot

Minecraft

Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

Community voices

Reviews

Rating

Any

Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0

Min

Max

Play Status

Reviews

Time Played

hrs+

Verified developers only

Has developer response

List view

Grid view

Compact view

Sort by

Sort ascending

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Modrinth

Compatibility

Supported Environments

Dev Environment

Client Unsupported

Server Required

About

Project Details

Type

Mod

License

Latest Version

1.5.5

Authors

CaelenO42

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

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

The calendar in action

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!

Full customization for what commands run when a player claims a gift
Customizable aliases for the base command
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
SQLite data storage
Commands now have support for PlaceholderAPI placeholders!

/ac - Opens the advent calendar
/adventcalendar, /advent - Aliases for /ac
/ac force - 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 admin viewclaims - Shows in chat which days of the calendar the specified player has claimed
/ac admin removeclaim - Removes the claim for the specified player on the specified day
/ac admin removeallclaims - Removes all claims for the specified player
/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
adventcalendar.admin.viewclaims - Lets you view the claims from the specified player
adventcalendar.admin.removeclaim - Lets you remove a claim from the specified player
adventcalendar.admin.removeclaimall - Lets you remove all claims from a specified player

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!

config.yml

####################################################################################################
# +----------------------------------------------------------------------------------------------+ #
# |                                      __        ___      ___                                  | #
# |                                 /\  |  \ \  / |__  |\ |  |                                   | #
# |                                /~~\ |__/  \/  |___ | \|  |                                   | #
# |                             __             ___       __        __                            | #
# |                           /  `  /\  |    |__  |\ | |  \  /\  |__)                            | #
# |                           \__, /~~\ |___ |___ | \| |__/ /~~\ |  \                            | #
# |                                                                                              | #
# |                                                                                              | #
# |                  https://www.spigotmc.org/resources/advent-calendar.105930/                  | #
# |                          https://modrinth.com/plugin/adventcalendar                          | #
# |                                                                                              | #
# |           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.4.0'

# +----------------------------------------------------------------------------------------------+ #
# |                                                                                              | #
# |                                    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'

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

# How many claims the calendar should allow from each unique IP address to prevent alt boosting.
# Set to -1 to disable the limit.
max-claims-per-ip: 3

# 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'

strings.yml

####################################################################################################
# +----------------------------------------------------------------------------------------------+ #
# |                                      __        ___      ___                                  | #
# |                                 /\  |  \ \  / |__  |\ |  |                                   | #
# |                                /~~\ |__/  \/  |___ | \|  |                                   | #
# |                             __             ___       __        __                            | #
# |                           /  `  /\  |    |__  |\ | |  \  /\  |__)                            | #
# |                           \__, /~~\ |___ |___ | \| |__/ /~~\ |  \                            | #
# |                                                                                              | #
# |                                                                                              | #
# |                  https://www.spigotmc.org/resources/advent-calendar.105930/                  | #
# |                          https://modrinth.com/plugin/adventcalendar                          | #
# |                                                                                              | #
# |           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 the IP limit is reached
error-ip-message: "&cThe maximum number of gifts have been claimed from this IP."

# 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!"

# Message that displays when the %adventcalendar_claimed_today% placeholder is true
claimed-today-true: "&aAdvent Calendar not claimed today!"

# Message that displays when the %adventcalendar_claimed_today% placeholder is false
claimed-today-false: "&cAdvent Calendar already claimed today!"

Screenshots

Gallery

Advent Calendar An image of what the calendar looks like

Versions

Files

Relations

Project Relations

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

Ratings

Followers

In stacks

By the numbers

Statistics

Modpacks using this mod

~2,000

Downloads

Feb 1, 2026

Last Updated

CurseForge

Feb 1, 2026

Modrinth

Feb 1, 2026

Nov 16, 2023

Created

3 months ago

Last synced

When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.

New file updates sync automatically

How syncing works

Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

Get it on

Available Platforms

Modrinth

On ModDex

Community snapshot

Ratings

Followers

In stacks

By the numbers

Statistics

Modpacks using this mod

~2,000

Downloads

Feb 1, 2026

Last Updated

CurseForge

Feb 1, 2026

Modrinth

Feb 1, 2026

Nov 16, 2023

Created

3 months ago

Last synced

New file updates sync automatically

How syncing works

Resources

External Links

Source Issues Wiki Discord