Ssomar Plugins
🛒 Purchase📢 Discord❤️ Donate
  • Tools for all Plugins [Score]
    • 📚Custom Commands
      • Player & Target Commands
      • Mixed Commands (Player & Entity)
      • Entity Commands
      • Block Commands
      • Item Commands
      • Utility Commands
    • 📚Custom Conditions
      • Player & Target Conditions
      • Entity Conditions
      • Block Conditions
      • World Conditions
      • Item Conditions
      • Placeholder Conditions
      • Custom EI Conditions
    • 🏹Custom Projectiles
    • 📚Placeholders
    • ✨ Score particles
    • 🧮 Score Variables
    • ✔️Compatible Plugins
    • 🤖General Questions | Guides
      • Technical-Level Info
      • SCore
      • Math Formulas
      • Utilities
        • Code Bin/Stock
    • 📰 Score
      • General config
      • Commands
    • 🔘 Custom triggers
  • ExecutableItems
    • 📌Information EI
    • 📃Configurations
      • General Configuration
      • Item Configuration
        • Item Features
        • Item Restrictions/Resistances
      • Activator Configuration
        • List of the Activators
        • Activators features
    • ⌨️Commands & Permissions
    • 🤖Questions | Guides
      • Frequently Asked Questions
        • Free vs Premium
        • Install/update/errors
          • How to install correctly
          • How to update correctly
          • Installation errors [logs]
          • Plugin doesn't work 😡😡
          • command /ei doesn't work
          • Just installed the plugin and have errors on my logs
        • Players can't use the items
        • Basic tutorials
        • Item disappears | Limit
        • EI COMMANDS doesn't work
        • How to use vanilla commands
        • Server chat spamming
        • Custom crafting
        • Folders on /ei show
        • Item as player head
        • Armor trims
        • Attributes not working
        • How to duplicate an EI Item
        • How to change particle vanilla command color
        • Edit plugin messages
        • Item Textures
        • I want to give an item on join
        • Issue with written book
        • How to add custom NBTTag
        • HEX COLORS doesn't work
        • HUGE delay | cooldown | command time
        • Trident duplication
        • Custom name feature is not working
        • Score database large
        • PROJECTILE_HIT_... activators not working
        • Not so frequentlly asked questions
      • Items explanations
        • Item ideas - How to create...?
        • Hight-Powered Grappling Hook
        • Morph Tools
        • Delayed Teleport Towards Saved Location
        • Box of ender pearls
        • Swap position
        • Magnet
        • Item frame visibility toggler
        • Hermes boots
        • EI |WorldEdit -> SET COMMAND
        • Bag of items
        • Infinite rockets
        • Trident that works when not raining
        • [Complex] Moving Particle Projectile
      • Methods | Template
        • Multiple projectiles on one item
        • Custom drops
        • Deal % of entity HP
        • Variable conditions
        • Armor Set Bonus
        • Custom durability
          • Custom durability bar
        • Action Counter
        • On / Off Switch
        • Custom food
        • Raycast
        • Random activators selector
        • Break blocks not depending on item
        • Infinite | finite blocks
        • Damage | Hit features
        • Backstab
        • Item date on lore
        • Entity health condition
        • Dashes | Commands & usage
        • Guns
        • RNG Chance activator
        • Only usable on mainhand
        • Transform Vanilla Items into ExecutableItems
        • Insta pickup
        • Epic particles
        • Custom totems
        • One Time Loop
        • OneTime action
        • MINEINCUBE command whitelist or blacklist blocks
        • Cancel a delayed command
        • Worldedit schematic
        • Condition 1 between 5 different armor pieces
        • Creating Items with multiple activators with varying conditions while having only one error message
        • [Free version] Mana Requirement
        • Setting Up a System that runs the auto update feature once per update
        • [Outdated] Global Cooldown
      • Custom projectiles implementation
        • Projectile ideas - How to create...?
        • Creating a basic projectile
        • Launch Arrows in cone
        • Launch Diamond Axe
        • Custom Actions / Damages per projectiles
      • Custom textures
        • Custom textures [1.21 --]
          • General items
          • Per states texture
          • Custom armor (using armor trims)
          • Animated textures
          • 3D Models
          • Uploading texture pack
          • Fixing Invalid PNG Files
        • Custom texture [1.21+]
      • Custom sounds
      • Informal Guides
      • Plugin performances optimization
    • 🔦MC Versions Compatibility
    • ⚙️Developer API
  • ExecutableBlocks
    • 📌Information EB
    • 📃Configurations
      • General Configuration
      • Block Configuration
        • Block Features
        • Blocks Examples
      • Activator Configuration
        • List of the Activators
        • Activators features
        • Activator Examples
    • ⌨️Commands & Permissions
    • 🤖Question | Guides
      • Frequently Asked Questions
        • Free vs Premium
        • Install/update/errors
          • How to install correctly
          • How to update correctly
          • Installation errors [logs]
          • Plugin doesn't work 😡😡
        • Players can't use the blocks
        • Block disappears | Limit
        • How to use vanilla commands
        • Server chat spamming
        • Custom crafting
        • Block as player head
        • Tutorial
        • Block states
        • Block Textures
        • My condition is checking the owner
        • SETEXECUTABLEBLOCK does not work
        • Holograms won't vanish
      • Tutorials
        • Boss summoner
        • Item generator
        • Custom crops
        • Custom TNT
        • Block that generate a structure
      • Methods
        • Timed actions
        • Worldedit schematic
    • ⚙️Developer API
  • ExecutableEvents
    • 📌Information EE
    • 📃Configurations
      • General Configuration
      • Activator Configuration
        • List of the Activators
        • Activators features
    • 🤖Question | Guides
      • Informal Guides
      • Frequently Asked Questions
        • Install/update/errors
          • How to install correctly
          • How to update correctly
          • Installation errors [logs]
          • Plugin doesn't work 😡😡
        • How to use vanilla commands
        • Server chat spamming
      • Tutorials
        • Toggle System/Command with Godmode
        • Custom enchants by lore
        • Give new/old players an item once
        • Run commands after killing x amount of mobs
        • Detect player entry/leave from a worldguard region
    • ⌨️Commands & Permissions
  • MyFurniture
    • 📌Information MF
    • 📃Configurations
      • General Configuration
      • Furniture Configuration
        • Furniture Features
        • Furntiture Examples
      • Activator Configuration
        • List of the Activators
        • Activators features
    • 🤖Question | Guides
      • Frequently Asked Questions
        • Install/update/errors
          • How to install correctly
          • How to update correctly
          • Installation errors [logs]
          • Plugin doesn't work 😡😡
        • Import your own Furniture
        • How to use vanilla commands
        • Server chat spamming
        • Free vs Premium
    • ⌨️Commands & Permissions
  • ExecutableCrafting
    • 📌Information EC
    • 📃Configurations
      • General Configuration
      • Recipe Configuration
        • Recipe Features
        • Crafting Recipe Examples
      • Recipe groups
      • Recipe Book
    • 🤖Questions | Guides
      • Free vs Premium
      • Install/update/errors
        • How to install correctly
        • How to update correctly
    • ⌨️Commands & Permissions
  • AI Chat Moderation
    • 📌Information ACM
    • 📃Configurations
    • ⌨️Commands & Permissions
  • CustomPiglinsTrades
    • 📌Information CPT
    • ⌨️Commands & Permissions
    • ✔️Compatible Plugins
  • ScreenShop
    • 📌Information ScreenShop
  • TEAM AND DONATIONS
    • 🎆Contact / Support us ?
