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