Placeholders
The PlaceholderAPI placeholders under the eventpulse identifier, and the short names that work inside the plugin's own files without it.
With PlaceholderAPI installed, EventPulse registers an expansion under the identifier eventpulse. Nothing has to be downloaded from the expansion cloud, the plugin registers it itself at startup and the console says so.
Always available
| Placeholder | What it shows |
|---|---|
%eventpulse_active% | true while an event is running, otherwise false |
%eventpulse_next_in% | Time until the next event. Empty when the scheduler is off |
%eventpulse_wins% | The player's lifetime wins |
%eventpulse_farmpoints% | The player's lifetime FarmPoints |
During an event
All of these are empty when no event is running.
| Placeholder | What it shows |
|---|---|
%eventpulse_name% | The event's display-name |
%eventpulse_action% | The event's action line |
%eventpulse_time_left% | Time until the event ends |
%eventpulse_score% | The player's own points in this event |
%eventpulse_position% | The player's place, 0 if they have not scored. In a team event, their island's place |
%eventpulse_team_score% | The player's island total during a team event, 0 in a solo event |
%eventpulse_team_position% | The island's place during a team event, 0 in a solo event |
%eventpulse_top_<n>_name% | The name in that slot of the ranking, for n from 1 to 10. Nobody when the slot is empty |
%eventpulse_top_<n>_score% | The score in that slot, 0 when empty |
The lifetime numbers come from a small cache that is refreshed when a player joins and after every payout, so asking for them never waits on the database.
Without PlaceholderAPI
The plugin's own files use short names that work whether or not PlaceholderAPI is installed. scoreboard.yml lines take %event%, %action%, %top1_name%, %top1_score%, %position%, %score%, %team_score% and %time_left%. The language files take the names listed at the top of each file. Reward commands and messages take %player%, %score%, %position%, %event% and %island%. See Scoreboard, Messages & language and Rewards.