Skip to content

PlaceholderAPI

j-gaertig-co-dev edited this page Aug 13, 2026 · 1 revision

PlaceholderAPI Support

  • Optional soft dependency — PlainBase works fully without PlaceholderAPI installed. If it's missing, PlainBase simply never registers an expansion and moves on; no errors, no missing functionality outside of the placeholders themselves.
  • If PlaceholderAPI is installed, the %plainbase_*% expansion is registered automatically on startup. The bridge code isolates PlaceholderAPI's classloading so a PAPI failure can never crash PlainBase itself.
  • Placeholders are resolved wherever PlainBase renders MiniMessage text that also passes through PAPI: menu titles, item names/lore, and other configurable messages.

Available placeholders

Placeholder Description
%plainbase_version% The currently installed PlainBase version.
%plainbase_vanished% Whether the player is currently vanished (true/false).
%plainbase_moderation_bancount% How many times the player has ever been banned (from the Moderation module).
%plainbase_moderation_kickcount% How many times the player has ever been kicked.
%plainbase_moderation_banned% Whether the player currently has an active ban (true/false).

You can of course also use any other plugin's PlaceholderAPI placeholders (e.g. %player_name%, Vault/economy placeholders, ...) anywhere PlainBase resolves PAPI placeholders — most notably inside Menu configs.

Clone this wiki locally