Placeholder Reference
PlaceholderAPI Placeholders
Expansion identifier: emakiattribute
When PlaceholderAPI is installed, EmakiAttribute automatically registers a placeholder expansion exposing player stats and resources to scoreboards, chat, menus, holograms, and other plugins.
All placeholders use the format %emakiattribute_<key>%.
Attribute Value Placeholders
Basic Format
text
%emakiattribute_<attribute_id>%Returns the player's current combat snapshot value for the attribute, formatted to at most 2 decimal places (e.g., 15.5, 100). Returns 0 if the attribute does not exist.
Examples
| Placeholder | Description |
|---|---|
%emakiattribute_physical_attack% | Physical attack |
%emakiattribute_physical_defense% | Physical defense |
%emakiattribute_physical_crit_rate% | Physical crit rate |
%emakiattribute_physical_crit_damage% | Physical crit damage |
%emakiattribute_spell_attack% | Spell attack |
%emakiattribute_dodge_rate% | Dodge rate |
%emakiattribute_lifesteal% | Lifesteal ratio |
Power Placeholder
text
%emakiattribute_power%Returns the player's total attribute power (calculated from each attribute's attribute_power weight).
Resource Placeholders
Basic Format
text
%emakiattribute_resource_<resource_id>%
%emakiattribute_resource_<resource_id>_<field>%Without a field, defaults to current.
Available Fields
| Field | Description | Example |
|---|---|---|
current | Current value (default). | 85 |
max | Current maximum (including bonuses). | 120 |
default | Default maximum (without bonuses). | 100 |
bonus | Bonus maximum. | 20 |
percent | Current value as percentage of max (0–100). | 70 |
Examples
| Placeholder | Description |
|---|---|
%emakiattribute_resource_health% | Current health |
%emakiattribute_resource_health_max% | Max health |
%emakiattribute_resource_health_percent% | Health percentage |
%emakiattribute_resource_mana% | Current mana |
%emakiattribute_resource_mana_max% | Max mana |
%emakiattribute_resource_mana_percent% | Mana percentage |
Common Usage
Scoreboard
yaml
lines:
- '&c❤ %emakiattribute_resource_health%/%emakiattribute_resource_health_max%'
- '&b✦ %emakiattribute_resource_mana%/%emakiattribute_resource_mana_max%'
- '&e⚔ Attack: %emakiattribute_physical_attack%'
- '&a🛡 Defense: %emakiattribute_physical_defense%'Condition System
Use PAPI placeholders in CoreLib condition expressions:
yaml
conditions:
- '%emakiattribute_physical_attack% >= 100'
- '%emakiattribute_resource_mana_percent% >= 50'Skill Thresholds
Check attributes in EmakiSkills conditions:
yaml
conditions:
- '%emakiattribute_physical_attack% >= 200'Display Tips
- Use consistent formatting for percentage attributes (e.g., 1 decimal place).
- Display resources in
current / maxformat. - Avoid placing too many complex placeholders in high-frequency refresh scenarios (ActionBar, BossBar).
- Separate player-facing placeholders from admin debug placeholders.
- Placeholder values are numeric strings without color codes, suitable for direct numeric comparison.