VoidExpanse/scope-items: Difference between revisions

From AtomicTorchWiki
Line 11: Line 11:
{{Scripting_api|AddItem|
{{Scripting_api|AddItem|
* int containerID, string item_type, int quantity|
* int containerID, string item_type, int quantity|
object with fields: item_id, xml_id, type, quantity||
object:
* int: item_id - game identifier of item (use it for Remove function)
* string: xml_id - xml item type ID
* string: type - can be "item" or "resource"
* int: quantity - amount of item added|
Add item of specific type and quantity to the specified container ID.
Add item of specific type and quantity to the specified container ID.
Returned object contains "type" field, which can have "item" or "resource" value.
}}
}}



Revision as of 09:24, 20 April 2015


Items scope

Used to access items containers, add or remove items.

Visibility: Global.

List of functions

AddItem
Arguments Returns Example
  • int containerID, string item_type, int quantity

object:

  • int: item_id - game identifier of item (use it for Remove function)
  • string: xml_id - xml item type ID
  • string: type - can be "item" or "resource"
  • int: quantity - amount of item added

Add item of specific type and quantity to the specified container ID.

Description
{{{5}}}


GetGameObjectContainerId
Arguments Returns Example
  • int objId

ID of the container

Description

Get container for any space object (currently it works for ship and crate containers).


GetItemsAndCargo
Arguments Returns Example
  • int containerID

ID of the container

Description

Returns array of items and cargo of the container. Array contains of objects with fields "item_id", "xml_id", "quantity".


GetShipInventoryContainerId
Arguments Returns Example
  • int shipID

ID of the container

Description

Returns ID of the ship inventory and cargo container. You can get it also by the GetGameObjectContainerId() function.


GetStationShopContainerId
Arguments Returns Example
  • int stationID

ID of the container

Description

Returns ID of the station shop container, which contains all the items available for sale on the station.


GetStationStorageContainerId
Arguments Returns Example
  • int stationID, int shipID

ID of the container

Description

Returns ID of the station storage container for the specific ship.


RemoveCargo
Arguments Returns Example
  • int containerID, string cargo_type, int quantity
<no result>
Description

Remove cargo from container.


RemoveItem
Arguments Returns Example
  • int container_id, int item_id, int quantity
<no result>
Description

Remove item from container (if quantity not specified or zero - remove all quantity).