# Placeholders

Internal vs External-Use Placeholders

We produce many different types of placeholders. Some are limited to specific settings; some are only designed to be used in one specific scenario; some can be used anywhere.

**Internal-Use** placeholders are designed to only be used within the LevelledMobs4 plugin.

**External-Use** placeholders are designed to function with the 3rd party plugin [**PlaceholderAPI**](https://www.spigotmc.org/resources/placeholderapi.6245/) **\[PAPI]**, so to be extended to other plugins.

## Internal-Use Only

<table data-full-width="true"><thead><tr><th width="230" align="center">Misc Placeholder</th><th width="282" align="center">Usage</th><th>Description</th></tr></thead><tbody><tr><td align="center"><code>%displayname%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code></td><td>Mob's <code>customname</code> field, or it's sanitized and cleaned <code>EntityType</code>.</td></tr><tr><td align="center"><code>%death-nametag%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code></td><td>Mob's established death name from <code>creature-death-nametag</code> <code>setting</code>. </td></tr><tr><td align="center"><code>%health-indicator%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code></td><td>Health represented by <code>health-indicator</code> <code>setting</code>. </td></tr><tr><td align="center"><code>%health-indicator-color%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code></td><td>Color represented by <code>health-indicator</code> <code>setting</code> output.</td></tr><tr><td align="center"><code>%mob-lvl%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code></td><td>The current level assigned to the mob.</td></tr><tr><td align="center"><code>%min-level%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code></td><td>The current minimum level assigned to the mob.</td></tr><tr><td align="center"><code>%max-level%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code></td><td>The current maximum level assigned to the mob.</td></tr><tr><td align="center"><code>%level-ratio%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code></td><td>The current ratio of the level in comparison to the max and min level, from 0.0 to 1.0 . The value is calculated using the following formula:<br><code>(current-level - minLevel) ÷ (maxLevel - minLevel)</code><br>As well, if the right half of the calculation turns out to be zero, meaning the min and max level are the same, then the entity will be given a ratio of <code>1</code>. Then, if the left half of the calculation is zero, meaning the mobs current level is the minimum, then the ratio will be <code>0</code>.</td></tr><tr><td align="center"><code>%entity-name%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code></td><td>The sanitized and cleaned <code>EntityType</code> of the mob.</td></tr><tr><td align="center"><code>%entity-name-raw%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code></td><td>The <code>EntityType</code> of the mob.</td></tr><tr><td align="center"><code>%entity-health%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code>, <code>construct-level</code></td><td>The exact health of the mob rounded to hundredth place.</td></tr><tr><td align="center"><code>%entity-health-rounded%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code>, <code>construct-level</code></td><td>The health of the mob rounded to the nearest whole number.</td></tr><tr><td align="center"><code>%entity-health-rounded-up%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code>, <code>construct-level</code></td><td>The current amount of health of the mob rounded to the next whole number. For example, a health of 5.05 would round to 6 health.</td></tr><tr><td align="center"><code>%entity-max-health%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code>, <code>construct-level</code></td><td>The exact maximum amount of health of the mob rounded to hundredths place.</td></tr><tr><td align="center"><code>%entity-max-health-rounded%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code>, <code>construct-level</code></td><td>The maximum amount of health of the mob rounded to the nearest whole number. For example, 5.35 would round to 5; while 5.65 would round to 6.</td></tr><tr><td align="center"><code>%entity-max-health-rounded-up%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code>, <code>construct-level</code></td><td>The maximum amount of health of the mob rounded to the next whole number. For example, a health of 5.05 would round to 6 health.</td></tr><tr><td align="center"><code>%entity-max-health-percent%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code>, <code>construct-level</code></td><td>The maximum amount of health of the mob, set as a percentage. Essentially always outputs 100% as the max health as a percentage should always be 100%. </td></tr><tr><td align="center"><code>%entity-max-health-percent-X%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code>, <code>strategies</code>, <code>modifiers</code>, <code>attribute-modifier</code>, <code>construct-level</code></td><td>The health of the mob represented as a percentage, rounded ot the nearest specified decimal place.<br>For example, <code>%entity-max-health-percent-3%</code> might output <code>25.000%</code> </td></tr><tr><td align="center"><code>%heart-symbol%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code></td><td>The symbol: ♥ .</td></tr><tr><td align="center"><code>%tiered%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code></td><td>The effective color output from <code>tiered-coloring</code> <code>setting</code>.</td></tr><tr><td align="center"><code>%wg-region%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code></td><td>The WorldGuard region name gathered at mob processing.</td></tr><tr><td align="center"><code>%world%</code></td><td align="center"><code>nametag</code>, <code>creature-death-nametag</code>, <code>death-messages</code></td><td>The Minecraft world name.</td></tr><tr><td align="center"><code>%player%</code></td><td align="center"><code>custom-drops</code></td><td>The name of the player who killed the mob.</td></tr><tr><td align="center"><code>%player-uuid%</code></td><td align="center"><code>custom-drops</code></td><td>The unique UUID of the player who killed the mob.</td></tr><tr><td align="center"><code>%location%</code></td><td align="center"><code>custom-drops</code></td><td>The coordinates of the location of the mob's death.</td></tr><tr><td align="center"><code>%mob-scale%</code></td><td align="center"><code>custom-drops</code></td><td>This outputs the computed value for <code>mob-scale:</code> as defined per item in <code>customdrops.yml</code>. This value is equal to <code>mob-scale x level</code>. </td></tr><tr><td align="center"></td><td align="center"></td><td></td></tr><tr><td align="center"></td><td align="center"></td><td></td></tr><tr><td align="center"><strong>Strategy &#x26; Modifier Placeholders</strong></td><td align="center"><strong>Usage</strong></td><td><strong>Description</strong></td></tr><tr><td align="center"><code>%weighted-random%</code></td><td align="center"><code>strategy</code>, <code>weighted-random</code>, <code>construct-level</code></td><td>Associated with the output value from <code>weighted-random</code> <code>strategies</code>.</td></tr><tr><td align="center"><code>%distance-from-origin%</code></td><td align="center"><code>strategy</code>, <code>distance-from-origin</code>, <code>construct-level</code></td><td>Associated with the output value from <code>distance-from-origin</code> <code>strategies</code>.</td></tr><tr><td align="center"><code>%y-coordinate%</code></td><td align="center"><code>strategy</code>, <code>y-coordinate</code>, <code>construct-level</code></td><td>Associated with the output value from <code>y-coordinate</code> <code>strategies</code>.</td></tr><tr><td align="center"><code>%player-variable-mod%</code></td><td align="center"><code>modifier</code>, <code>player-variable-modifier</code>, <code>construct-level</code></td><td>Associated with the output of the value from <code>player-variable-modifier</code> <code>modifiers</code>.</td></tr><tr><td align="center"><code>%custom_name%</code></td><td align="center"><code>modifier</code>, <code>custom</code>, <code>construct-level</code></td><td>Associated with the output value from any <code>custom</code> <code>modifiers</code>. You can perform multiple instances separated by <code>_name</code>, where this is the unique name associated with the instance.</td></tr><tr><td align="center"><code>%rand_X_Y%</code></td><td align="center"><code>modifier</code>, <code>random-variance-modifier</code>, <code>construct-level</code></td><td>Generates a random number between two specified values. Supports negative numbers. You can also use up to 100 of these custom placeholders in the file.<br>Sample: <code>%rand_-5_5%</code> means between -5 and 5</td></tr><tr><td align="center"></td><td align="center"></td><td></td></tr><tr><td align="center"></td><td align="center"></td><td></td></tr><tr><td align="center"><strong>Player Level Modifier Placeholders</strong></td><td align="center"><strong>Usage</strong></td><td><strong>Description</strong></td></tr><tr><td align="center"><code>%level%</code></td><td align="center"><code>player-level-mod</code></td><td>The Minecraft level associated with the player closest to the mob.</td></tr><tr><td align="center"><code>%exp%</code></td><td align="center"><code>player-level-mod</code></td><td>The Minecraft experience points remaining until the player closest to the mob will level up, represented as the percentage remaining between <code>0.0</code> and <code>1.0</code>.</td></tr><tr><td align="center"><code>%exp-to-level%</code></td><td align="center"><code>player-level-mod</code></td><td>The Minecraft experience points remaining until the player closest to the mob will level up.</td></tr><tr><td align="center"><code>%total-exp%</code></td><td align="center"><code>player-level-mod</code></td><td>The total Minecraft experience points the player closest to the mob has collected.</td></tr><tr><td align="center"><code>%world-time-tick%</code></td><td align="center"><code>player-level-mod</code></td><td>The current time of day in game as represented in <code>ticks</code> from <code>0</code> to <code>24000</code>.</td></tr><tr><td align="center"></td><td align="center"></td><td></td></tr><tr><td align="center"></td><td align="center"></td><td></td></tr><tr><td align="center"><strong>Attribute Modifier Placeholders</strong></td><td align="center"><strong>Usage</strong></td><td><strong>Description</strong></td></tr><tr><td align="center"><code>%max-health%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>max-health</code> attribute, before alterations.</td></tr><tr><td align="center"><code>%movement-speed%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>movement-speed</code> attribute, before alterations.</td></tr><tr><td align="center"><code>%attack-damage%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>attack-damage</code> attribute, before alterations.</td></tr><tr><td align="center"><code>%ranged-attack-damage%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>ranged-attack-damage</code> attribute, before alterations.</td></tr><tr><td align="center"><code>%creeper-blast-damage%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>creeper-blast-damage</code> attribute, before alterations.</td></tr><tr><td align="center"><code>%follow-range%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>follow-range</code> attribute, before alterations.</td></tr><tr><td align="center"><code>%item-drop%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the value of the amount of an item being dropped, before alterations.</td></tr><tr><td align="center"><code>%xp-drop%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the value of the amount of experience points being dropped, before alterations.</td></tr><tr><td align="center"><code>%armor-bonus%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>armor-bonus</code> attribute, before alterations.</td></tr><tr><td align="center"><code>%armor-toughness%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>armor-toughness</code> attribute, before alterations.</td></tr><tr><td align="center"><code>%attack-knockback%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>attack-knockback</code> attribute, before alterations.</td></tr><tr><td align="center"><code>%knockback-resistance%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>knockback-resistance</code> attribute, before alterations.</td></tr><tr><td align="center"><code>%zombie-spawn-reinforcements%</code></td><td align="center"><code>attribute-modifier</code></td><td>Outputs the default value of the mobs' <code>zombie-spawn-reinforcements</code> attribute, before alterations.</td></tr><tr><td align="center"></td><td align="center"></td><td></td></tr></tbody></table>

## External-Use Placeholders (Requires PAPI)

<table data-full-width="true"><thead><tr><th width="230" align="center">Misc Placeholder</th><th width="282" align="center">Usage</th><th>Description</th></tr></thead><tbody><tr><td align="center"><code>%levelledmobs_mob-target%</code></td><td align="center"><code>PAPI</code></td><td>The nametag value of the mob who is under crosshairs (being looked at) in-game of the player.</td></tr><tr><td align="center"><code>%levelledmobs_displayname%</code></td><td align="center"><code>PAPI</code></td><td>The <code>%displayname%</code> output of the mob which was last killed by the player.</td></tr><tr><td align="center"><code>%levelledmobs_mob-lvl%</code></td><td align="center"><code>PAPI</code></td><td>The level of the mob last killed by the player.</td></tr><tr><td align="center"><code>%levelledmobs_killed-by%</code></td><td align="center"><code>PAPI</code></td><td>The <code>%displayname%</code> output of the mob which last killed the player.</td></tr><tr><td align="center"></td><td align="center"></td><td></td></tr></tbody></table>
