Skip to content

Placeholders

TheGaBr0 edited this page May 4, 2026 · 20 revisions

Placeholders — Overview

PlaytimeManager exposes placeholders through PlaceholderAPI.


Categories

Page Description
Playtime Total and AFK playtime for the current player or by nickname, with optional time unit conversion
Player Info First join date and last seen data for the current player or by nickname
Leaderboard Playtime, username, last seen, and LuckPerms prefix for players ranked by playtime; also exposes the current player's rank
Join Streaks Absolute and relative join streaks, plus streak reward state and metadata
Goals Goal completion count and per-goal completion status for the current player or by nickname

Datetime format

You can format the datetime information displayed by the placeholders by modifying the field datetime-format in the main config.yml file.

Available time units

You can replace # in placeholders with one of the following options:

  • s -> seconds
  • m -> minutes
  • h -> hours
  • d -> days
  • w -> weeks
  • mo -> months (by default a month is equal to 30 days, you can configure this option in config.yml)
  • y -> years
  • mc -> minecraft days (a day in minecraft is equal to 20 minutes of playtime)

Error messages

Error messages are disabled by default. To enable them, set enable-errors: true under the placeholders field in config.yml.

placeholders:
  enable-errors: true

Clone this wiki locally