Placeholders - GashiStudios

Requirements

Text Placeholder API (mod)
CobbleRanked 2.0+

Note: On pure Fabric, CobbleRanked uses Text Placeholder API (the Fabric equivalent of PAPI).

On Arclight servers, CobbleRanked also registers a native PlaceholderAPI (PAPI) expansion — see PlaceholderAPI on Arclight below.

⚠️ HoloDisplays Compatibility

HoloDisplays v0.26+ requires colon format for placeholders.

Correct:

"lines": [
  "§eELO: %cobbleranked:singles_elo%"
]

Incorrect (will not work):

"lines": [
  "§eELO: %cobbleranked_singles_elo%"  // Missing colon
]

All placeholders must use the format: %cobbleranked:<namespace>_<value>%

Player Stats

Stats are available per format: singles, doubles, triples.

Placeholder	Description
`%cobbleranked:<format>_elo%`	Player’s Elo rating
`%cobbleranked:<format>_rank%`	Player’s rank position
`%cobbleranked:<format>_wins%`	Total wins
`%cobbleranked:<format>_losses%`	Total losses
`%cobbleranked:<format>_games%`	Total games played
`%cobbleranked:<format>_winrate%`	Win percentage (e.g., `75.0%`)
`%cobbleranked:<format>_tier%`	Tier name (e.g., `Poke Ball`, `Great Ball`)

Examples

Placeholder	Description
`%cobbleranked:singles_elo%`	Singles Elo
`%cobbleranked:doubles_wins%`	Doubles wins
`%cobbleranked:triples_tier%`	Triples tier

Season Info

Placeholder	Description
`%cobbleranked:season_name%`	Current season name
`%cobbleranked:season_status%`	`active` or `ended`
`%cobbleranked:season_remaining%`	Formatted time (e.g., `5 days`)
`%cobbleranked:season_remaining_short%`	Short format (e.g., `5d`)
`%cobbleranked:season_remaining_days%`	Days remaining
`%cobbleranked:season_remaining_hours%`	Hours remaining (0-23)
`%cobbleranked:season_remaining_minutes%`	Minutes remaining (0-59)
`%cobbleranked:season_end_date%`	End date (`yyyy-MM-dd`)

Top Players

Leaderboard placeholders for ranks 1-10 (the plugin registers placeholders for the top 10 of each format; higher ranks resolve to -).

Default (Singles)

Placeholder	Description
`%cobbleranked:top_<rank>_name%`	Player name
`%cobbleranked:top_<rank>_elo%`	Elo rating
`%cobbleranked:top_<rank>_wins%`	Wins
`%cobbleranked:top_<rank>_losses%`	Losses
`%cobbleranked:top_<rank>_games%`	Total games
`%cobbleranked:top_<rank>_winrate%`	Win percentage

Format-Specific

Placeholder	Description
`%cobbleranked:top_singles_<rank>_<field>%`	Singles leaderboard
`%cobbleranked:top_doubles_<rank>_<field>%`	Doubles leaderboard
`%cobbleranked:top_triples_<rank>_<field>%`	Triples leaderboard

Top Player Examples

Placeholder	Description
`%cobbleranked:top_1_name%`	#1 Singles player name
`%cobbleranked:top_3_elo%`	#3 Singles Elo
`%cobbleranked:top_doubles_1_name%`	#1 Doubles player name
`%cobbleranked:top_triples_5_winrate%`	#5 Triples winrate

Usage Examples

Scoreboard

ELO: %cobbleranked:singles_elo%
Rank: #%cobbleranked:singles_rank%
W/L: %cobbleranked:singles_wins%/%cobbleranked:singles_losses%

Tab List

[%cobbleranked:singles_elo% ELO] %player%

Leaderboard Display

#1 %cobbleranked:top_1_name% - %cobbleranked:top_1_elo% ELO
#2 %cobbleranked:top_2_name% - %cobbleranked:top_2_elo% ELO
#3 %cobbleranked:top_3_name% - %cobbleranked:top_3_elo% ELO

PlaceholderAPI on Arclight

On Arclight (Bukkit-hybrid) servers with the PlaceholderAPI plugin installed, CobbleRanked automatically registers a native PAPI expansion — no extra setup, no ecloud download. Bukkit-side plugins (scoreboards, chat, holograms, tab plugins) can then use CobbleRanked stats with the standard PAPI underscore format:

%cobbleranked_singles_elo%
%cobbleranked_doubles_winrate%
%cobbleranked_season_name%

Placeholder	Description
`%cobbleranked_<format>_elo%`	Elo rating (`singles` / `doubles` / `triples`)
`%cobbleranked_<format>_rank%`	Leaderboard position
`%cobbleranked_<format>_wins%`	Total wins
`%cobbleranked_<format>_losses%`	Total losses
`%cobbleranked_<format>_games%`	Total games (alias: `_matches`)
`%cobbleranked_<format>_winrate%`	Win percentage (e.g. `75%`)
`%cobbleranked_<format>_tier%`	Tier name (e.g. `ULTRABALL`)
`%cobbleranked_season_name%`	Current season name
`%cobbleranked_in_queue%`	`true` / `false`
`%cobbleranked_in_match%`	`true` / `false`

📝 The PAPI expansion covers player stats and season basics. Top-10 leaderboard placeholders are Fabric-side (Text Placeholder API) only.

Cache

Placeholders are cached for 60 seconds for performance. Clear cache if needed:

/rankedadmin placeholder clear

Without Placeholder API

If Text Placeholder API is not installed, placeholders won’t work in external mods. Internal GUI placeholders still function normally.