Skip to main content

Placeholders

FioPlaytime registers the PlaceholderAPI identifier fioplaytime.

Available placeholders

PlaceholderDescription
%fioplaytime_player_date_formatted%Shows the player's current playtime using the plugin's detailed formatter.
%fioplaytime_player_date_[format]%Shows the player's current playtime using a custom token format.
%fioplaytime_notification_state%Returns true or false for the player's notification preference.
%fioplaytime_bossbar_state%Returns true or false for the player's bossbar preference.

Custom format tokens

Custom placeholders start with player_date_.

Example:

%fioplaytime_player_date_dd:HH:mm:ss%

Supported tokens:

TokenMeaning
yyyyTotal years calculated from playtime days.
ddTotal days, padded to two digits.
HHHours in 24-hour style, padded to two digits.
hhHours in 12-hour style, padded to two digits.
mmMinutes, padded to two digits.
mmmMinutes, padded to two digits.
MMMMinutes, padded to two digits.
ssSeconds, padded to two digits.
aAM or PM based on the current hour value.

The bundled menus use placeholders such as:

lore:
- '<gray>Total Playtime:</gray> <white>%fioplaytime_player_date_formatted%</white>'
- '<gray>Notifications:</gray> <white>%fioplaytime_notification_state%</white>'
- '<gray>Bossbar:</gray> <white>%fioplaytime_bossbar_state%</white>'
Page note

PlaceholderAPI must be installed for external plugins to resolve %fioplaytime_*% placeholders. FioPlaytime also renders these values inside its own menus.