Placeholders
All numerical placeholders can be incremented or decremented.
Example :
%amount%+6(Increase)%amount% = 15
%amount% + 6 =
(15) + 6 = 21
Example :
%amount%-8(Decrease)%amount% = 14
%amount% - 8 =
(14) - 8 = 6
But you can also you the math placeholders of PlaceholderAPI
EI placeholders are parsed first before PlaceholderAPI placeholders are parsed.
Examples of using an EI placeholder inside of a math placeholder
%math_0_(%usage%)*10%
EI placeholders are pre-parsed and any placeholders that are not ei are parsed upon command activation so you can use ei placeholders for xyz coordinates and not worry about change in values
If %around_target% ever fails to properly return the AROUND/MOB_AROUND around target's details, use %around_target::step1%
Miscellaneous Placeholders
Even if there are multiple %rand:MIN_VALUE|MAX_VALUE% placeholders in a command line, it would still give the same number so if you want a rng placeholder that would give different answers for every of its placeholder that exists in the command line, use PlaceholderAPI's RNG Expansion
Item placeholders
%name%
The name of the ExecutableItems
%id%
Returns the id of the ExecutableItem used to run the activator
%usage%
The max usage that the item has (CAN BE USED IN LORE)
%usage_limit%
The max usage that the item can have (CAN BE USED IN LORE)
%usage_roman%
Display the usage in roman numerals (11 -> XI)
%max_use_per_day_item%
The max use per day that the item has.
%max_use_per_day_activator%
The max use per day for the activator.
%amount%
The amount of ExecutableItems that the player has in his current selected slot. Also tells the amount of EI you dropped when triggering the PLAYER_DROP_THE_EI activator
%usage_bar(amount:30,color1:&d,color2:&5,symbol:|)%
amount = The amount of bars the usage bar will have color1 = The color that represents how much usage the item has (The light purple) color2 = The color that represents the dark purple symbol = The symbol that will be used on the custom usage bar Requirements: - The item must have the usage and the usage limit different than -1
Player placeholders
%player%
Name of the player. Can be used to display the owner of the item in the item's lore
%player_uuid%
UUID of the player (%player_uuid_array% for its 4-array integer form. Ex: [I;-1288600659,-373273272,-1897203511,898446696])
%player_world%
Name of the world (%player_world_lower% for lowercase) Use <<%player_world%>> when entering world argument in vanilla commands
%player_x%
X-Coordinates of the player (Decimal) >> For an integer use %player_x_int%
%player_y%
Y-Coordinates of the player (Decimal) >> For an integer use %player_y_int%
%player_z%
Z-Coordinates of the player (Decimal) >> For an integer use %player_z_int%
%player_slot%
The slot used to active the activator
%player_slot_live%
The current held slot
%player_pitch%
The pitch of the player >> For an integer %player_pitch_int%
%player_pitch_positive%
The pitch of the player but always positive >> For an integer %player_pitch_positive_int%
%player_yaw%
The yaw of the player >> For an integer %player_yaw_int%
%player_yaw_positive%
The yaw of the player but always positive >> For an integer %player_yaw_positive_int%
%player_direction%
Direction of where the player is facing (ex: N, SW, NE)
%last_damage_taken% %last_damage_taken_int%
The last damage taken by the player
%last_damage_dealt% %last_damage_dealt_int%
The last damage dealt by the player
%player_team%
The team of the player if the player has one
%player_attack_charge%
Gets the current cooldown for a player's attack. This is used to calculate damage, with 1.0 representing a fully charged attack and 0.0 representing a non-charged attack (1.16+ only) This placeholder gets reset after a DAMAGE command, so if you want to debug it, display the value before a DAMAGE command.
Target player placeholders
(The activator must have a target player)
Its the same placeholders that the PLAYER PLACEHOLDERS above, just replace "player" by "target".
Example:
%target_x%
%target_last_damage_taken% %target_last_damage_taken_int%
The last damage taken by the target
Entity placeholders
(The activator must have an entity)
in EI / EB it's always these placeholders for entity.
in EE it's quite different, since we can have an entity as a main actor of the event but also as target. So use these placeholders below when the entity is the main actor of the event. And Look the part Target entity placeholders when the entity is the target.
%entity%
Type of the entity
%entity_lower_case%
Type of the entity in lower case
%entity_name%
Name of the entity (lower case: %entity_name_lower_case%)
%entity_uuid%
UUID of the entity (%entity_uuid_array% for its 4-array integer form. Ex: [I;-1288600659,-373273272,-1897203511,898446696])
%entity_x%
X-Coordinates of the entity (Decimal) >> For an integer use %entity_x_int%
%entity_y%
Y-Coordinates of the entity (Decimal) >> For an integer use %entityt_y_int%
%entity_z%
Z-Coordinates of the entityr (Decimal) >> For an integer use %entity_z_int%
%entity_direction%
Direction of where the entity is facing (ex: N, SW, NE)
%entity_pitch%
The pitch of the entity>> For an integer %entity_pitch_int%
%entity_pitch_positive%
The pitch of the entity but always positive >> For an integer %entity_pitch_positive_int%
%entity_yaw%
The yaw of the entity >> For an integer %entity_yaw_int%
%entity_yaw_positive%
The yaw of the entity but always positive >> For an integer %entity_yaw_positive%
%entity_health%
The health of the entity (Decimal)
%entity_max_health%
The max health of the entity (Decimal)
%entity_world%
Name of the world (%entity_world_lower% for lowercase) Use <<%entity_world%>> when entering world argument in vanilla commands
%entity_team%
The team of the entity if the entity has one
%entity_item%
Returns the material of this item. (items not entities)
%entity_last_damage_taken% %entity_last_damage_taken_int%
It returns the last damage taken by the entity
%entity_serialized%
it returns the entity definition, with all their custom characteristics
Target entity placeholders
(The activator must have a target entity)
Its the same placeholders that the ENTITY PLACEHOLDERS above, just replace "entity" by "target".
Example: %target_x%
Block placeholders
(The activator must have a block)
in EI / EB it's always these placeholders for entity.
in EE it's quite different, since we can have a block as a main actor of the event but also as target. So use these placeholders below when the block is the main actor of the event. And Look the part Target block placeholders when the block is the target.
%block%
Type of the block when the activator has been activated (In caps)
%block_lower%
Type of the block when the activator has been activated (In lower case)
%block_live%
Current type of the block (In caps)
%block_item_material%
Return the item material of the block for example the block CARROTS return CARROT, for lower cases use %block_item_material_lower%
%block_live_lower%
Current type of the block (In lower case)
%block_x%
X-Coordinates of the block (USE %block_x_int% to get the block coordinates without decimals)
%block_y%
Y-Coordinates of the block (USE %block_y_int% to get the block coordinates without decimals)
%block_z%
Z-Coordinates of the block (USE %block_z_int% to get the block coordinates without decimals)
%blockface%
Returns the face of the selected block.
%block_data%
Returns the data of the block
%block_world%
The name of the world where the block is located (%block_world_lower% for lower) Use <<%block_world%>> when entering world argument in vanilla commands
%block_biome%
The name of the biome where the block is located
(%block_biome_lower% for lower)
%block_dimension%
The type of world (nether, custom, normal, end)
%block_spawnertype%
Returns the type of mob in spawner or "null"
%block_is_ageable%
Returns if the block is ageable or not
%block_eb_id%
If the block is an ExecutableBlock then it returns its ID otherwise it return an empty text.
Target block placeholders
(The activator must have a target block)
Its the same placeholders that the BLOCK PLACEHOLDERS above, just replace "block" by "target_block".
Example: %target_block_x%
Projectile placeholders
(The activator must have a projectile)
%projectile_x%
X-Coordinates of the projectile (Decimal) (%projectile_x_int% for no decimals)
%projectile_y%
Y-Coordinates of the projectile (Decimal) (%projectile_y_int% for no decimals)
%projectile_z%
Z-Coordinates of the projectile (Decimal) (%projectile_z_int% for no decimals)
%projectile%
The type of projectile but at all caps
%projectile_lower_case%
The type of projectile but at all lowercase
%projectile_name%
Name of the projectile (More specifically, it will display what's written in your custom projectile's customName option)
%projectile_name_lower_case%
Name of the projectile but at all lowercase (More specifically, it will display what's written in your custom projectile's customName option)
%projectile_uuid%
UUID of the projectile (%projectile_uuid_array% for its 4-array integer form. Ex: [I;-1288600659,-373273272,-1897203511,898446696])
%projectile_world%
World name of the projectile (%projectile_world_lower% for lower) Use <<%projectile_world%>> when entering world argument in vanilla commands
%bow_force%
If the projectile has been launched with a bow, you can use this placeholder to obtain the force that the player used to shot his projectile. (Between 0 and 1)
Owner Placeholders
(Will work only if an owner is set for the block / item)
Its the same placeholders that the PLAYER PLACEHOLDERS above, just replace "player" by "owner".
Example: %owner_health%SC
Variables placeholders
Here you can take a look at the internal item/block variable types and their placeholders. This type of variables are not the same as "score variables", these variables are independent for each item/block, and score variables are variables not linked to an item or a block.
Variable Placeholders - Internal item/block
(Placeholders that you can use if you have a variable)
Example if your variable is named: X
%var_X%
Value of the variable X
%var_X_int%
Value of the variable X cast in an Integer
%var_X_roman%
Value of the variable X in roman numbers
List Variable Placeholders - Internal item/block
%var_MYVAR%
Returns the list with the brackets and commas
%var_testVar%
%var_MYVAR_size%
Returns how many elements/values that list variable contains
%var_testVar_size%
%var_MYVAR_contains_WHAT%
Returns true/false if the mentioned value is present in the list
%var_testVar_contains_Maximo% %var_testVar_contains_%player%% %var_testVar_contains_%checkitem_mat:stone%% %var_testVar_contains_%var_bomberZ%%
Score variables
Take a look here:
ExecutableItems placeholders
%executableitems_checkamount%
Count all EI amount in the inventory
%executableitems_checkamount_slot:0,2,3,4%
Count all EI amount in the inventory at the slots 0,2,3,4
%executableitems_checkamount_id:item1,item2_slot:0,2,3,4%
Count all EI that are "item1" or "item2" amount in the inv at the slot 0,2,3,4
ExecutableBlocks placeholders
%executableblocks_checkamount%
Count all EB amount in the inventory
%executableblocks_checkamount_slot:0,2,3,4%
Count all EB amount in the inventory at the slots 0,2,3,4
%executableblocks_checkamount_id:item1,item2_slot:0,2,3,4%
Count all EB that are "item1" or "item2" amount in the inv at the slot 0,2,3,4
SCore commands placeholders
AROUND & NEAREST placeholders
To get the placeholders of the around players or nearest player you can use the PLAYER PLACEHOLDERS above, just replace "player" by "around_target".
Example: %around_target_direction%
MOB_AROUND & MOB_NEAREST placeholders
To get the placeholders of the around entities or nearest entity you can use the ENTITY PLACEHOLDERS above, just replace "entity" by "around_target".
Example: %around_target_health%
Example: %around_target_uuid%
Example: %around_target_x%
DAMAGE_BOOST
For this command you can get the boost given by the custom player command
DAMAGE_BOOST {modification in percentage example 100} {timeinticks}%score_cmd-damage-boost%
DAMAGE_RESISTANCE
For this command you can get the boost given by the custom player command
DAMAGE_RESISTANCE {modification in percentage example 100} {timeinticks}%score_cmd-damage-resistance%
SETGLOW
You can get the glow color with %score_cmd-glow% using it on the plugin TAB
Activators placeholders
PLAYER_EXPERIENCE_CHANGE
Plugins: ExecutableItems / ExecutableEvents
%experience% to get the amount of experience
PLAYER_RECEIVE_EFFECT
Plugins: ExecutableItems / ExecutableEvents
PLAYER_WRITE_COMMAND | PLAYER_SEND_MESSAGE
Plugins: ExecutableItems / ExecutableEvents
For this activator you will be able to use the arguments provided by the user in your EI Command or as placeholders conditions, for example:
Command: modify
Input by player:
/modify 5
We can take that "5" using the %arg1% argument
If the player would write
/modify diamond_sword 10 trueThe inputs would be the next
%arg0% = modify
%arg1% = diamond_sword
%arg2% = 10
%arg3% = true
If you want to get all the args the player wrote use
%all_args%Or all the args without the first one (useful for commands)
%all_args_without_first%
PLAYER_ENCHANT_ITEM
Plugin: ExecutableEvents
%enchants% to get the enchantments Ex: "Sharpness;10:Efficiency;2"
%levelCost%
CREEPER_POWER_CHANGE
Plugin: ExecutableEvents
%powerCause%
ENTITY_SPAWN_TRIALSPAWNER
Plugin: ExecutableEvents
%isOminous%
PLAYER_HIT_ENTITY | PLAYER_HIT_PLAYER
Plugins: ExecutableItems / ExecutableEvents
%critical% return true if the hit is a critical otherwise false
PLAYER_INVENTORY_CLICK
Plugins: ExecutableEvents
%isShiftClick%
%isMouseClick%
%isLeftClick%
%isRightClick%
%isKeyboardClick%
%isCreativeAction%
%getAction%
%beforeSlot%
%afterSlot%
%inventory_type%
%inventory_title%
PLAYER_LEVEL_CHANGE
Plugin: ExecutableEvents
%newLevel%
%oldLevel%
LIGHTNING_STRIKE
Plugin ExecutableEvent
%cause%
WEATHER_CHANGE
Plugin ExecutableEvent
%cause%
Cooldown placeholders
You can get the cooldown in seconds like that with
%score_cooldown_{plugin}:{object_id}:{activator_id}%
Example: %score_cooldown_EI:Free_Lotery:activator1%
It returns the cooldown of the activator1 of the EI Free_Lotery. It works with EE, EB, EI, EL cooldowns.
Last updated
