Global Events - Rumsfield/konquest GitHub Wiki

Updated in version 1.10.0

Konquest Global Events

A Global Event is a period of time where gameplay effects are applied to the entire server. Events are set up by admins with the command /k admin event. Events can be scheduled as a single occurrence, or they can repeat with a repetition interval. All players are notified when global events start and end.

To disable all global events, set the core.yml config setting core.event_interval: 0.

Global Events have these properties:

  • Name - The event's title
  • Duration - How long the event lasts
  • Repetition - How long until the event starts again
  • Start Date - The initial day and time when the event starts
  • Enabled - Is the event on, or paused
  • Active - Is the event currently in progress
  • Effects - The list of gameplay effects used while the event is active

Effects

These are all effects that can be included with an event. Some effects are grouped together where only 1 effect in the group can be active at a time.

Effect Title Description Priority Grouped With
ALL_PVP All PvP All players can fight - -
ALL_WAR All War All kingdoms are at war Low ALL_PEACE
ALL_PEACE All Peace All kingdoms are at peace High ALL_WAR
FREE_TRAVEL Free Travel Travel is instant and free - -
FREE_SHIELDS Free Shields Towns and capitals get unlimited shields Low NO_SHIELDS
NO_SHIELDS No Shields All town shields are broken High FREE_SHIELDS
NO_ARMOR No Armor All town armor is removed - -
NO_PROTECTION No Protection All towns can be attacked offline - -
NO_IMMUNITY No Immunity All capitals lose immunity - -
FAVOR_1 Favor Discount 1 Favor costs are reduced 20% Low FAVOR_3, FAVOR_2
FAVOR_2 Favor Discount 2 Favor costs are reduced 50% Medium FAVOR_3, FAVOR_1
FAVOR_3 Favor Discount 3 Favor costs are reduced 80% High FAVOR_2, FAVOR_1
MONUMENT_LOOT_1 Monument Loot 1 Town loot increased x2 Low MONUMENT_LOOT_3, MONUMENT_LOOT_2
MONUMENT_LOOT_2 Monument Loot 2 Town loot increased x5 Medium MONUMENT_LOOT_3, MONUMENT_LOOT_1
MONUMENT_LOOT_3 Monument Loot 3 Town loot increased x10 High MONUMENT_LOOT_2, MONUMENT_LOOT_1
RUIN_LOOT_1 Ruin Loot 1 Ruin loot increased x2 Low RUIN_LOOT_3, RUIN_LOOT_2
RUIN_LOOT_2 Ruin Loot 2 Ruin loot increased x5 Medium RUIN_LOOT_3, RUIN_LOOT_1
RUIN_LOOT_3 Ruin Loot 3 Ruin loot increased x10 High RUIN_LOOT_2, RUIN_LOOT_1
EXP_BOOST_1 EXP Boost 1 Experience orbs increased x2 Low EXP_BOOST_3, EXP_BOOST_2
EXP_BOOST_2 EXP Boost 2 Experience orbs increased x5 Medium EXP_BOOST_3, EXP_BOOST_1
EXP_BOOST_3 EXP Boost 3 Experience orbs increased x10 High EXP_BOOST_2, EXP_BOOST_1

Rules for Effects

  • A single event cannot include multiple effects in the same group, i.e. FAVOR_2 and FAVOR_1.
  • Multiple different events can include effects from the same group, but if those events are active at the same time, then the effect with the higher priority will become active, and the other effects with lower priority will not.
    • Example: Event A has effect NO_SHIELDS, and Event B has effect FREE_SHIELDS. When both A and B are active, only the NO_SHIELDS effect will be active because it has the higher priority in its group with FREE_SHIELDS.

How to Create and Manage Events

  1. Create a new event with command /k admin event create <name>. This new event will have no start date, and no effects. Use more commands to add details to the event.
    /k admin event create MyEvent
    
  2. Set a duration for the event, for example, 4 hours.
    /k admin event duration MyEvent hours 4
    
  3. Set a repetition for the event, for example, 7 days (1 week). Use 0 to set no repetition (single occurrence event).
    /k admin event repetition MyEvent days 7
    
  4. Add effects to the event.
    /k admin event effect MyEvent add FREE_TRAVEL
    /k admin event effect MyEvent add FAVOR_2
    /k admin event effect MyEvent add EXP_BOOST_3
    
  5. Lastly, set the start date for the event. You can start it right now, or at a specific date using Year, Month, Day, Hour (0 - 23), Minute (0 - 59). You can skip the hour and minute to make the event start at midnight on the specified day.
    /k admin event start MyEvent now
    /k admin event start MyEvent 2025 12 25 12 00
    

Other management commands

  • Remove an event to delete with /k admin event remove <name>.
  • Pause an event to temporarily disable its effects with /k admin event enable <name> false. Resume the event with /k admin event enable <name> true.
  • View the details about an event with /k event info <name>.

View Event Details

There are several ways to see the details about global events.

Chat Commands

Use commands in-game to display information about events.

  • /k event effects - List all effects and see which ones are currently active.
  • /k event list - List all global events and when they start.
  • /k event info [name] - Show details about current/upcoming events, or specific events by name.

GUI Menu

Use the command /k event to open the Event Menu, or open it from the Konquest Main Menu (/k menu), by clicking on the Clock item icon.

  • The Event Menu include a Calendar page that shows each day of the month and which events will occur.
  • There are also pages for lists of all events, effects, and current/upcoming info.

Placeholders

Placeholders can be used in other plugins, like scoreboards and holographic displays, to show info about active events in progress.

  • %konquest_events% - List of active global events
  • %konquest_event_effects% - List of active global event effects

Spigot API Events, DiscordSRV Alerts

Spigot API events can be used by other plugins to act on specific triggers. DiscordSRV plugin's Alerts feature can be used to listen for these Konquest events to display Discord messages.

⚠️ **GitHub.com Fallback** ⚠️