Global Events - Rumsfield/konquest GitHub Wiki
Updated in version 1.10.0
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
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 |
- 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.
- 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 - Set a duration for the event, for example, 4 hours.
/k admin event duration MyEvent hours 4 - 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 - 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 - 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
- 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>.
There are several ways to see the details about global events.
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.
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 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 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.
-
KonquestGlobalEventEndEvent- Indicates when a global event ends. -
KonquestGlobalEventStartEvent- Indicates when a global event starts.