✗ Christmas+ [1.7-1.16] 2.16.1

Christmas+ is an advanced, high-quality christmas-themed plugin which will add an unique holiday experience to your server.

• Advent Calendar
  • Efficient and fully configurable GUI
    
  • Allows players to claim different items/enchantments/commands/permissions every day
  • You can give multiple gifts every day
    
  • You can enable/disable claiming gifts from previous days
    
  • Supports different gifts for donors or any other groups
• Santa Claus event
  • Allows you to spawn Santa Claus with configurable name and skin for specified time period
  • Santa can be spawned in random (pre-configured) locations
    
  • Santa drops gifts every with a configurable chance of drop
  • Santa may leave snow trail (which fades after a small delay)
  • Santa can spawn even in WorldGuard protected regions (with mob-spawning set to deny)
• Christmas Crackers
  • Allow you to give players custom cracker items they could open and get predefined rewards: items, permissions or commands (can be used to grant items from other plugins)
  • Commands to give to others and claim for themself (can be used with a timed commands plugin)
• Snow effect particles
  • Five configurable levels of snowfall intensity
    
  • World blacklist
• 100% customizable messages, placeholders and items
• Reload command to update the advent calendar without restarting the server
• Efficient & high-quality code
• Even more features & events will be added before Christmas!

There are three different Santa skins to choose:




If you need a different one you can set it as your skin and specify your name in config.yml for the santa.



Advent calendar command aliases: /adventcalendar /ac /calendar /acalendar
Christmas command aliases: /christmas /ch /chr /christmasplus /xmas
Crackers command aliases: /cracker /crackers

• /adventcalendar - open the advent calendar GUI (christmasplus.adventcalendar)
• /adventcalendar reset <player> <day number | all> - resets the entire calendar or a specific day to a specific player (
  christmasplus.adventcalendar.reset)
• /adventcalendar test - toggles on/off the test mode for yourself allowing to claim all gifts regardless of day/month (christmasplus.adventcalendar.test)

• /christmas start santa [time] [world] [x] [y] [z] - start the Santa Claus event for specified time (time string is optional, the default value is set in config.yml). Time string, world name and coordinates are required when starting the event from the server console. (christmasplus.christmas.start)
• /christmas start santa [time] random - same as above but the location is random (see FAQ #4 to learn how to setup locations) (christmasplus.christmas.start)
  
• /christmas stop <santa> - manually stop the Santa Claus event (christmasplus.christmas.stop)
  
• /christmas reload - reload the configuration (christmasplus.christmas.reload)

• /cracker list - list all available crackers (christmasplus.cracker.list)
• /cracker give <player> <cracker> [amount] - give crackers to other player (christmasplus.cracker.give)
• /cracker get <cracker> [amount] - get certain amount of cracker (christmasplus.cracker.get + christmasplus.cracker.get.multiple to be able to specify amount higher than 1)

All command permissions have been listed above.



Required:

• Spigot 1.7.10 or newer
• Vault 1.4.1 or newer
• Economy plugin supported by Vault (eg. Essentials or EssentialsX)

Optional:

• Lib's Disguises (Required by the Santa Clause event)
  • For 1.15 and 1.16: Download (latest build)
    
  • For 1.14: Download
    
  • For 1.13: Download
    
  • For 1.11 and 1.12: Download
    
  • For 1.10: Download
    
  • For 1.9: Download
    
  • For 1.8: Download
• SilkSpawners or PickupSpawners or EpicSpawners

Santa skin may not work on offline-mode servers.

1. Purchase (thanks!) and download the plugin
2. Stop your server, put the .jar file in your server's /plugins/ directory
3. Start the server, plugin will generate all necessary config files
4. Fill in config.yml, crackers.yml adventcalendar.yml with desired settings
5. Restart the server
6. Done!

All configuration files are easy to edit. If any of them lacks a feature you wish to be added, please contact me.

Configuration examples (please don't copy them, the plugin will generate all necessary files):

• adventcalendar.yml
• config.yml
• crackers.yml
• lang.yml

1. How do you give multiple gifts one day?
First, make sure you're using at least the 1.0.4 version. Now, in order to add multiple items you have to create a config section named multiple inside the type of the gift (in the example it's default and donor, I added it to default - you add it to both or just one of them). Then you can add the items inside the multiple sections, each of them has to have an unique ID (value doesn't matter, it isn't the number of the day, it just has to be unique). I set it to 1, 2 and 3. In the example it's an item, enchantment and command, though it can be eg. as many items as you want.
Example: http://pastebin.com/MiEgFj7r

2. How do you change the advent calendar's month?
You can change the month by adding "month" entry to adventcalendar.yml. Note: Changing this value requires database reset
Example: http://pastebin.com/GM5aZPyD

3. How do you give a random gift each day in the advent calendar?
You need at least 2.2.8 version to do that. It's similar to multiple gifts explained above in FAQ #1 but the config section is named random. Furthermore, you have to add chance to each item. These are actually the weights of gifts, they don't have to sum up to 100%.
Example: http://pastebin.com/Z1xJa3Pv

4. How do you start the Santa event in random locations?
For performance and convenience reasons Santa can spawn randomly only in preconfigured locations. You can edit them in the santaClausEvent -> locations section in config.yml. After adding some, you can start the event using the /christmas start santa [time] random command.
Example: https://pastebin.com/NY2q30ja



By purchasing this plugin resource you agree to following terms of service:

• No refunds will be given unless a solid reasoning is provided
  
• You may not -Redacted- the plugin jar or any part of its source code
  
• Redistribution of config files is allowed
  
• We may refuse to give you support without any specific reason
• Source code is not a part of the purchase and will not be provided
• This software is designed for Spigot only. It most likely will work with other forks, but we may refuse to give support for any setups based on other server software if we cannot reproduce your issue on Spigot.