Skip to content

Placeholders

Reece Williams edited this page Sep 2, 2026 · 2 revisions

Placeholders

ServerTools adds these PlaceholderAPI placeholders you can drop into any PAPI-aware plugin (scoreboards, tab, holograms, etc). They only work if you have PlaceholderAPI installed.

Needs: PlaceholderAPI (these only work when it's installed).

The placeholders

Placeholder Returns
%stools_isvisible% true or false - whether the player is hidden via /visibility
%stools_age_<EPOCHTIME>% A formatted time since/until a given epoch timestamp. See below.
%stools_commandspy% on or off - whether the player has command spy on
%stools_chatcolor% The player's selected chat color code (like &e)
%stools_staffafk% true or false - whether the player is AFK as staff

If you type a placeholder that doesn't exist, you'll get back STOOLS-PAPI-ERROR. That usually means a typo.

About %stools_age_<EPOCHTIME>%

Put a Unix epoch time (in seconds) where <EPOCHTIME> is, and it shows how long ago that was, or how long until then. Need an epoch value? Grab one from https://www.epochconverter.com.

%stools_age_1622318400%  ->  "4y 32d 1h ..."

Using other plugins' placeholders in ServerTools

You can also use other plugins' PlaceholderAPI placeholders inside ServerTools messages. This works in:

  • the join MOTD
  • holograms
  • fancy announcements
  • server-info commands
  • chat format (this one needs Chat.ChatFormat.EnabledPAPIinMessages: true)
Chat:
  ChatFormat:
    EnabledPAPIinMessages: true

Clone this wiki locally