Placeholder for items
Very powerful placeholder, allows to get information about items from players, entities and storages.
Meaning
Like action for items, also very powerful placeholder, perfectly compatible with action for even more functionality, allows to get information about items from players, entities and storages.
Format
%CEP_item_<action>_<separator>_(semi-mandatory) <slot>_(optional) <entity_uuid|player_name|world,x,y,z>%<action> – the information to get, may be (for some actions see more info in the hint): (MANDATORY)
handSlot
cooldown:<material>
cooldown (only 1.21.2+)
cooldownBasic (only 1.21.3+)
enchantments
enchantmentsBooks
enchantment:<enchantment>
enchantmentBook:<enchantment>
maxDurability
currentDurability
amount
name
lore (optional, lore:line1,line2,lineN)
loreAmount
flags
material
customModelData
itemsAdder
oraxen
nexo
dataContainer-all|value|type:<name>:<id>
maxStack (only 1.20.5+)
itemModel (only 1.21.2+)
skullOwner:<uuid | type | enum | name | coords>
skullTexture
<separator> – the separator to separate the elements in different cases, it is needed when more than one element is outputting, for example in "lore" option, or in "skullOwner" option with "coords" output type; (MANDATORY)
<slot> – the slot to get the information from (do not use it in case of "handSlot" and "cooldown:<material>" actions); (SEMI-MANDATORY)
<player_name | entity_uuid | world,x,y,z> – the target to get the information (you can skip it to use the current player). (OPTIONAL)
Use "-" symbol instead of underscores in <slot>, enchantment:<enchantment> and cooldown:<material> options of the <action>!
Use "ᵕ" symbol instead of underscores in any values of the "dataContainer" option!
Be careful, as the names of enchantments and flags may be different on different versions!
The named slots such "HAND" are also supported for <slot>, see all possible values here. Also you can use "OPENED|<slot>" to get the slot in the player's open inventory, "EC|<slot>" to get the slot in the player's enderchest and "CURSOR" slot to get the item on cursor.
The <dataContainer> option outputs the PersistentDataContainer of the item. "dataContainer-all" will output all matching data with the specified name, "dataContainer-value" will output the value of the data by name and id, and "dataContainer-type" will output the type of the data by name and id. For example, the ExecutableItems plugin adds a PersistentDataContainer with <name> “executableitems”, <id> “ei-id” and type “STRING” to its items, this is what you specify when you create the item in the /ei create <id> command. Name and id should not contain any capital letters!
The "itemsAdder", "oraxen" and "nexo" options are necessary to check whether the specified item is from these plugins or not.
The "enchantments" option outputs all enchantments of the item, and "enchantment:<enchantment>" option outputs level of the specified enchantment, also they have variety "enchantmentsBook" and "enchantmentBook:<enchantment>" to check exactly the enchanted book as the book, and not as the item.
The "cooldown:<material>", "cooldown" and "cooldownBasic" options are needed to get current cooldown of the item, for example which ender pearles and shields may have. The "cooldown:<material>" will get the current cooldown of the material in the player inventory, so you do not need to specify the slot, the "cooldown" will get the current cooldown of the item by the specified slot in the player inventory (only on 1.21.2+ versions), and "cooldownBasic" will get the basic cooldown of the item by the specified slot in the inventory of any available target (only on 1.21.3+ versions). Note that the "cooldown:<material>" will not check items which have custom "cooldownBasic".
The "skullOwner" option outputs the chosen information about the head owner (if the player is offline, the "coords" will not be available, if the player also never joined to the server, the "name" will not be available).
The "skullTexture" option outputs the texture value of the head, it requires so that some owner will be present for this head, otherwise the texture will not be obtained (you can read more about all of this in the change_item action in "skullTexture" option there).
Targets
Players;
Entities (LivingEntities and InventoryHolders);
Storages (InventoryHolders).
Where is useful
Wherever you would want to check different items information at the entities (like zombies or donkeys), players or storages (like chests, barrels or shulkers).
Examples
%CEP_item_currentDurability_HAND% # Get the current durability of the item in the hand of the current player%CEP_item_dataContainer-value:executableitems:ei-id_5_8977317d-0f8d-4aa7-9045-8ad7da785289% # Get the value of the PersistentDataContainer with name "executableitems" and id "ei-id" of the item of some entity in the slot 5Last updated