Skip to content

Reference

Placeholders

Every DeluxeCombat placeholder for PlaceholderAPI, plus sign and hologram leaderboards.

DeluxeCombat registers the PlaceholderAPI expansion deluxecombat automatically when PlaceholderAPI is installed — no /papi ecloud download needed. Check /dc-addon list to confirm the hook is active.

Player placeholders

All placeholders below require a player context.

Combat

Placeholder Output
%deluxecombat_in_combat% Whether the player is in combat — true / false
%deluxecombat_combat_time% Remaining combat time in seconds
%deluxecombat_combat_opponent% Name of the current combat opponent
%deluxecombat_combat_mode% PvP or PvE
%deluxecombat_has_pvp_enabled% Whether the player has PvP enabled — true / false
%deluxecombat_has_protection% Whether the player has an active PvP protection — true / false
%deluxecombat_protection_time_remaining% Remaining protection time as a time string (e.g. 5m 10s)

Tip: The true / false outputs can be replaced with custom text (e.g. &aYes / &cNo): enable custom placeholder replacements in the settings editor and edit the placeholder-messages section of your language file.

Bounties

Placeholder Output
%deluxecombat_has_bounty% Whether the player has a bounty — true / false
%deluxecombat_bounty_value% Value of the bounty on the player
%deluxecombat_bounty_initiator% Name of the bounty initiator
%deluxecombat_bounty_prefix% The bounty prefix, if the player has a bounty

Item cooldowns

Placeholder Output
%deluxecombat_item_cooldown% Cooldown in seconds of the item the player is holding
%deluxecombat_item_cooldown_ender_pearl% Ender pearl cooldown in seconds
%deluxecombat_item_cooldown_chorus_fruit% Chorus fruit cooldown
%deluxecombat_item_cooldown_totem_of_undying% Totem of Undying cooldown
%deluxecombat_item_cooldown_golden_apple% Gold apple cooldown
%deluxecombat_item_cooldown_enchanted_golden_apple% God apple cooldown
%deluxecombat_item_cooldown_elytra% Elytra cooldown
%deluxecombat_item_cooldown_tnt% TNT cooldown
%deluxecombat_item_cooldown_trident% Trident cooldown

Rankings

Placeholder Output
%deluxecombat_ranking_kills% The player's kills
%deluxecombat_ranking_deaths% The player's deaths
%deluxecombat_ranking_kd% The player's K/D ratio
%deluxecombat_ranking_combatlogs% The player's combat logs
%deluxecombat_ranking_points% The player's points
%deluxecombat_ranking_streak% The player's current kill streak
%deluxecombat_ranking_maxstreak% The player's highest kill streak
%deluxecombat_ranking_rank% The player's current rank

Leaderboard placeholders

Leaderboard placeholders display the best players on the server and don't depend on the viewing player:

%deluxecombat_ranking_<STATSTYPE>_<RANK>%
  • <STATSTYPE> — one of KILLS, DEATHS, POINTS, COMBATLOGS, KD, STREAK, MAXSTREAK
  • <RANK> — the rank to display (1 = best player)

Note: The highest rank you can display is limited by the leaderboard pull-limit (configured in the Point-Ranking-System menu / the Storage.Leaderboard section of config.yml). Higher ranks won't be parsed.

Data groups

If you use multiple data groups, append the group name to target a specific group:

%deluxecombat_ranking_<STATSTYPE>_<RANK>_<GROUP>%

List available groups with /dc group list.

Raw values

By default a leaderboard placeholder returns the full formatted line from your language file. Append a specifier to get one raw field instead:

%deluxecombat_ranking_<STATSTYPE>_<RANK>_<GROUP>_<SPECIFIER>%

Valid specifiers: player, rank, value, group, amount.

MVdWPlaceholderAPI

If you use MVdWPlaceholderAPI instead of PlaceholderAPI, wrap any placeholder above like this:

{placeholderapi_<placeholder>}

Sign leaderboards

Sign leaderboards need no extra plugins. Place a sign and write:

  1. [DC]
  2. {STATSTYPE} — one of KILLS, DEATHS, POINTS, COMBATLOGS, STREAK, MAXSTREAK
  3. {RANK} — the rank to display
  4. (leave empty)

/dc create sign shows this tutorial in-game.

Hologram leaderboards

To build a hologram leaderboard you need:

  • PlaceholderAPI installed
  • A hologram plugin that supports PlaceholderAPI placeholders
  • The point-ranking system enabled

Create a hologram line containing a leaderboard placeholder, e.g.:

%deluxecombat_ranking_KILLS_1%

Tip: If the hologram doesn't update or shows question marks, see the FAQ — it's usually the update interval or stats that haven't been saved yet.