Items

Moving items around: loot on death, rewards, thefts and gear changes mid-fight.

- dropitem{items=diamond 1to3 0.5,emerald 2} +onDeath @selfLocation   # 50% chance of 1-3 diamonds, always 2 emeralds
- giveitem{items=golden_apple 1} +onInteract @trigger
- equip{items=netherite_sword:HAND} +onHurt <50%
- stealitem +onAttack @trigger

Items are named the same way as in a mob’s equipment: a vanilla id (diamond_sword), or a custom-item plugin’s id (nexo:forest_sword). Lists are comma-separated; each entry is item amount chance, and amounts take ranges like 1to3.

Mechanic	Usage	What it does
`consumeslotitem` _{also consumeslot}	`consumeSlotItem{slot=HAND;amount=1}`	Removes some of the item in one of the target’s slots.
`cquip`	`cquip{item=<item>;slot=<slot>}`	Puts one item in one of the caster’s slots.
`currencygive` _{also givecurrency}	`currencyGive{amount=<n>}`	Gives a player money. Needs Vault.
`currencytake` _{also takecurrency}	`currencyTake{amount=<n>}`	Takes money from a player. Needs Vault.
`dropitem` _{also drop, dropitems, itemdrop}	`dropitem{items=<item> <amount> <chance>,…;naturally=true}`	Drops items at the target. Each entry is `item amount chance`; amounts take ranges like `1to3`.
`effect:itemspray` _{also itemspray, e:itemspray}	`effect:itemspray{items=<item>;amount=10;duration=20;radius=0}`	Sprays items out of the target that can’t be picked up, then removes them.
`equip`	`equip{items=<item>:<slot>,…}`	Puts items on the caster, `item:slot` per entry.
`equipcopy`	`equipCopy{slots=ALL}`	Copies the target’s equipment onto the caster.
`fillchest` _{also populatechest, fillcontainer, populatecontainer}	`fillChest{items=<item> <amount>,…;empty=false}`	Fills the container at the target with items.
`giveitem` _{also give, giveitems, itemgive}	`giveitem{items=<item> <amount>,…}`	Gives items to player targets.
`giveitemfromslot` _{also givefromslot}	`giveItemFromSlot{slot=HAND}`	Gives the target a copy of the item in one of the caster’s slots.
`giveitemfromtarget` _{also givefromtarget, giveitemsfromtarget, itemgivefromtarget}	`giveItemFromTarget{items=<item>}`	Gives the listed items to the caster, when the caster is a player.
`pickupitem`	`pickupItem`	Picks up the targeted item entity.
`removehelditem` _{also consumehelditem, takehelditem}	`removeHeldItem{amount=1}`	Removes some of the item the target is holding.
`stealitem` _{also steal, stealitems, itemsteal}	`stealItem{amount=1;dropchance=0}`	Takes an item from the target and puts it in the caster’s hand.
`takeitem` _{also take, takeitems, itemtake}	`takeitem{item=<item>;amount=1}`	Takes items from a player’s inventory.

MythicMobs drop tables (a mob’s Drops: section) aren’t supported yet; use dropitem on +onDeath meanwhile. Currency needs Vault.

Getting Started

Mobs

Spawning

Commands

Effects

Models

Compatibility

NPCs

Pets

Configuration

API