Events and custom events

Custom Events

Default custom-events.yml file:

custom-events:
   dated-events:
      october-event-example:
         enabled: false
         name: "&6Spooky October"
         display-event: true
         times:
            event-start:
               date: 1/10
            event-stop:
               date: 1/11
         commands:
            start:
               - "&aOctober has started, monsters are becoming stronger and stronger.."
               - "/difficulty hard"
            stop:
               - "/difficulty normal"
   weekly-events:
     safe-sunday-example:
         enabled: false
         name: "&aSafe Sunday"
         display-event: true
         day: Sunday
         commands:
            start:
               - "&6It is now &7Sunday %day%/%month%/%year%. &6Time for a break, dying isn't dangerous for the day"
               - "/gamerule keepInventory true"
            stop:
               - "/gamerule keepInventory false"
   daily-events:
      daily-message-example:
         enabled: false
         commands:
            - "&3Midnight has passed, &f%weekday%, %month_asname% %day%, year %year%&3 has started"
            - "&3Current season: &f%season%"

This file allows you to create as many planned events as you want. These events can be daily, weekly or on specific dates. You can send messages to the player or run commands as the console (include a '/' before the command) when the event starts and stops. Possible placeholders in commands are %day%, %month%, %month_asname%, %year%, %weekday%, %season%, %world%. All external placeholders by PlaceHolderAPI are also supported.

The dates in dated events can be: dd/mm/yyyy or mm/dd/yyyy if American date format is enabled in the calendar.yml. Not including a year makes the event run every year (see october-event-example). You can also enter only a day ("date: 5"), this will make the event run every month between the specified days.

Active events can be viewed by the user through /season or the placeholder %rs_active_events%. This can be disabled separately for each event with "display-event". The "name" field will be used to display it. Colour codes can also be used.

Build-in events

Events.yml has a similar configuration as the custom-events.yml except that is has extra settings for build-in season events like Christmas, New year, Easter and Halloween. Here is the default file:

dated-events:
   christmas:
      enabled: true
      name: "&cChristmas"
      display-event: true
      disabled-worlds:
      - NONE
      times:
         event-start:
            date: 25/12
         event-stop:
            date: 28/12
      night-particles: true 
      christmas-trees:  
         enabled: true 
      commands:
         start:
            - "&cChristmas &ahas started!"
            - "&aHead over to a nearby village to celebrate together, you may even find some presents"
         stop:
            - NONE
      presents: 
         enabled: true 
         chunk-distance-between-spawns: 10 
         loot:
         - "2-8:EXPERIENCE_BOTTLE"
         - "6-20:FIREWORK_ROCKET"
         - "1-12:FIRE_CHARGE"
         - "2-16:POTATO"
         - "2-8:CARROT"
         - "1-16:COAL"
         - "1-16:SNOWBALL"
         - "2-12:SWEET_BERRIES"
         - "6-16:COOKIE"
         - "1-2:ENDER_PEARL"
         - "4-12:BAKED_POTATO"
         - "2-8:BOOK"
         - "4-12:BREAD"
         - "1:DIAMOND"
         - "1:GOLD_INGOT"
         - "2-8:COOKED_RABBIT"
         - "2-8:COOKED_MUTTON"
         - "2-8:COOKED_BEEF"
         - "2-8:COOKED_CHICKEN"
         - "2-8:COOKED_PORKCHOP"
         - "2-8:COOKED_SALMON"
         - "1-3:GOLDEN_APPLE"
         - "2-8:GOLDEN_CARROT"
         - "1:LEATHER_HELMET"
         - "2-16:SPECTRAL_ARROW"
         - "1:CLOCK"
         - "1-3:MAGMA_CREAM"
         - "1-3:NETHER_WART"
         - "1-3:BLAZE_ROD"
         - "1-6:GOLD_NUGGET"
         - "2-8:COOKED_COD"
         - "1-4:SPRUCE_SAPLING"
   newyear:
      enabled: true
      name: "&cNew year"
      display-event: true
      disabled-worlds:
      - NONE
      times:
         event-start:
            date: 1/1
         event-stop:
            date: 1/1
      spawn-firework-boxes: true 
      min-distance-between-firework: 34 
      commands:
         start:
            - "&cHappy new year!"
            - "&aVillagers are celebrating, head over to a nearby village"
         stop:
            - NONE
   halloween:
      enabled: true
      name: "&6Halloween"
      display-event: true
      disabled-worlds:
      - NONE
      times:
         event-start:
            date: 31/10
         event-stop:
            date: 2/11
      commands:
         start:
            - "&6Halloween &ahas started!"
            - "&aBe extra careful tonight..."
         stop:
            - NONE
      play-particles-around-halloween-mobs: true
      witch-extra-potions: 
         enabled: true 
         effects:  
         - BLINDNESS 
         - CONFUSION 
         - WITHER 
         - SLOW_DIGGING 
         - SLOW_FALLING 
         - LEVITATION 
      duplicating-mobs: 
         enabled: true 
         spawn-chance: 0.07 
      invisible-mobs: 
         enabled: true 
         spawn-chance: 0.07 
      fast-mobs: 
         enabled: true 
         spawn-chance: 0.07 
      flame-skeletons:
         enabled: true 
         spawn-chance: 0.3 
      armored-mobs: 
         enabled: true 
         spawn-chance: 0.25 
      zombies-hold-pie: 
         enabled: true 
         spawn-chance: 0.3 
      vincicators-at-night: 
         enabled: true 
         spawn-chance: 0.05 
   easter:
      enabled: true
      name: "&dEaster"
      display-event: true
      disabled-worlds:
      - NONE
      times:
         event-start:
            date: 20/4
         event-stop:
            date: 24/4
      spawn-killer-bunnies: true 
      commands:
         start:
            - "&dEaster &ahas started!"
            - "&aEggs are hidden all throughout the world. However, be careful at night"
         stop:
            - NONE
      easter-eggs:
         enabled: true 
         chunk-distance-between-spawns: 4 
         loot: 
         - "6-3:COOKIE"
         - "2-16:CARROT"
         - "1:RABBIT_FOOT"
         - "1:CAKE"
         - "1-20:LEATHER"
         - "2-24:GOLDEN_CARROT"
         - "2-48:POTATO"
         - "2-48:WHEAT"
         - "2-16:GOLDEN_APPLE"
         - "2-48:BEETROOT"
         - "1:SADDLE"
         - "1:NAME_TAG"
         - "2-10:EGG"
         - "2-10:MELON_SEEDS"
         - "2-10:PUMPKIN_SEEDS"
         - "2-16:BLUE_DYE"
         - "2-16:RED_DYE"
         - "2-16:YELLOW_DYE"
         - "2-32:BAMBOO"
         - "2-32:OAK_LOG"
         - "1:HONEY_BOTTLE"
         - "1-8:HONEYCOMB"
         - "1-8:CACTUS"
         - "1-12:SLIME_BALL"
         - "1-5:HAY_BLOCK"
         - "1:MUSHROOM_STEW"
         - "1-12:GOLD_INGOT"
         - "1-6:DIAMOND"

If an event should start or stop on a date that doesn't exist on the configured calendar it will choose the closest day possible.

Last updated