Skip to content
ClaimoClaimo

PlaceholderAPI

Claimo integrates with PlaceholderAPI in both directions — it consumes placeholders and provides its own.

Claimo consumes placeholders

Section titled “Claimo consumes placeholders”

With PlaceholderAPI installed:

  • In commands — any %placeholder% in a voucher’s cmd (beyond %player%) is resolved for the redeeming player, e.g. %player_uuid%, %vault_eco_balance%.
  • In the custom requirement — compare any PAPI value to a target with an operator. See Requirements → custom.

Claimo provides the claimo expansion

Section titled “Claimo provides the claimo expansion”

Claimo registers a claimo expansion so other plugins — scoreboards, holograms, GUIs — can read voucher state. Replace <id> with a code name.

Placeholder Value
%claimo_total_codes% Number of loaded codes
%claimo_uses_<id>% Total (global) redemptions of the code
%claimo_player_uses_<id>% Redemptions by the viewing player
%claimo_remaining_<id>% Redemptions left (per its limit mode), or unlimited
%claimo_limit_<id>% The code’s limit amount, or unlimited
%claimo_can_redeem_<id>% true/false — not expired and not exhausted for the player
%claimo_expired_<id>% true/false

Example

Section titled “Example”

Show a player how many times they can still redeem the welcome code on a scoreboard:

Welcome reward: %claimo_remaining_welcome% left