🗓️Event System

AdvancedSeasons features a highly customizable events system, allowing users to create, modify, or delete in-game events to suit their specific needs. The provided examples in the events.yml file are just default configurations, serving as templates that can be tailored or expanded upon.

Configuration File

events.yml

events:
  halloween:
    name: "&6Halloween"
    day: 8
    time: EVENING #NIGHT, MORNING, DAY, EVENING
    broadcast:
      - '&7Spooky Halloween is here! Beware of the darkness...'
    commands:
      - '[FOR ALL PLAYERS] give %player% pumpkin 1 name:&6Halloween_Special'
  christmas:
    name: "&2Christmas"
    day: 10
    time: MORNING #NIGHT, MORNING, DAY, EVENING
    broadcast:
      - '&7Merry Christmas! The world is covered in a festive spirit.'
    commands:
      - '[FOR ALL PLAYERS] give %player% cookie 1 name:&2Christmas_Treat'
      - '[FOR ALL PLAYERS] give %player% snowball 16 name:&fSnowball_Fight!'
  new_year:
    name: "&bNew Year"
    day: 11
    time: NIGHT #NIGHT, MORNING, DAY, EVENING
    broadcast:
      - '&7Happy New Year! May the new adventures begin!'
    commands:
      - '[FOR ALL PLAYERS] give %player% firework_rocket 1 name:&bNew_Year_Celebration'
  valentines:
    name: "&dValentine's Day"
    time: MORNING #NIGHT, MORNING, DAY, EVENING
    day: 2
    broadcast:
      - '&7Happy Valentine’s Day! Share the love with everyone around you.'
  easter:
    name: "&eEaster"
    time: MORNING #NIGHT, MORNING, DAY, EVENING
    day: 2
    broadcast:
      - '&7Happy Easter!'

Flexibility and Customization

User-Created Events

• Full Control: Users have the freedom to define their own events, setting unique dates, times, broadcast messages, and commands.

• Creativity and Personalization: This feature enables server administrators to craft events that resonate with their community, be it server-specific holidays, special occasions, or unique themed events.

Modifying Default Events

• Edit Existing Events: The default events like Halloween, Christmas, New Year, Valentine's Day, and Easter can be modified to better fit the server's theme or preference.

• Adjustable Settings: Change the day, time, broadcast messages, and commands to create a custom experience for each event.

Deleting or Disabling Events

• Removal Option: Users can completely remove any default event if it doesn't align with their server's theme or if they prefer to create a completely unique set of events.

• Disabling Feature: If users wish to temporarily disable an event without deleting it, they can do so, allowing for flexibility in event management.

Technical Structure

Each event in the events.yml file is structured with key elements:

• name: The display name of the event.

• day: The in-game day when the event occurs.

• time: The time of day for the event (e.g., NIGHT, MORNING, DAY, EVENING).

• broadcast: The messages broadcast to players during the event.

• commands: The set of commands executed during the event.

Example

custom_event:
  name: "&aCustom Event"
  day: 5
  time: DAY
  broadcast:
    - '&7A custom event is happening now!'
  commands:
    - '[FOR ALL PLAYERS] give %player% [item] [amount]'

This level of customization in the AdvancedSeasons plugin ensures that each Minecraft server can offer a unique and tailored experience, reflecting the creativity and preferences of its community.