SN-Christmas | Advent Calendar, Custom Gifts, Lights & Admin GUI

ABOUT SN-CHRISTMAS
SN-Christmas provides everything required to run a festive Christmas event on your server.
Let players unlock daily Advent Calendar rewards, claim custom Christmas gifts and decorate your worlds with animated lights. Administrators can manage the event through commands and an in-game management GUI.
The plugin is highly configurable and does not require any additional plugins.
ADVENT CALENDAR
Create a daily reward calendar for the entire Christmas season.

• Fully configurable calendar year, month and timezone
• Create a different reward for every calendar day
• Run multiple commands when a reward is claimed
• Allow or prevent claiming previous days
• Optional early reward claiming
• Optional reward claiming after the event has ended
• Configurable permission requirement
• Randomized or manually configured GUI slots
• Separate items for available, claimed and locked days
• Reset one day or the complete calendar for individual players
• Reset calendar progress for every player

Players can open the calendar using:
CUSTOM CHRISTMAS GIFTS
Create reusable Christmas presents containing randomized rewards.

• Create gifts directly from the item held in your hand
• Configure an individual cooldown for every gift
• Add multiple weighted rewards
• Configure the maximum number of rewards per claim
• Use commands to provide money, items, permissions and other rewards
• Give gifts to individual players or the entire server
• Enable or disable the complete gift system
• Reset gift cooldowns for one player or everyone
• Items that do not fit inside the inventory are safely dropped
• Dedicated gift browser GUI for players

Useful gift commands:
CUSTOM ITEMS AND MODEL DATA
GUI buttons and gift items can be customized without modifying the plugin.

• Material and amount
• Custom display name
• Custom lore
• Custom Model Data
• Enchantments and glow effect
• Unbreakable items
• Item flags
• Player heads

This allows the plugin to work with custom resource packs and uniquely designed server items.
ANIMATED CHRISTMAS LIGHTS
Turn blocks around your server into animated Christmas decorations.

• Easy-to-use in-game light editor
• Save light blocks by clicking them with the editor tool
• Animate lights using configurable block materials
• Configurable animation interval
• Enable or disable all lights from the management menu
• Browse saved lights using a paginated GUI
• Teleport directly to saved light locations
• Remove all saved lights using an administrator command

MANAGEMENT GUI
Manage the Christmas event without searching through multiple commands.

• Preview the Advent Calendar
• Preview the Christmas Gifts menu
• Open the light editor
• Enable or disable the calendar
• Enable or disable gifts
• Enable or disable animated lights
• View saved gift and light counts
• View the current event status
• Reload configuration and language files

Open the management menu using:
HEX COLORS AND CUSTOM MESSAGES
SN-Christmas supports both traditional Minecraft color codes and modern hex colors.

• Legacy colors such as &a, &c and &6
• Hex colors using &#RRGGBB
• Hex colors using #RRGGBB
• Configurable GUI titles, item names and lore
• Configurable command and system messages
• Configurable command aliases
• Missing configuration and language entries are added automatically

Example:
PLAYER COMMANDS
ADMINISTRATOR COMMANDS
Command alias:
PERMISSIONS

• sn-christmas.calendar — Allows players to use the Advent Calendar when permission checking is enabled
• sn-christmas.admin — Provides access to all management commands and administrator menus

CONFIGURATION
Almost every part of the plugin can be customized:

• Calendar schedule and timezone
• Daily calendar rewards
• Gift rewards, weights and cooldowns
• GUI titles, sizes, slots and decorations
• Custom items and Custom Model Data
• Animated light materials and speed
• Commands, permissions and aliases
• Messages and hex colors
• Update notifications

Use the following command after making changes:
Configuration and language files are updated safely when new options are introduced.
COMPATIBILITY

• Minecraft 1.19–1.21.11
• Minecraft 26.1–26.2
• Spigot
• Paper
• Purpur
• No required dependencies
• Local SQLite data storage

The plugin is compiled using Java 17. Your server must still use the Java version required by its Minecraft version. Minecraft 26.1 and newer servers require Java 25.
INSTALLATION

1. Place the SN-Christmas jar file inside your server's plugins folder.
2. Restart the server.
3. Edit the generated configuration and language files.
4. Use /christmas reload after changing the files.
5. Open the management menu using /christmas admin.