Placeholders

The PlaceholderAPI placeholders AscendSMP provides for showing abilities, cooldowns, and stats in other plugins.

If PlaceholderAPI is installed on your server, AscendSMP registers its ascend expansion automatically. PlaceholderAPI is a soft dependency: there is nothing to download separately for the expansion and nothing to configure. If PlaceholderAPI is not installed, the plugin simply runs without placeholders.

â„šī¸
You do not need to run any `/papi ecloud` download for this expansion. It ships inside AscendSMP and registers itself on startup whenever PlaceholderAPI is present.

Available placeholders

PlaceholderValue
%ascend_secondary%The equipped secondary's name, or None when nothing is equipped.
%ascend_secondary_level%The secondary's current level.
%ascend_secondary_cooldown%Time left on the secondary's cooldown; shows 0s when it is ready.
%ascend_primary%The equipped primary's name, or None when nothing is equipped.
%ascend_primary_level%The primary's current level.
%ascend_primary_cooldown%Time left on the primary's cooldown; shows 0s when it is ready.
%ascend_kills%The player's lifetime player kills.
%ascend_deaths%The player's lifetime deaths.

For what secondaries and primaries are and how they level up, see Abilities. The cooldown values match what the in-game HUD shows.

Example

Any plugin that supports PlaceholderAPI can display these. For example, a scoreboard or tab-list plugin could show a line like this:

Primary: %ascend_primary% (Lv %ascend_primary_level%) - %ascend_primary_cooldown%

For a player running Thunder at level 2 with 8 seconds of cooldown left, that renders as Primary: Thunder (Lv 2) - 8s. Once the cooldown ends it reads Primary: Thunder (Lv 2) - 0s.

Need help?

If a placeholder shows raw text instead of a value, make sure PlaceholderAPI is installed and both plugins loaded without errors. Still stuck? Ask on our Discord: discord.arrowtan.cc.