Skip to main content

Voting & Queue Placeholders

Vote placeholders

These placeholders show the current manual event vote.

%eventforge_vote_enabled%
%eventforge_vote_active%
%eventforge_vote_time_left%
%eventforge_vote_total_votes%
%eventforge_vote_options%
%eventforge_vote_option_ids%
%eventforge_vote_winner%
%eventforge_vote_winner_display%
%eventforge_vote_count_<event_id>%
%eventforge_vote_option_<event_id>%
PlaceholderDescription
%eventforge_vote_enabled%Whether manual voting is enabled in config.yml
%eventforge_vote_active%Whether a vote is currently active
%eventforge_vote_time_left%Time left in the active vote
%eventforge_vote_total_votes%Total votes cast in the active vote
%eventforge_vote_options%Display names of active vote options
%eventforge_vote_option_ids%Event IDs of active vote options
%eventforge_vote_winner%Current winning event ID
%eventforge_vote_winner_display%Current winning event display name
%eventforge_vote_count_<event_id>%Vote count for an event option
%eventforge_vote_option_<event_id>%Whether the event is an active vote option

Examples:

%eventforge_vote_active%
%eventforge_vote_time_left%
%eventforge_vote_options%
%eventforge_vote_count_mining_rush%
%eventforge_vote_option_mob_hunt%
tip

Voting is opt-in. Enable it in config.yml before using vote placeholders on live scoreboards or menus.


Scheduled vote placeholders

These placeholders show the scheduled voting system from schedule_config.yml.

%eventforge_scheduled_vote_enabled%
%eventforge_scheduled_vote_count%
%eventforge_next_scheduled_vote%
%eventforge_next_scheduled_vote_time_left%
%eventforge_next_scheduled_vote_options%
%eventforge_next_scheduled_vote_option_ids%
%eventforge_scheduled_vote_time_left_<id>%
%eventforge_scheduled_vote_options_<id>%
%eventforge_scheduled_vote_option_ids_<id>%
PlaceholderDescription
%eventforge_scheduled_vote_enabled%Whether scheduled voting is enabled in schedule_config.yml
%eventforge_scheduled_vote_count%Number of loaded scheduled votes
%eventforge_next_scheduled_vote%ID of the next scheduled vote
%eventforge_next_scheduled_vote_time_left%Time until the next scheduled vote starts
%eventforge_next_scheduled_vote_options%Option IDs for the next scheduled vote
%eventforge_next_scheduled_vote_option_ids%Option IDs for the next scheduled vote
%eventforge_scheduled_vote_time_left_<id>%Time until a specific scheduled vote starts
%eventforge_scheduled_vote_options_<id>%Option IDs for a specific scheduled vote
%eventforge_scheduled_vote_option_ids_<id>%Option IDs for a specific scheduled vote

Examples:

%eventforge_next_scheduled_vote%
%eventforge_next_scheduled_vote_time_left%
%eventforge_scheduled_vote_time_left_hourly_vote%
%eventforge_scheduled_vote_options_hourly_vote%
%eventforge_scheduled_vote_option_ids_hourly_vote%
info

Scheduled voting is disabled by default. Enable it in schedule_config.yml and make sure each scheduled vote has at least two valid event options.


Queue placeholders

These placeholders show manual event queue information.

Global/current queue placeholders:

%eventforge_queue_active%
%eventforge_queue_event%
%eventforge_queue_event_display%
%eventforge_queue_time_left%
%eventforge_queue_players%
%eventforge_queue_min_players%
%eventforge_queue_max_players%
%eventforge_queue_joined%
PlaceholderDescription
%eventforge_queue_active%Whether any manual event queue is open
%eventforge_queue_event%Event ID of the first open queue
%eventforge_queue_event_display%Display name of the first open queue
%eventforge_queue_time_left%Time left for the first open queue
%eventforge_queue_players%Joined player count for the first open queue
%eventforge_queue_min_players%Minimum required players for the first open queue
%eventforge_queue_max_players%Maximum players for the first open queue, or if unlimited
%eventforge_queue_joined%Whether the parsing player has joined the first open queue

Event-specific queue placeholders:

%eventforge_queue_<event_id>_active%
%eventforge_queue_<event_id>_time_left%
%eventforge_queue_<event_id>_players%
%eventforge_queue_<event_id>_min_players%
%eventforge_queue_<event_id>_max_players%
%eventforge_queue_<event_id>_joined%
%eventforge_queue_<event_id>_display%
%eventforge_queue_<event_id>_event_display%

Examples:

%eventforge_queue_mining_rush_active%
%eventforge_queue_mining_rush_time_left%
%eventforge_queue_mining_rush_players%
%eventforge_queue_mining_rush_joined%
%eventforge_queue_mining_rush_display%
tip

Queue placeholders are useful for menus, scoreboards and TAB layouts that show players when a manual event queue is open.