Examples & Fixes
Older supported formats
Some older placeholder formats are still supported.
%eventforge_event_active_<event>%
%eventforge_event_loaded_<event>%
%eventforge_event_on_cooldown_<event>%
%eventforge_event_cooldown_<event>%
%eventforge_event_display_<event>%
%eventforge_event_time_left_<event>%
%eventforge_event_elapsed_<event>%
%eventforge_event_participants_<event>%
%eventforge_player_score_<event>%
%eventforge_player_rank_<event>%
%eventforge_player_participating_<event>%
%eventforge_event_scheduled_<event>%
%eventforge_event_next_start_<event>%
%eventforge_event_category_<event>%
%eventforge_event_difficulty_<event>%
%eventforge_event_author_<event>%
%eventforge_event_version_<event>%
%eventforge_event_tags_<event>%
%eventforge_event_description_<event>%
%eventforge_event_can_start_<event>%
%eventforge_event_start_reason_<event>%
%eventforge_event_region_count_<event>%
For new setups, use the newer format:
%eventforge_event_<event>_<value>%
Example:
%eventforge_event_mining_rush_active%
Example scoreboard lines
&bActive Events: &f%eventforge_active_count%
&7Current: &f%eventforge_active_names%
&7Next Event: &f%eventforge_next_event%
&7Starts In: &f%eventforge_next_event_time%
&7Vote: &f%eventforge_vote_active% &8(&f%eventforge_vote_time_left%&8)
&7Queue: &f%eventforge_queue_event_display% &8(&f%eventforge_queue_time_left%&8)
&7Score: &a%eventforge_event_mining_rush_player_score%
&7Rank: &e#%eventforge_event_mining_rush_player_rank%
Example menu checks
Show a vote button only while a vote is active:
%eventforge_vote_active%
Show a queue join button only while a queue is active:
%eventforge_queue_active%
Show whether the player has joined the current queue:
%eventforge_queue_joined%
Show whether a specific event queue is open:
%eventforge_queue_mining_rush_active%
Troubleshooting
Placeholder returns blank
Check that:
EventForge is installed
PlaceholderAPI is installed
the event ID is correct
the event is loaded
the placeholder spelling is correct
Run:
/eventforge list
to check loaded event IDs.
Player placeholders return 0 or No
Some placeholders need a player context.
For example:
%eventforge_event_mining_rush_player_score%
%eventforge_queue_joined%
work best in scoreboards, TAB, menus, or plugins that parse placeholders for a specific player.
Event time left returns 0s
The event probably is not active.
Check:
%eventforge_event_mining_rush_active%
or run:
/eventforge active
Vote placeholders show No or 0
Voting may be disabled or no vote may be active.
Check:
%eventforge_vote_enabled%
%eventforge_vote_active%
Then start a vote:
/eventforge vote start mining_rush mob_hunt
Scheduled vote placeholders show blank
Scheduled voting may be disabled, or no scheduled votes may have loaded.
Check:
%eventforge_scheduled_vote_enabled%
%eventforge_scheduled_vote_count%
Then run:
/eventforge validate schedule_config.yml
Queue placeholders show No or 0
No manual queue may be open.
Check:
%eventforge_queue_active%
Then start a manual-mode event:
/eventforge start mining_rush
If the event is still using AUTOMATIC, it will start instantly instead of opening a queue.
Summary
PlaceholderAPI lets other plugins display EventForge data.
Useful placeholders include:
%eventforge_active_names%
%eventforge_next_event%
%eventforge_next_event_time%
%eventforge_event_<event>_active%
%eventforge_event_<event>_player_score%
%eventforge_event_<event>_player_rank%
%eventforge_vote_active%
%eventforge_vote_time_left%
%eventforge_next_scheduled_vote_time_left%
%eventforge_queue_active%
%eventforge_queue_time_left%
%eventforge_queue_joined%
%eventforge_top_player_<event>_1%
%eventforge_top_score_<event>_1%