Skip to content

Functions

Jack William Kerr edited this page Jun 12, 2026 · 26 revisions
Name Aliases Requires Argument Type(s) Description Example(s)
amount size comparator Evaluates to true if an item stack's size matches all the specified amounts. amount(>32, <48)
armor_trim_material trim_material trim material Evaluates to true if an item's armor trim material matches one of the specified materials. trim_material(gold)
armor_trim_pattern trim_pattern trim pattern Evaluates to true if an item's armor trim pattern matches one of the specified patterns. trim_pattern(silence)
book_author author username Evaluates to true if a book's author matches one of the specified strings. author(Fruitloopins)
book_generation generation generation Evaluates to true if a book's generation matches one of the specified generations. generation(copy_of_copy)
book_title title string Evaluates to true if a book's title matches one of the specified titles. title("Special Book")
display_name_contains name_contains string Evaluates to true if an item's display name contains all the specified strings. name_contains(stone, moss)
display_name_ends_with name_ends_with string Evaluates to true if an item's display name ends with one of the specified strings. name_ends_with(map)
display_name name string Evaluates to true if an item's display name matches one of the specified strings. name("Super Secret Access Key")
display_name_starts_with name_starts_with string Evaluates to true if an item's display name starts with one of the specified strings. name_starts_with(mossy, diamond)
durability dur comparator, string Evaluates to true if an item matches all the specified damage amounts as a percentage. durability(max, undamaged), durability(>=90)
enchantment ench, enchant enchantment Evaluates to true if an item has all the specified enchantments. ench("sharpness >= 4", fire_aspect)
has_armor_trim is_trimmed, trimmed Evaluates to true if an item has an armor trim applied. trimmed()
has_custom_name is_renamed, renamed Evaluates to true if an item has been renamed. renamed()
has_lore lored Evaluates to true if an item has lore. lored()
is_compostable compostable Evaluates to true if an item can be composted. compostable()
is_damaged damaged Evaluates to true if an item is damaged. damaged()
is_edible edible, is_food, food Evaluates to true if an item is edible. edible()
is_enchanted enchanted Evaluates to true if an item is enchanted. enchanted()
is_fuel fuel Evaluates to true if an item is usable as fuel in a furnace. fuel()
is_repairable repairable Evaluates to true if an item is repairable in an anvil. repairable()
is_smeltable smeltable Evaluates to true if an item is smeltable in a furnace. smeltable()
is_stackable stackable, can_stack Evaluates to true if an item's type is stackable. stackable()
is_unbreakable unbreakable Evaluates to true if an item is unbreakable. unbreakable()
lore_contains string Evaluates to true if an item's lore contains all the specified strings. lore_contains("3 levels")
lore_ends_with string Evaluates to true if an item's lore ends with one of the specified strings. lore_ends_with("(33 experience)")
lore string Evaluates to true if an item's lore matches ones of the specified strings. lore("3 levels (33 experience)")
lore_starts_with string Evaluates to true if an item's lore starts with one of the specified strings. lore_starts_with("3 levels")
map_id map comparator Evaluates to true if a map's ID matches all the specified comparators. map_id(>=5, <=15, 1337)
material_contains type_contains string Evaluates to true if an item's material name contains all the specified strings. type_contains(stone)
material_ends_with type_ends_with string Evaluates to true if an item's material name ends with one of the specified strings. type_ends_with(e)
material type material Evaluates to true if an item is of any specified material. type(cobblestone, mossy_cobblestone)
material_starts_with type_starts_with string Evaluates to true if an item's material name starts with one of the specified strings. type_starts_with(diamond, iron)
potion_duration duration, pot_dur comparator, string Evaluates to true if a potion has all the specified durations in ticks. duration(>=3600), duration(infinite, unlimited), duration(3600)
potion_effect effect, pot_eff, eff potion effect Evaluates to true if an item has all the specified potion effects. effect("speed = 2", invisibility, instant_health>=1)
potion_type pot_type potion type Evaluates to true if a potion's base type matches one of the specified potion types. pot_type(mundane)
source_inventory_type source_type, source inventory type Evaluates to true if an item's source is of one of the specified types. source(barrel)
rarity item rarity Evaluates to true if an item matches one of the specified item rarities. rarity(common)
skull_owner head_owner username, uuid Evaluates to true if a head's owner matches one of the specified UUIDs or usernames. head_owner(Fruitloopins)
skull_texture head_texture base64 Evaluates to true if a head's texture matches one of the specified Base64 strings. head_texture(eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMjA4NGVmNjBjNjUwYjRmMjZiMDZiMDUxOTI4MWU2YzQxNjA5YTVjZDllY2JkNjk3YjljZjE2ZWViZjc4NWI0OCJ9fX0=)
smeltable_by inventory type Evaluates to true if an item can be smelted in one of the specified furnace types. smeltable_by(smoker, blast_furnace)
stored_experience stored_exp, stored_xp, experience, exp, xp bottlet comparator Evaluates to true if an experience bottle's stored experience matches all the specified amounts. xp(>=1395)
tag tagged item tag, block tag Evaluates to true if an item has one of the specified tags. tag(wool), tag(beds)
thrower thrown_by username, uuid Evaluates to true if an item was thrown by one of the specified UUIDs or usernames. thrower(Fruitloopins, 12BarBruise), thrown_by(fed0ec4a-f1ad-4b97-9443-876391668b34)
thrower_nation thrower_nation, nation towny nation Evaluates to true if an item was thrown by a member of one of the specified nations. nation(Australia)
thrower__town thrower_town, town towny town Evaluates to true if an item was thrown by a member of one of the specified towns. town(Melbourne)

Clone this wiki locally