Christmas Mail

Players sends a little surprise to their friends and at Christmas Eve, they are able to see what players sent them.

Module

If you are using this resource because of other features and Christmas Mail is not used, you can to disable this module and increase performance of the server.

Options:
  ChristmasMail:
    Active: true #false, if module is not used

Season duration

Range of days, while module is active.

Options:
  ChristmasMail:
    Season:
      DateFormat: "dd.MM.yyyy HH:mm"
      StartDateTime: "01.12.2022 00:00" #The datetime when the season starts.
      GapDateTime: "24.12.2022 00:00" #The datetime when the sending mode is turned to reading mode.
      EndDateTime: "31.12.2022 23:59" #The datetime when the season ends.

Before and after this season, players won't be able to open Christmas Mail.

MailBox

When player wants to send a surprise to his friennd, he needs to create MailBox.

Capacity of MailBoxes is limited.

Options:
  ChristmasMail:
    MailBox:
      Capacity:
        Default: 9

Extend capacity

By permissions, you can extend capacity of MailBoxes for player.

Simply create KEY and assign it value.

Options:
  ChristmasMail:
    MailBox:
      Capacity:
        Extension:
          PRINCE: 3
          KING: 9

Default + Extension = Total Capacity

Example

Extension with key VIP_GOLD extends capacity by 5. In configuration file, it will look like this:

Options:
  ChristmasMail:
    MailBox:
      Capacity:
        Extension:
          VIP_GOLD: 5

Player with permission AdventSeason.ChristmasMail.MailBox.Capacity.VIP_GOLD can create 14 MailBoxes. (9 as Default + 5 by extension)

At applying more permissions on the player, only permission with highest value will be used!

Vulgarism filter

Christmas time is about peace and calm, why to send inappropriate messages in wishes?

To handle vulgarisms in wishes, you need to put inappropriate words into specific file. One word has to be on separated line.

If file InappropriateBehaviour.txt does not exist, please create one in AdventSeason folder.

Figure (Elf)

Via Figure, players are able to open Christmas Mail. Elf 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. Elf copies your locations and also facing direction!

To place Elf type: /ChristmasMail 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 Christmas Mail with the nearest Armor Stand in your range type: /ChristmasMail Figure Link

Mode

List of modes mentioned above:

• NONE

• ARMOR_STAND

• PLAYER

• HOLOGRAM

Options:
  ChristmasMail:
    Figure:
      Mode: "ARMOR_STAND"

Particle

At location where the Elf is placed, particles are spawned.

Options:
  ChristmasMail:
    Figure:
      Particle:
        Active: true