Powered by GitBook
On this page
  • Miscellaneous Placeholders
  • Item placeholders
  • Player placeholders
  • Target player placeholders
  • Entity placeholders
  • Target entity placeholders
  • Block placeholders
  • Target block placeholders
  • Projectile placeholders
  • Owner Placeholders
  • Variables placeholders
  • Variable Placeholders - Internal item/block
  • List Variable Placeholders - Internal item/block
  • Score variables
  • ExecutableItems placeholders
  • ExecutableBlocks placeholders
  • SCore commands placeholders
  • AROUND & NEAREST placeholders
  • MOB_AROUND & MOB_NEAREST placeholders
  • DAMAGE_BOOST
  • DAMAGE_RESISTANCE
  • SETGLOW
  • Activators placeholders
  • PLAYER_EXPERIENCE_CHANGE
  • PLAYER_RECEIVE_EFFECT
  • PLAYER_WRITE_COMMAND | PLAYER_SEND_MESSAGE
  • PLAYER_ENCHANT_ITEM
  • CREEPER_POWER_CHANGE
  • ENTITY_SPAWN_TRIALSPAWNER
  • PLAYER_HIT_ENTITY | PLAYER_HIT_PLAYER
  • PLAYER_INVENTORY_CLICK
  • PLAYER_LEVEL_CHANGE
  • LIGHTNING_STRIKE
  • WEATHER_CHANGE
  • Cooldown placeholders
Edit on GitHub
  1. Tools for all Plugins [Score]

Placeholders

PreviousCustom ProjectilesNext✨ Score particles

Last updated 1 month ago

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 of I

  • 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

%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. Examples:

  • %score_cooldown_EI:Free_Lotery:activator1%

  • %score_cooldown_EI:cybert1:activator6_int%

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:|)%

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

Placeholder
Description

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

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

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) 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)

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) 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

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 - Internal item/block

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%%

Score variables

Take a look here:


ExecutableItems placeholders

Placeholder
Description

%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

Placeholder
Description

%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

%effect_received%
%effect_received_lower%
%effect_received_level%
%effect_received_duration%

They return the minecraft effect name instead of the spigot name

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 true

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

%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

(by default: amount = 30 bars, color1 is yellow, color2 is green, symbol is |)

List of all biomes

📚
math placeholders
PlaceholderAP
🧮 Score Variables
here