![Advent Calendar](https://file.garden/Xz8b1JHWmTiKn1uW/Advent%20Calendar/advent_banner.png) --- 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](https://file.garden/Xz8b1JHWmTiKn1uW/Advent%20Calendar/advent_img.png) 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! [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/P5P516LAKY) ![Features](https://file.garden/Xz8b1JHWmTiKn1uW/Advent%20Calendar/advent_features.png) --- - 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! ![Commands](https://file.garden/Xz8b1JHWmTiKn1uW/Advent%20Calendar/advent_commands.png) --- **/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 ![Permissions](https://file.garden/Xz8b1JHWmTiKn1uW/Advent%20Calendar/advent_permissions.png) --- **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 ![Support](https://file.garden/Xz8b1JHWmTiKn1uW/Advent%20Calendar/advent_sup.png) --- If you encounter any issues instead of leaving a negative review, please join my development discord: [https://discord.gg/GMkjWd2Kun](https://discord.gg/GMkjWd2Kun) I also welcome any suggestions for improving the advent calendar! ![Config](https://file.garden/Xz8b1JHWmTiKn1uW/Advent%20Calendar/advent_configuration.png) ---

config.yml

```yaml #################################################################################################### # +----------------------------------------------------------------------------------------------+ # # | __ ___ ___ | # # | /\ | \ \ / |__ |\ | | | # # | /~~\ |__/ \/ |___ | \| | | # # | __ ___ __ __ | # # | / ` /\ | |__ |\ | | \ /\ |__) | # # | \__, /~~\ |___ |___ | \| |__/ /~~\ | \ | # # | | # # | | # # | 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% ' # 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

CaelenO42