osb/doc/lua/item.md
2023-06-20 14:33:09 +10:00

160 lines
2.4 KiB
Markdown

# item
The `item` table is available in all scripted items and contains functions relating to the item itself.
---
#### `String` item.name()
Returns the name of the item.
---
#### `size_t` item.count()
Returns the stack count of the item.
---
#### `size_t` item.setCount(`size_t` count)
Sets the item count. Returns any overflow.
---
#### `size_t` item.maxStack()
Returns the max number of this item that will fit in a stack.
---
#### `bool` item.matches(`ItemDescriptor` desc, [`bool` exactMatch])
Returns whether the item matches the specified item. If exactMatch is `true` then both the items' names and parameters are compared, otherwise only the items' names.
---
#### `bool` item.consume(`size_t` count)
Consumes items from the stack. Returns whether the full count was successfuly consumed.
---
#### `bool` item.empty()
Returns whether the item stack is empty.
---
#### `ItemDescriptor` item.descriptor()
Returns an item descriptor for the item.
---
#### `String` item.description()
Returns the description for the item.
---
#### `String` item.friendlyName()
Returns the short description for the item.
---
#### `int` item.rarity()
Returns the rarity for the item.
* 0 = common
* 1 = uncommon
* 2 = rare
* 3 = legendary
* 4 = essential
---
#### `String` item.rarityString()
Returns the rarity as a string.
---
#### `size_t` item.price()
Returns the item price.
---
#### `unsigned` item.fuelAmount()
Returns the item fuel amount.
---
#### `Json` item.iconDrawables()
Returns a list of the item's icon drawables.
---
#### `Json` item.dropDrawables()
Returns a list of the item's itemdrop drawables.
---
#### `String` item.largeImage()
Returns the item's configured large image, if any.
---
#### `String` item.tooltipKind()
Returns the item's tooltip kind.
---
#### `String` item.category()
Returns the item's category
---
#### `String` item.pickupSound()
Returns the item's pickup sound.
---
#### `bool` item.twoHanded()
Returns whether the item is two handed.
---
#### `float` item.timeToLive()
Returns the items's time to live.
---
#### `Json` item.learnBlueprintsOnPickup()
Returns a list of the blueprints learned on picking up this item.
---
#### `bool` item.hasItemTag(`String` itemTag)
Returns whether the set of item tags for this item contains the specified tag.
---
#### `Json` item.pickupQuestTemplates()
Returns a list of quests acquired on picking up this item.