> ## Documentation Index
> Fetch the complete documentation index at: https://entities.lodemc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Items

> Giving, dropping, taking, stealing and equipping items, and currency.

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

```yaml theme={null}
- 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](https://entities.lodemc.net/mob-equipment.md): 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` <sub>also `consumeslot`</sub> | `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` <sub>also `givecurrency`</sub> | `currencyGive{amount=<n>}` | Gives a player money. Needs Vault. |
| `currencytake` <sub>also `takecurrency`</sub> | `currencyTake{amount=<n>}` | Takes money from a player. Needs Vault. |
| `dropitem` <sub>also `drop`, `dropitems`, `itemdrop`</sub> | `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` <sub>also `itemspray`, `e:itemspray`</sub> | `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` <sub>also `populatechest`, `fillcontainer`, `populatecontainer`</sub> | `fillChest{items=<item> <amount>,…;empty=false}` | Fills the container at the target with items. |
| `giveitem` <sub>also `give`, `giveitems`, `itemgive`</sub> | `giveitem{items=<item> <amount>,…}` | Gives items to player targets. |
| `giveitemfromslot` <sub>also `givefromslot`</sub> | `giveItemFromSlot{slot=HAND}` | Gives the target a copy of the item in one of the caster's slots. |
| `giveitemfromtarget` <sub>also `givefromtarget`, `giveitemsfromtarget`, `itemgivefromtarget`</sub> | `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` <sub>also `consumehelditem`, `takehelditem`</sub> | `removeHeldItem{amount=1}` | Removes some of the item the target is holding. |
| `stealitem` <sub>also `steal`, `stealitems`, `itemsteal`</sub> | `stealItem{amount=1;dropchance=0}` | Takes an item from the target and puts it in the caster's hand. |
| `takeitem` <sub>also `take`, `takeitems`, `itemtake`</sub> | `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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.