Skip to content

PlaceholderAPI

Jump to bottom
ItsNotSkyeZ edited this page Jul 20, 2026 · 6 revisions

PlaceholderAPI

EndlessCoinflip supports PlaceholderAPI for use in scoreboards, holograms, chat formats and any other plugin that supports PAPI placeholders.

PlaceholderAPI must be installed on your server for these to work — no expansion download is required, it registers automatically when the plugin loads.

Per-Player Placeholders

These return stats for the player viewing the placeholder.

Placeholder Returns
%coinflip_wins% Win count
%coinflip_losses% Loss count
%coinflip_total_wagered% Total amount wagered
%coinflip_total_won% Total amount won
%coinflip_biggest_win% Biggest single win
%coinflip_biggest_loss% Biggest single loss
%coinflip_ratio% Win:loss ratio
%coinflip_rank% Leaderboard position (based on leaderboard.sort-by in config)
%coinflip_streak% Current win streak
%coinflip_best_streak% Best win streak ever

Leaderboard Placeholders

These return data from a specific leaderboard position.

Format

%coinflip_top_<stat>_<position>%
%coinflip_top_<stat>_<position>_<field>%
  • stat — which leaderboard to rank by
  • position — 1, 2, 3... (1st place, 2nd place, etc.)
  • field — what to display (leave off to return the player's name)

Available Stats

Stat Ranks players by
wins Most wins
losses Most losses
total_wagered Most money wagered
total_won Most money won
biggest_win Biggest single win
biggest_loss Biggest single loss
streak Current win streak

Available Fields

Field Returns
name Player's name (default if field is omitted)
wins Win count
losses Loss count
total_wagered Total wagered
total_won Total won
biggest_win Biggest single win
biggest_loss Biggest single loss
ratio Win:loss ratio
streak Current win streak
best_streak Best win streak ever

Examples

Top winners board — name, wins and total won:

%coinflip_top_wins_1_name% - %coinflip_top_wins_1_wins% wins - %coinflip_top_wins_1_total_won% won
%coinflip_top_wins_2_name% - %coinflip_top_wins_2_wins% wins - %coinflip_top_wins_2_total_won% won
%coinflip_top_wins_3_name% - %coinflip_top_wins_3_wins% wins - %coinflip_top_wins_3_total_won% won

Top losers board — name, losses and biggest loss:

%coinflip_top_losses_1_name% - %coinflip_top_losses_1_losses% losses - %coinflip_top_losses_1_biggest_loss% biggest loss
%coinflip_top_losses_2_name% - %coinflip_top_losses_2_losses% losses - %coinflip_top_losses_2_biggest_loss% biggest loss

Names only — simplest possible:

%coinflip_top_wins_1%
%coinflip_top_wins_2%
%coinflip_top_wins_3%

Clone this wiki locally