🪨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

Misc Placeholder	Usage	Description
%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.
%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)

Misc Placeholder	Usage	Description
%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.