> For the complete documentation index, see [llms.txt](https://pigaut.gitbook.io/orestack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pigaut.gitbook.io/orestack/items.md).

# Items

- [Item](https://pigaut.gitbook.io/orestack/items/item.md): Custom items are defined in YAML and can override nearly every aspect of a Minecraft item — from its appearance and enchantments to its behavior when clicked, dropped, or used to break blocks.
- [type](https://pigaut.gitbook.io/orestack/items/item/type.md): The base Minecraft material. Accepts any valid material ID.
- [amount](https://pigaut.gitbook.io/orestack/items/item/amount.md): Stack size of the item.
- [name](https://pigaut.gitbook.io/orestack/items/item/name.md): Custom display name. Supports Minecraft color and hex codes.
- [lore](https://pigaut.gitbook.io/orestack/items/item/lore.md): Lines of lore text shown beneath the item name. Supports color codes.
- [model-data](https://pigaut.gitbook.io/orestack/items/item/model-data.md): Custom model data value used to target specific models in a resource pack.
- [durability](https://pigaut.gitbook.io/orestack/items/item/durability.md): Current durability applied to the item (how worn it is).
- [max-durability](https://pigaut.gitbook.io/orestack/items/item/max-durability.md): Overrides the item's maximum durability.
- [repair-cost](https://pigaut.gitbook.io/orestack/items/item/repair-cost.md): Experience cost to repair this item in an anvil.
- [flags](https://pigaut.gitbook.io/orestack/items/item/flags.md): List of ItemFlag values that hide specific information from the item tooltip.
- [enchants](https://pigaut.gitbook.io/orestack/items/item/enchants.md): Map of enchantment IDs to their levels.
- [attributes](https://pigaut.gitbook.io/orestack/items/item/attributes.md): List of attribute modifiers.
- [unplaceable](https://pigaut.gitbook.io/orestack/items/item/unplaceable.md): Prevents the player from placing this item as a block.
- [max-uses](https://pigaut.gitbook.io/orestack/items/item/max-uses.md): Maximum number of uses the item can ever reach.
- [uses](https://pigaut.gitbook.io/orestack/items/item/uses.md): Starting uses count when the item is created.
- [on-block-break](https://pigaut.gitbook.io/orestack/items/item/on-block-break.md): Triggered when the player breaks a block while holding this item.
- [on-swap](https://pigaut.gitbook.io/orestack/items/item/on-swap.md): Triggered when the player swaps the item to their off-hand (F key).
- [on-drop](https://pigaut.gitbook.io/orestack/items/item/on-drop.md): Triggered when the player drops the item (Q key).
- [on-left-click](https://pigaut.gitbook.io/orestack/items/item/on-left-click.md): Triggered on left-click against a block or air.
- [on-right-click](https://pigaut.gitbook.io/orestack/items/item/on-right-click.md): Triggered on right-click against a block or air.
- [on-left-click-block](https://pigaut.gitbook.io/orestack/items/item/on-left-click-block.md): Triggered on left-click specifically against a block.
- [on-left-click-air](https://pigaut.gitbook.io/orestack/items/item/on-left-click-air.md): Triggered on left-click against air only.
- [on-right-click-block](https://pigaut.gitbook.io/orestack/items/item/on-right-click-block.md): Triggered on right-click specifically against a block.
- [on-right-click-air](https://pigaut.gitbook.io/orestack/items/item/on-right-click-air.md): Triggered on right-click against air only.
- [Examples](https://pigaut.gitbook.io/orestack/items/examples.md)
- [Placeholders](https://pigaut.gitbook.io/orestack/items/placeholders.md): The following placeholders are available in contexts where the player is holding an item.