🪨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 [PAPI], so to be extended to other plugins.
Internal-Use Only
%displayname%
nametag, creature-death-nametag, death-messages
Mob's customname field, or it's sanitized and cleaned EntityType.
%death-nametag%
nametag, creature-death-nametag, death-messages
Mob's established death name from creature-death-nametag setting.
%health-indicator%
nametag, creature-death-nametag, death-messages
Health represented by health-indicator setting.
%health-indicator-color%
nametag, creature-death-nametag, death-messages
Color represented by health-indicator setting output.
%mob-lvl%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier
The current level assigned to the mob.
%min-level%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier
The current minimum level assigned to the mob.
%max-level%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier
The current maximum level assigned to the mob.
%level-ratio%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier
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:
(current-level - minLevel) ÷ (maxLevel - minLevel)
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 1. Then, if the left half of the calculation is zero, meaning the mobs current level is the minimum, then the ratio will be 0.
%entity-name%
nametag, creature-death-nametag, death-messages
The sanitized and cleaned EntityType of the mob.
%entity-name-raw%
nametag, creature-death-nametag, death-messages
The EntityType of the mob.
%entity-health%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier, construct-level
The exact health of the mob rounded to hundredth place.
%entity-health-rounded%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier, construct-level
The health of the mob rounded to the nearest whole number.
%entity-health-rounded-up%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier, construct-level
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.
%entity-max-health%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier, construct-level
The exact maximum amount of health of the mob rounded to hundredths place.
%entity-max-health-rounded%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier, construct-level
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.
%entity-max-health-rounded-up%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier, construct-level
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.
%entity-max-health-percent%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier, construct-level
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%.
%entity-max-health-percent-X%
nametag, creature-death-nametag, death-messages, strategies, modifiers, attribute-modifier, construct-level
The health of the mob represented as a percentage, rounded ot the nearest specified decimal place.
For example, %entity-max-health-percent-3% might output 25.000%
%heart-symbol%
nametag, creature-death-nametag, death-messages
The symbol: ♥ .
%tiered%
nametag, creature-death-nametag, death-messages
The effective color output from tiered-coloring setting.
%wg-region%
nametag, creature-death-nametag, death-messages
The WorldGuard region name gathered at mob processing.
%world%
nametag, creature-death-nametag, death-messages
The Minecraft world name.
%player%
custom-drops
The name of the player who killed the mob.
%player-uuid%
custom-drops
The unique UUID of the player who killed the mob.
%location%
custom-drops
The coordinates of the location of the mob's death.
%mob-scale%
custom-drops
This outputs the computed value for mob-scale: as defined per item in customdrops.yml. This value is equal to mob-scale x level.
Strategy & Modifier Placeholders
Usage
Description
%weighted-random%
strategy, weighted-random, construct-level
Associated with the output value from weighted-random strategies.
%distance-from-origin%
strategy, distance-from-origin, construct-level
Associated with the output value from distance-from-origin strategies.
%y-coordinate%
strategy, y-coordinate, construct-level
Associated with the output value from y-coordinate strategies.
%player-variable-mod%
modifier, player-variable-modifier, construct-level
Associated with the output of the value from player-variable-modifier modifiers.
%custom_name%
modifier, custom, construct-level
Associated with the output value from any custom modifiers. You can perform multiple instances separated by _name, where this is the unique name associated with the instance.
%rand_X_Y%
modifier, random-variance-modifier, construct-level
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.
Sample: %rand_-5_5% means between -5 and 5
Player Level Modifier Placeholders
Usage
Description
%level%
player-level-mod
The Minecraft level associated with the player closest to the mob.
%exp%
player-level-mod
The Minecraft experience points remaining until the player closest to the mob will level up, represented as the percentage remaining between 0.0 and 1.0.
%exp-to-level%
player-level-mod
The Minecraft experience points remaining until the player closest to the mob will level up.
%total-exp%
player-level-mod
The total Minecraft experience points the player closest to the mob has collected.
%world-time-tick%
player-level-mod
The current time of day in game as represented in ticks from 0 to 24000.
Attribute Modifier Placeholders
Usage
Description
%max-health%
attribute-modifier
Outputs the default value of the mobs' max-health attribute, before alterations.
%movement-speed%
attribute-modifier
Outputs the default value of the mobs' movement-speed attribute, before alterations.
%attack-damage%
attribute-modifier
Outputs the default value of the mobs' attack-damage attribute, before alterations.
%ranged-attack-damage%
attribute-modifier
Outputs the default value of the mobs' ranged-attack-damage attribute, before alterations.
%creeper-blast-damage%
attribute-modifier
Outputs the default value of the mobs' creeper-blast-damage attribute, before alterations.
%follow-range%
attribute-modifier
Outputs the default value of the mobs' follow-range attribute, before alterations.
%item-drop%
attribute-modifier
Outputs the value of the amount of an item being dropped, before alterations.
%xp-drop%
attribute-modifier
Outputs the value of the amount of experience points being dropped, before alterations.
%armor-bonus%
attribute-modifier
Outputs the default value of the mobs' armor-bonus attribute, before alterations.
%armor-toughness%
attribute-modifier
Outputs the default value of the mobs' armor-toughness attribute, before alterations.
%attack-knockback%
attribute-modifier
Outputs the default value of the mobs' attack-knockback attribute, before alterations.
%knockback-resistance%
attribute-modifier
Outputs the default value of the mobs' knockback-resistance attribute, before alterations.
%zombie-spawn-reinforcements%
attribute-modifier
Outputs the default value of the mobs' zombie-spawn-reinforcements attribute, before alterations.
External-Use Placeholders (Requires PAPI)
%levelledmobs_mob-target%
PAPI
The nametag value of the mob who is under crosshairs (being looked at) in-game of the player.
%levelledmobs_displayname%
PAPI
The %displayname% output of the mob which was last killed by the player.
%levelledmobs_mob-lvl%
PAPI
The level of the mob last killed by the player.
%levelledmobs_killed-by%
PAPI
The %displayname% output of the mob which last killed the player.
Last updated