# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://arcaneplugins.gitbook.io/levelledmobs-the-ultimate-mob-levelling-solution/levelledmobs-v4.0/placeholders.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
