Event Placeholders
Event placeholders
These use the event ID inside the placeholder.
Format:
%eventforge_event_<event>_<value>%
Example:
%eventforge_event_mining_rush_active%
Available values:
active
loaded
on_cooldown
cooldown
display
time_left
elapsed
participants
scheduled
next_start
category
difficulty
author
version
tags
description
can_start
start_reason
region_count
player_score
player_rank
player_participating
Examples:
%eventforge_event_mining_rush_active%
%eventforge_event_mining_rush_loaded%
%eventforge_event_mining_rush_time_left%
%eventforge_event_mining_rush_participants%
%eventforge_event_mining_rush_player_score%
%eventforge_event_mining_rush_player_rank%
%eventforge_event_mining_rush_player_participating%
Event status placeholders
| Placeholder | Description |
|---|---|
%eventforge_event_<event>_active% | Whether the event is active |
%eventforge_event_<event>_loaded% | Whether the event is loaded |
%eventforge_event_<event>_on_cooldown% | Whether the event is on cooldown |
%eventforge_event_<event>_cooldown% | Remaining event cooldown |
%eventforge_event_<event>_can_start% | Whether the event can start |
%eventforge_event_<event>_start_reason% | Reason the event cannot start |
Event time placeholders
| Placeholder | Description |
|---|---|
%eventforge_event_<event>_time_left% | Time left for an active event |
%eventforge_event_<event>_elapsed% | Elapsed time for an active event |
%eventforge_event_<event>_scheduled% | Whether the event is scheduled |
%eventforge_event_<event>_next_start% | Time until the event's next scheduled start |
Event metadata placeholders
| Placeholder | Description |
|---|---|
%eventforge_event_<event>_display% | Event display name |
%eventforge_event_<event>_category% | Event category |
%eventforge_event_<event>_difficulty% | Event difficulty |
%eventforge_event_<event>_author% | Event author |
%eventforge_event_<event>_version% | Event version |
%eventforge_event_<event>_tags% | Event tags |
%eventforge_event_<event>_description% | Event description |
%eventforge_event_<event>_region_count% | Number of configured regions for the event |
Event player placeholders
These placeholders need a player context.
| Placeholder | Description |
|---|---|
%eventforge_event_<event>_player_score% | Player's score in the event |
%eventforge_event_<event>_player_rank% | Player's rank in the event |
%eventforge_event_<event>_player_participating% | Whether the player is participating |
Example:
%eventforge_event_mining_rush_player_score%
For manual queue events, player_participating only returns Yes for players who are actually participating in the active event.
Event variable placeholders
You can read event variables through PlaceholderAPI.
Format:
%eventforge_event_variable_<event>_<variable>%
Example:
%eventforge_event_variable_mining_rush_event_color%
If the variable exists in the event file, the placeholder returns its value.
Region placeholders
EventForge can check whether a player is inside a configured event region.
Format:
%eventforge_player_in_region_<event>_<region>%
Example:
%eventforge_player_in_region_capture_zone_blue_zone%
This returns:
Yes
No
You can also show the number of regions configured for an event:
%eventforge_event_<event>_region_count%
Example:
%eventforge_event_capture_zone_region_count%