Options
Looking into Options.yml
Season duration
Range of days, while module is active.
Before and after this season, players won't be able to interact with Figure.
Window
Window at Calendar opens once a day at specified time.
If player misses to claim the window for specific day, he won't able to open in next day!
This strict behaviour can be changed to benevolent and player is able to open any previous windows.
Sound
Sounds make the game more attractive. Currently played at various situations while interacting with figure.
Actions, when the Sounds are played.
OpeningWindow - Sound played when the new window has been opened.
ClaimingReward - Sound played to player at claiming reward.
Spin Button - Sound played at LuckyWheel at interacting with Spin button.
Spin Animation - Sound played at LuckyWheel at spinning with rewards.
Closing Animation - Sound played at LuckyWheel at closing spining field.
List of latest sounds are available at https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
Reward
Choice Types:
QUICK_ALL
- All assigned rewards are given to playerQUICK_CHANCE
- One reward is selected from assigned list by probabilityLUCKY_WHEEL
- After click, new GUI will be opened. There, random reward from list selected for that day will be claimed. It is the same option asQUICK_CHANCE
, but here is an animation
Example for probability. DiamondTools
has 90% chance, MoneyPocket
has 10% chance to win.
Summary of probability at assinged rewards has to be 100.0! Otherwise, system won't work correctly!
Benefit
By opening all windows in calendar, you can reward players with extra gift.
Visual
Section represents components displayed at chat, boss bars and titles.
Boss Bar
Players are able to see current information about upcoming event.
Available colors
PINK
, BLUE
, RED
, GREEN
, YELLOW
, PURPLE
, WHITE
Available styles
SOLID
, SEGMENTED_6
, SEGMENTED_10
, SEGMENTED_12
, SEGMENTED_20
Information intervals
Information can be displayed in specified intervals and these itervals are mainly associtated with BossBar.
Imagine interval in math, but reversed because of countdown which is decresing.
If we want to display BossBar since 30 seconds to 10 seconds, we use interval 30:11
(FROM:TO+1
). Plus 1 because of we want to hide BossBar in 10 seconds. (If we keep 10 seconds in the interval, BossBar will be hidden in 9 seconds.)
Restriction
You can disable performing some actions while using the resource.
Operate with modules such as AdventCalendar or ChristmasMail can be restricted in specified worlds. Each world name on the new line.
If you want to allow all worlds, you need to set Empty Collections([]
) here!
Figure (Santa)
Via Figure, players are able to open Advent Calendar. Santa also displays current status of the season.
System offers pre-defined Armor Stand, with clothes and head. All values can be changed in the configuration file. System also supports NPC, you can aslo equip it with armor or items.
Warning at placing the Figure. Figure copies your locations and also facing direction!
To place Assistant type: /AdventCalendar Figure Place
If you have own Armor Stand, you can link it with Advent Figure. It only creates Holograms above the Armor Stand.
To link Figure with the nearest Armor Stand in your range type: /AdventCalendar Figure Link
Mode
List of modes mentioned above:
NONE
ARMOR_STAND
PLAYER
HOLOGRAM
Particle
Particles are spawning around the spawned Figure. You can keep them active or disable them. Also you can change Effect, Color, Speed and Amount.
Calendar Interface (GUI)
Calendar interface is the main part of the whole module, that's the reason it must looks perfect. And you can configure it to your requirements.
Slot
Slots are configured at Calendar.yml file.
Order
Specify the order of the day assigned to slot of the window.
RANDOM
- Days are assigned to window in random order. Shuffle order is created after loading of the plugin.STATIC
- Days are assigned to window in order specified in Calendar.yml file.
Window's Icon
Claimed window has another visual icon as closed or missed window.
REWARD
- Icon of reward is used as opened window.DEFAULT
- Item from configuration is used as opened window.
Last updated