Ssomar Plugins
Search
K
📚

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

Miscellaneous Placeholders

%activator_id% : Returns the id of the activator. Can be found at:
%activator_name% : Returns the name of the activator that's listed at the DisplayName field of the activator editor
%rand:MIN_VALUE|MAX_VALUE% : Randomizer value
  • Example : %rand:10|100% - Generates a number between 10-100
  • Supports negative value | MIN_VALUE must be < than MAX_VALUE
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
%timestamp% -> gets the current time
%score_cooldown_{plugin}:{object_id}:{activator_id}% -> gets the cooldown, it works for all plugins. Example: %score_cooldown_EI:Free_Lotery:activator1%

Item placeholders

Placeholder
Description
%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:|)%
(by default: amount = 30 bars, color1 is yellow, color2 is green, symbol is |)
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

Placeholder
Description
%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)
%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%
The last damage taken by the player (Decimal) >> For an integer use %last_damage_taken_int%
%last_damage_dealt%
The last damage dealt by the player (Decimal) >> For an integer use %last_damage_dealt_int%
%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%

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.
Placeholder
Description
%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)
%entity_team%
The team of the entity if the entity has one
%entity_item%
Returns the material of this item. (items not entities)

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.
Placeholder
Description
%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)
%block_biome%
The name of the biome where the block is located
List of all biomes here
(%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

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

AROUND & NEAREST placeholders

(Placeholders to use in the custom commands AROUND)
Its the same placeholders that the PLAYER PLACEHOLDERS above, just replace "player" by "around_target".
Example: %around_target_direction%

MOB_AROUND & MOB_NEAREST placeholders

(Placeholders to use in the custom commands MOB_AROUND)
Its the same placeholders that the ENTITY PLACEHOLDERS above, just replace "entity" by "around_target".
Example: %around_target_health%
Example: %around_target_uuid%
Example: %around_target_x%

Variable Placeholders

(Placeholders that you can use if you have a variable)
Example if your variable is named: X
Placeholder
Description
%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

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

Circumstantial

PLAYER_WRITE_COMMAND | PLAYER_SEND_MESSAGE

  • 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 true
  • The inputs would be the next
    • %arg0% = modify
    • %arg1% = diamond_sword
    • %arg2% = 10
    • %arg3% = true

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%

COOLDOWN

  • 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.

SETGLOW

  • You can get the glow color with %score_cmd-glow% using it on the plugin TAB