PlaceholdersAPI

PlaceholderAPI Placeholders

CrisStealCore includes built-in PlaceholderAPI support! These placeholders allow you to display player stats, hearts, coins, cooldowns, and active events anywhere — such as in Scoreboards, TAB, Holograms, Menus, or Messages.

⚙️ General Information

Key	Description
Identifier:	criscore
Example usage:	%criscore_hearts%
Config file:	placeholders.yml

❤️ Hearts Placeholders

Placeholder	Description	Example Output
%criscore_hearts%	Shows the player’s hearts formatted from placeholders.yml. Default: &c20 ❤	❤ 20
%criscore_hearts_raw%	Shows only the numeric heart amount.	20

Config format example (placeholders.yml):

hearts:
  formatted: "&c%hearts% ❤"

⚔️ Player Stats Placeholders

Placeholder	Description	Example Output
%criscore_kills%	Total player kills.	15
%criscore_deaths%	Total player deaths.	3
%criscore_stolen%	Total stolen hearts.	8
%criscore_lost%	Total lost hearts.	2
%criscore_kd_ratio%	K/D ratio, 2 decimals.	5.00
%criscore_kd_ratio_formatted%	K/D ratio with color and prefix from config.	&7K/D: &f5.00 → K/D: 5.00

Config example (placeholders.yml):

stats:
  kd_ratio: "&7K/D: &f%ratio%"

💰 Currency Placeholders

Placeholder	Description	Example Output
%criscore_coins%	Player’s formatted balance (using plugin’s coins system).	1,250⛁
%criscore_coins_raw%	Raw numeric balance.	1250.0
%criscore_coins_formatted%	Formatted using placeholders.yml format.	&6%amount% ⛁ → 1,250 ⛁

Config example (placeholders.yml):

balance:
  formatted: "&6%amount% ⛁"

⏳ Cooldown Placeholders

Placeholder	Description	Example Output
%criscore_cooldown_<item_id>%	Displays the remaining cooldown time for a specific item.	1h 25m 30s or Ready
%criscore_debug_cooldown%	Shows all available item IDs for debugging.	heart_1, heart_2, heart_3
%criscore_debug_cooldown_<item_id>%	Shows raw cooldown debug info for that item.	`Item: heart_1
%criscore_test_format%	Tests the cooldown format setting from placeholders.yml.	Format: %hours%h:%minutes%m:%seconds%s → 2h:30m:45s

Config example (placeholders.yml):

cooldown:
  format: "%hours%h:%minutes%m:%seconds%s"

💡 Smart display:

• Shows Ready if no cooldown.

• Automatically hides unused units (e.g., shows only 45s if less than a minute).

🎉 Event Placeholders

Placeholder	Description	Example Output
%criscore_active_event%	Lists all currently active events.	Halloween, DoubleHearts
%criscore_active_event_count%	Number of active events.	2
%criscore_event_time_<eventName>%	Remaining time for a specific event.	05:32
%criscore_event_active_<eventName>%	Whether an event is currently active (Yes / No).	Yes

🧠 Utility / Admin Placeholders

Placeholder	Description	Example Output
%criscore_reload_config%	Reloads the placeholders.yml file dynamically. (Admin only)	Placeholders config reloaded!

🧾 Example: Using in a scoreboard

scoreboard:
  title: "&c&lCrisStealCore"
  lines:
    - "&f❤ Hearts: &c%criscore_hearts%"
    - "&f💀 Deaths: &7%criscore_deaths%"
    - "&f⚔️ Kills: &7%criscore_kills%"
    - "&f- Coins: &6%criscore_coins%"
    - "&fK/D Ratio: &7%criscore_kd_ratio_formatted%"
    - "&fCooldown: &a%criscore_cooldown_heart_1%"

---

🧩 Example: Using in a hologram

- "&c❤ &f%criscore_hearts%"
- "&7Kills: &f%criscore_kills%"
- "&7Active Event: &e%criscore_active_event%"

🧙 Tips

• You can edit all color formats and symbols from placeholders.yml.

• Placeholders automatically support both Vault and CrisStealCore Coins.

• cooldown_<item_id> supports any item ID from your items/ folder.

• For events, make sure your event name matches exactly (lowercase or same format as in config).