Placeholders Variables - ssomar1607/ExecutableItems GitHub Wiki

IMPORTANT INFOS:

  • You can now use these placeholders in placeholder conditions!
  • 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

Item placeholders:

  • %item% : The name of the ExecutableItems
  • %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)
  • %max_use_per_day_item% The max use per day that the item has.
  • %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
  • You can increase the variable of amount variable.
    • Example : %amount%+6 (Increase)
      • %amount% = 15
      • %amount% + 6 =
      • (15) + 6 = 21
    • Example : %amount%-8 (Decrease)
      • %amount% = 14
      • %amount% - 8 =
      • (14) - 8 = 6
  • %activator% : the name of the current activator executed.
  • %max_use_per_day_activator% : The max use per day that the activator has.

Miscellaneous Placeholders

  • %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
  • %owner% : Name of the owner of the item.
    • The owner is determined by who got the item from /ei give, /ei giveslot commands or from the gui
  • %owner_world_lower% : World where the owner is at but all lowercase

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
  • %x% : X-Coordinates of the player (Decimal) >> For an integer use %x_int%
  • %y% : Y-Coordinates of the player (Decimal) >> For an integer use %y_int%
  • %z% : Z-Coordinates of the player (Decimal) >> For an integer use %z_int%
    • You can increase the variable of each coordinate variable.
    • Example : %x%+6 (Increase)
      • %x% = 15
      • %x% + 6 =
      • (15) + 6 = 21
    • Example : %z%-8 (Decrease)
      • %z% = 14
      • %z% - 8 =
      • (14) - 8 = 6
  • %world% : Name of the world (%player_world_lower% for lowercase)
  • %slot% : The slot used to active the activator
  • %slot_live% : The current held slot
  • %last_damage_taken% The last damage taken by the player (Decimal) >> For an integer use %last_damage_taken_int%
  • %pitch% : The pitch of the player
  • %pitch_int% : The pitch of the player in integer (No decimals)
  • %pitch_positive% : The pitch of the player but always positive
  • %pitch_positive_int% : The pitch of the player but always positive in integer (No decimals)
  • %player_direction% / %direction% : Direction of where the player is facing (ex: N, SW, NE)
  • %yaw% : The yaw of the player
  • %yaw_int% : The yaw of the player (No decimals)
  • %yaw_positive% : the yaw of the player but always positive
  • %yaw_positive_int% : the yaw of the player but always positive (No decimals)

Target player placeholders: (Activator must have a target player)

  • %target% : Name of the target
  • %target_uuid% : UUID of the target
  • %target_x% : X-Coordinates of the target (Decimal) >> For an integer use %target_x_int%
  • %target_y% : Y-Coordinates of the target (Decimal) >> For an integer use %target_y_int%
  • %target_z% : Z-Coordinates of the target (Decimal) >> For an integer use %target_z_int%
    • You can increase the variable of each coordinate variable.
    • Example : %target_x%+6 (Increase)
      • %target_x% = 15
      • %target_x% + 6 =
      • (15) + 6 = 21
    • Example : %target_z%-8 (Decrease)
      • %target_z% = 14
      • %target_z% - 8 =
      • (14) - 8 = 6
  • %target_world% : Name of the world
  • %target_slot% : The held slot
  • %target_last_damage_taken% The last damage taken by the player (Decimal) >> For an integer use %target_last_damage_taken_int%
  • %target_direction% : Direction of where the target is facing (ex: N, SW, NE)

Target Entity placeholders: (Activator must have a target entity)

  • %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_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%
    • You can increase the variable of each coordinate variable.
    • Example : %entity_x%+6 (Increase)
      • %entity_x% = 15
      • %entity_x% + 6 =
      • (15) + 6 = 21
    • Example : %entity_z%-8 (Decrease)
      • %entity_z% = 14
      • %entity_z% - 8 =
      • (14) - 8 = 6
  • %entity_world% : Name of the world (%entity_world_lower% for lowercase)

Block placeholders: (Activator must have a target block)

  • %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_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)
    • You can increase the variable of each coordinate variable.
    • Example : %block_x%+20 (Increase)
      • %block_x% = 100
      • %block_x% + 20 =
      • (100) + 20 = 120
    • Example : %block_y%-44 (Decrease)
      • %block_y% = 88
      • %block_y% - 44 =
      • (88) - 44 = 44
  • %block_world% : the name of the world where the block is located (%block_world_lower% for lower)
  • %block_dimension% : the type of world (nether, custom, normal, end)

Projectile placeholders: (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_world% : World name of the projectile (%projectile_world_lower% for lower)

AROUND placeholders:

  • %around_target% : Name of the target player
  • %around_target_uuid% : UUID of the target player
  • %around_target_x% : X-Coordinates of the target player (Decimal) >> For an integer use %around_target_x_int%
  • %around_target_y% : Y-Coordinates of the target player (Decimal) >> For an integer use %around_target_y_int%
  • %around_target_z% : Z-Coordinates of the target player (Decimal) >> For an integer use %around_target_z_int%
    • You can increase the variable of each coordinate variable.
    • Example : %around_target_x%+6 (Increase)
      • %around_target_x% = 15
      • %around_target_x% + 6 =
      • (15) + 6 = 21
    • Example : %around_target_z%-8 (Decrease)
      • %around_target_z% = 14
      • %around_target_z% - 8 =
      • (14) - 8 = 6
  • %around_target_world% : Name of the world
  • %around_target_slot% : The held slot by the target player
  • %around_target_last_damage_taken% The last damage taken by the player (Decimal) >> For an integer use %last_damage_taken_int%

MOB_AROUND placeholders:

  • %around_target% : Type of target entity
  • %around_target_name% : Name of the target entity
  • %around_target_uuid% : UUID of the target entity
  • %around_target_x% : X-Coordinates of the target entity (Decimal) >> For an integer use %around_target_x_int%
  • %around_target_y% : Y-Coordinates of the target entity (Decimal) >> For an integer use %around_target_y_int%
  • %around_target_z% : Z-Coordinates of the target entity (Decimal) >> For an integer use %around_target_z_int%
    • You can increase the variable of each coordinate variable.
    • Example : %around_target_x%+6 (Increase)
      • %around_target_x% = 15
      • %around_target_x% + 6 =
      • (15) + 6 = 21
    • Example : %around_target_z%-8 (Decrease)
      • %around_target_z% = 14
      • %around_target_z% - 8 =
      • (14) - 8 = 6
  • %around_target_world% : Name of the world