wiki.sine.space | sinespace

Difference between revisions of "Scripting/SInventoryItem"

From wiki.sine.space
Jump to: navigation, search
(Defined and added simple example to SInventoryItem .Use() .Delete())
m
Line 1: Line 1:
Each SInventoryItem refers to a single item in the users inventory. See also [[Scripting/SInventory]] for master inventory access.
+
Each SInventoryItem refers to a single item in the users inventory. Below members may require inventory authorization, please see [[Scripting/SInventory]] for master inventory access.
  
 
==Members==
 
==Members==
Line 13: Line 13:
  
 
==Properties==
 
==Properties==
{{ScriptFunction|long|MasterID|{ get; }|The master ID for this item - also known as the Curator ID or Item ID, this is the ID for the master item from which this copy exists}}
+
{{ScriptFunction|long|MasterID|{ get; }|The master ID for this item - also known as the Curator ID or Item ID, this is the ID for the master item from which this copy exists.|5=
{{ScriptFunction|long|PlayerItemID|{ get; }|The instance ID for this item - this is guaranteed to be unique per inventory item}}
+
<pre>Items = Space.Inventory.Items
 +
itemMasterID = Items[1].MasterID</pre>}}
 +
{{ScriptFunction|long|PlayerItemID|{ get; }|The instance ID for this item - this is guaranteed to be unique per inventory item|5=
 +
<pre>Items = Space.Inventory.Items
 +
Items[1].PlayerItemID</pre>}}
 
{{ScriptFunction|string|Name|{ get; }|Returns the name of the inventory item}}
 
{{ScriptFunction|string|Name|{ get; }|Returns the name of the inventory item}}
 
{{ScriptFunction|string|Description|{ get; }|Returns the registered description of the inventory item in the users locale}}
 
{{ScriptFunction|string|Description|{ get; }|Returns the registered description of the inventory item in the users locale}}

Revision as of 13:49, 12 December 2020

Each SInventoryItem refers to a single item in the users inventory. Below members may require inventory authorization, please see Scripting/SInventory for master inventory access.

Members

StoreCustomData

bool StoreCustomData (string data);

Updates the inventory items custom data, and requests a synchronisation with the inventory server. It may not update on the server immediately, but all local calls will reflect the new data. Note: this request can be rate limited and should only be called from a user initiated action (such as clicking a button). Updates to custom data must not be initiated on a timer or regular automatic event. Access to this function can be blacklisted to specific creators if abused.

No example provided yet


Use

void Use ();

Player will 'Use' this item.

Items = Space.Inventory.Items
Items[1].Use() 


Delete

void Delete ();

Player will 'Delete' this item.

Items = Space.Inventory.Items
Items[1].Delete()


Properties

MasterID

long MasterID { get; }

The master ID for this item - also known as the Curator ID or Item ID, this is the ID for the master item from which this copy exists.

Items = Space.Inventory.Items
itemMasterID = Items[1].MasterID


PlayerItemID

long PlayerItemID { get; }

The instance ID for this item - this is guaranteed to be unique per inventory item

Items = Space.Inventory.Items
Items[1].PlayerItemID


Name

string Name { get; }

Returns the name of the inventory item

No example provided yet


Description

string Description { get; }

Returns the registered description of the inventory item in the users locale

No example provided yet


Brand

string Brand { get; }

Returns brand information about the item

No example provided yet


CustomData

string CustomData { get; }

Returns any custom data associated with this item, typically used for 'game' items

No example provided yet