Skip to content

AddItem

Give an Item based on its id or a flagvar containing it or transfer all the items selected to or from the storage if the last ItemList had a multi selection.

Syntax

(1)

|additem,itemtype,itemid|

(2)

|additem,itemtype,var,flagvar|

(3) (Not recommended, see remarks, only for transferring all multi selected items)

|additem|

Parameters

itemtype: 0 | 1 | 2

The inventory type this command should give the Item:

  • 0: Standard items.
  • 1: Key items.
  • 2: Storage items.

Any other value will cause an exception to be thrown.

var

This is just what determines how the Item id is obtained. Any other value will this parameter to be interpreted as the itemid.

itemid: int

The Item id to attempt to give. This must be a valid int or an exception will be thrown.

flagvar: int

The flagvar slot containing the item id. This must corresponds to a valid flagvar slot or an exception will be thrown.

Remarks

If the last ItemList was allowed to multiselect and a multi selection was performed, this overrides the behavior of this command to transfer to or from the storage depending on the listtype. Specifically, this will take all the selection from multiselect, remove them from the list it came from and add them to the other based on the listtype that tells which one is the source. Every parameters gets ignored so it behaves like syntax (3).

Using syntax (3) directly is however not recommended. It can only work if multiselect was allowed and processed on the last ItemList. If it wasn't, this will throw an exception because there will be no check to determine that there are no parameters. It is best to send parameters in case no multi selection was performed.

The other syntax forms adds an item, but unlike additemtoss, it will not check nor prompt for a toss. This means that it is possible to violate the constraint of having no more than the maximum amount of standard items or storage items by using this command. To check the quantity before giving the item, additemtoss or checkinvqtd are recommended, but it is always possible to manually perform this check in code.