Aevum • Placeholders

##Introduction

When PlaceholderAPI is installed, Aevum registers the aevum expansion so you can display any timer — and its checkpoints — anywhere placeholders work: scoreboards, tab lists, chat, holograms and more.

INFO

Placeholders resolve against the viewing player's own timer. For a player-scoped timer that's their personal one; for a team-scoped timer it's their team's; for a global timer it's the shared one. Replace <name> with your timer name and <label> with a mark label.

##Timer placeholders

Placeholder	Returns
`%aevum_timer_<name>_time%`	Remaining time, formatted (`MM:SS` or `HH:MM:SS`).
`%aevum_timer_<name>_seconds%`	Remaining time in whole seconds.
`%aevum_timer_<name>_status%`	`running`, `paused` or `stopped`.

##Mark (checkpoint) placeholders

Swap in your mark's <label>:

Placeholder	Returns
`%aevum_timer_<name>_mark_<label>%`	Formatted time recorded at the mark.
`%aevum_timer_<name>_mark_<label>_seconds%`	Seconds recorded at the mark.
`%aevum_timer_<name>_mark_<label>_at%`	Epoch milliseconds when the mark was recorded.

##Examples

&aRound ends in: &f%aevum_timer_round_time%
&7Status: &f%aevum_timer_round_status%
&eHalfway split: &f%aevum_timer_round_mark_half%

WARNING

If the timer doesn't exist for the viewing player (or the mark isn't found), the placeholder resolves to an empty string rather than an error — handy for conditional scoreboard lines.

##Notes

The expansion identifier is aevum, and it persist()s — it keeps working for offline players where PlaceholderAPI allows.
<name> may contain underscores; Aevum parses the trailing _time / _seconds / _status (or _mark_…) suffix correctly.
Looking for stopwatches? See Stopwatch Placeholders.
Any placeholder you put inside Aevum's own messages.yml and action messages is also resolved through PlaceholderAPI — see config.yml.