Placeholders

PlaceholderAPI values exposed by Rep Core and Rep Pro.

Rep registers a rep PlaceholderAPI expansion when PlaceholderAPI is installed.

Placeholders resolve against an online Player when possible. Rep also supports OfflinePlayer targets when that player’s data is already in the local cache (for example after they have joined the server or been loaded by an admin command). If data is not cached, placeholders return an empty string until the record is loaded.

Score placeholders

Placeholder	Description
%rep_score%	Score in raw or compact format, based on placeholders.score-format
%rep_score_raw%	Full integer score
%rep_score_compact%	Compact format (10k, 1.5m, etc.)
%rep_score_short%	Alias for %rep_score_compact%
%rep_score_formatted%	Alias for %rep_score_compact%

Rank placeholders

Placeholder	Description
%rep_rank%	Current rank display name
%rep_prefix%	Rank chat prefix with color codes

Rank values follow the score threshold rules in config.

Trust tier placeholders (Pro)

Available when Rep Pro is licensed and pro-settings.trust.trust-tiers-enabled is true.

Placeholder	Description
%rep_trust_tier%	Current trust tier display name
%rep_trust_tier_id%	Current trust tier config id

See Pro trust tiers.

Season placeholders (Pro)

Available when Rep Pro is licensed and pro-settings.seasons-enabled is true.

Placeholder	Description
%rep_season%	Active season display name
%rep_season_id%	Active season numeric ID
%rep_season_score%	Player’s score for the current season
%rep_season_rank%	Player’s rank position on the current season leaderboard

See Pro seasons for season lifecycle and commands.

Compact formatting

When placeholders.score-format is compact, or when using %rep_score_compact%, Rep uses the placeholders.compact section:

plugins/Rep/config.yml

placeholders:
  score-format: raw
  compact:
    enabled: true
    min-value: 1000
    decimal-places: 1
    strip-trailing-zeros: true
    suffixes:
      thousand: k
      million: m

placeholders.compact.thresholds only controls when numbers switch to k/m/b style — it does not affect rank tiers.

Test placeholders

/papi parse me %rep_score%
/papi parse me %rep_score_raw%
/papi parse me %rep_rank%
/papi parse me %rep_prefix%

For Pro season placeholders:

/papi parse me %rep_season%
/papi parse me %rep_season_score%

Common uses

• Scoreboard plugins: %rep_score% or %rep_score_compact%
• Chat format plugins: %rep_prefix% before the player name
• Tab list plugins: %rep_rank% next to the player name
• InteractiveChat player hover: %rep_score% and %rep_rank% — see Integrations