Difference between revisions of "ITEMDEF"

From SphereWiki
Jump to: navigation, search
Line 9: Line 9:
 
{| border="1" cellspacing="4" cellpadding="4"
 
{| border="1" cellspacing="4" cellpadding="4"
 
| '''Name''' || '''Read/Write''' || '''Description'''
 
| '''Name''' || '''Read/Write''' || '''Description'''
 +
|-
 +
| [[ARMOR]] ''min,max'' || RW || Gets or sets the base protection that the armour will give.
 +
|-
 +
| [[ARMOR]].LO || R || Gets the minimum base protection the armour will give.
 +
|-
 +
| [[ARMOR]].HI || R || Gets the maximum base protection the armour will give.
 +
|-
 +
| [[BASEID]] || R || Gets the defname of the item if set, otherwise the ID.
 +
|-
 +
| [[CAN]] || RW || Gets or sets attributes for the item. See can_i_flags in sphere_defs.scp.
 +
|-
 +
| [[DAM]] ''min,max'' || RW || Gets or sets the base damage that the weapon will deal.
 +
|-
 +
| [[DAM]].LO || R || Gets the minimum base damage the weapon will deal.
 +
|-
 +
| [[DAM]].HI || R || Gets the maximum base damage the weapon will deal.
 
|-
 
|-
 
| [[DEFNAME]] || RW || Gets or sets defname of the item
 
| [[DEFNAME]] || RW || Gets or sets defname of the item
Line 21: Line 37:
 
|-
 
|-
 
| [[FLIP]] || RW || Gets or sets whether or not the item automatically rotates when dropped.
 
| [[FLIP]] || RW || Gets or sets whether or not the item automatically rotates when dropped.
 +
|-
 +
| [[HEIGHT]] || RW || Gets or sets the height of the item.
 
|-
 
|-
 
| [[ID]] || RW || Gets or sets the ID of the item to inherit property values from.
 
| [[ID]] || RW || Gets or sets the ID of the item to inherit property values from.
 +
|-
 +
| [[INSTANCES]] || R || Returns the number of this item that exist in the world.
 
|-
 
|-
 
| [[ISARMOR]] || R || Gets whether or not the item is considered to be armour.
 
| [[ISARMOR]] || R || Gets whether or not the item is considered to be armour.
 
|-
 
|-
 
| [[ISWEAPON]] || R || Gets whether or not the item is considered to be a weapon.
 
| [[ISWEAPON]] || R || Gets whether or not the item is considered to be a weapon.
 +
|-
 +
| [[NAME]] || RW || Gets or sets the name of the item.
 +
|-
 +
| [[RANGE]] ''min, max'' || RW || Gets or sets the range of the weapon.
 +
|-
 +
| [[RANGEH]] || R || Gets the maximum range of the weapon.
 +
|-
 +
| [[RANGEL]] || R || Gets the minimum range of the weapon.
 
|-
 
|-
 
| [[SKILL]] || RW || Gets or sets the skill that is used with the weapon.
 
| [[SKILL]] || RW || Gets or sets the skill that is used with the weapon.
Line 36: Line 64:
 
| [[REPLICATE]] || RW || Gets or sets whether or not multiple instances of the item can be crafted at once.
 
| [[REPLICATE]] || RW || Gets or sets whether or not multiple instances of the item can be crafted at once.
 
|-
 
|-
−
| [[RESDISPNID]] || RW || Gets or sets the item ID to display as to clients who don't have a high enough RESDISP to see the item.
+
| [[RESDISPDNHUE]] || RW || Gets or sets the colour to display as to clients who don't have a high enough [[RESDISP]] to see the item.
 +
|-
 +
| [[RESDISPNID]] || RW || Gets or sets the item ID to display as to clients who don't have a high enough [[RESDISP]] to see the item.
 +
|-
 +
| [[RESLEVEL]] || RW || Gets the minimum [[RESDISP]] required for a client to see the item.
 
|-
 
|-
 
| [[RESMAKE]] || R || Returns the names of the resources needed to craft the item.
 
| [[RESMAKE]] || R || Returns the names of the resources needed to craft the item.
 +
|-
 +
| [[RESOURCES]] || RW || Gets or sets the resources that are needed to craft the item.
 +
|-
 +
| [[RESOURCES]]''.COUNT'' || R || Gets the number of different resources that are needed to craft the item.
 +
|-
 +
| [[RESOURCES]]''.n.KEY'' || R || Gets the [[BASEID]] of the nth resource needed to craft the item. (zero-based)
 +
|-
 +
| [[RESOURCES]]''.n.VAL'' || R || Gets the amount of the nth resource needed to craft the item. (zero-based)
 
|-
 
|-
 
| [[REQSTR]] || RW || Gets or sets the amount of strength needed to equip the item.
 
| [[REQSTR]] || RW || Gets or sets the amount of strength needed to equip the item.
Line 49: Line 89:
 
|-
 
|-
 
| [[SPEED]] || RW || Gets or sets the speed of the weapon.
 
| [[SPEED]] || RW || Gets or sets the speed of the weapon.
 +
|-
 +
| [[TAG]]''.name'' || RW || Gets or sets the value of a TAG.
 
|-
 
|-
 
| [[TDATA1]] || RW || Gets or sets the TDATA1 value of the item.
 
| [[TDATA1]] || RW || Gets or sets the TDATA1 value of the item.
Line 57: Line 99:
 
|-
 
|-
 
| [[TDATA4]] || RW || Gets or sets the TDATA4 value of the item.
 
| [[TDATA4]] || RW || Gets or sets the TDATA4 value of the item.
 +
|-
 +
| [[TEVENTS]] || RW || Gets a list of events attached the item, or adds an event to the item.
 
|-
 
|-
 
| [[TFLAGS]] || RW || Gets or sets the flags of the item from tiledata.mul.
 
| [[TFLAGS]] || RW || Gets or sets the flags of the item from tiledata.mul.

Revision as of 18:59, 6 June 2009


An ITEMDEF block defines the basic properties of an item.

Properties

Here is a list of all item definition properties.


Name Read/Write Description
ARMOR min,max RW Gets or sets the base protection that the armour will give.
ARMOR.LO R Gets the minimum base protection the armour will give.
ARMOR.HI R Gets the maximum base protection the armour will give.
BASEID R Gets the defname of the item if set, otherwise the ID.
CAN RW Gets or sets attributes for the item. See can_i_flags in sphere_defs.scp.
DAM min,max RW Gets or sets the base damage that the weapon will deal.
DAM.LO R Gets the minimum base damage the weapon will deal.
DAM.HI R Gets the maximum base damage the weapon will deal.
DEFNAME RW Gets or sets defname of the item
DISPID RW Gets or sets the ID to display as to clients.
DUPEITEM RW Gets or sets the defname of the item that this is a duplicate/rotation of (see DUPELIST).
DUPELIST item_defname, item_defname, ... RW Gets or sets a comma-separated list of items that this item will cycle through when rotated.
DYE RW Gets or sets whether or not the item can be dyed using dye tubs (1 or 0).
FLIP RW Gets or sets whether or not the item automatically rotates when dropped.
HEIGHT RW Gets or sets the height of the item.
ID RW Gets or sets the ID of the item to inherit property values from.
INSTANCES R Returns the number of this item that exist in the world.
ISARMOR R Gets whether or not the item is considered to be armour.
ISWEAPON R Gets whether or not the item is considered to be a weapon.
NAME RW Gets or sets the name of the item.
RANGE min, max RW Gets or sets the range of the weapon.
RANGEH R Gets the maximum range of the weapon.
RANGEL R Gets the minimum range of the weapon.
SKILL RW Gets or sets the skill that is used with the weapon.
LAYER RW Gets or sets the layer that the item will occupy when equipped (1 or 0).
REPAIR RW Gets or sets whether or not the item can be repaired (1 or 0).
REPLICATE RW Gets or sets whether or not multiple instances of the item can be crafted at once.
RESDISPDNHUE RW Gets or sets the colour to display as to clients who don't have a high enough RESDISP to see the item.
RESDISPNID RW Gets or sets the item ID to display as to clients who don't have a high enough RESDISP to see the item.
RESLEVEL RW Gets the minimum RESDISP required for a client to see the item.
RESMAKE R Returns the names of the resources needed to craft the item.
RESOURCES RW Gets or sets the resources that are needed to craft the item.
RESOURCES.COUNT R Gets the number of different resources that are needed to craft the item.
RESOURCES.n.KEY R Gets the BASEID of the nth resource needed to craft the item. (zero-based)
RESOURCES.n.VAL R Gets the amount of the nth resource needed to craft the item. (zero-based)
REQSTR RW Gets or sets the amount of strength needed to equip the item.
SKILLMAKE RW Gets or sets the list of skills needed to craft the item.
SKILLMAKE.n.KEY R Gets the name of the nth skill needed to craft the item.
SKILLMAKE.n.VAL R Gets the amount of the nth skill needed to craft the item.
SPEED RW Gets or sets the speed of the weapon.
TAG.name RW Gets or sets the value of a TAG.
TDATA1 RW Gets or sets the TDATA1 value of the item.
TDATA2 RW Gets or sets the TDATA2 value of the item.
TDATA3 RW Gets or sets the TDATA3 value of the item.
TDATA4 RW Gets or sets the TDATA4 value of the item.
TEVENTS RW Gets a list of events attached the item, or adds an event to the item.
TFLAGS RW Gets or sets the flags of the item from tiledata.mul.
TWOHANDS RW Gets or sets whether or not the item occupies both hands when equipped (layer_hand2)
TYPE RW Gets or sets the item's type.
VALUE RW Gets or sets the base value of the item.
WEIGHT RW Gets or sets the weight of the item.


Multi Definitions

For multi items (t_multi, t_multi_custom, t_ship), the ITEMDEF has additional properties.

Properties

Here is a list of all multi definition properties.

Name Read/Write Description
BASECOMPONENT R Gets how many static components the multi has in the multi.mul file.
BASECOMPONENT.n.KEY R Accesses the multi's static components directly from the multi.mul file. (ID,DX,DY,DZ,D,VISIBLE)
MULTIREGION left, top, right, bottom RW Gets or sets the boundaries of the multi (t_multi, t_multi_custom, t_ship).
COMPONENT R Gets how many dynamic components have been defined for the multi.
COMPONENT.n.KEY R Accesses the multi's dynamic components. (ID,DX,DY,DZ,D)
COMPONENT item_defname, dx, dy, dz W Defines a dynamic component to the multi that will be spawned along with it (e.g. doors and house sign)
REGIONFLAGS RW Gets or sets the flags that will be set on the multi's region.
SHIPSPEED tiles, period RW Gets or sets the speed that a ship will move at. (t_ship only)
TSPEECH RW Gets a list of attached SPEECH handlers, or adds a handler to the multi.


Examples

//
// Blue Gold
//
[ITEMDEF i_gold_blue]
ID=i_gold      // inherits from i_gold
NAME=Blue Gold // named Blue Gold
TYPE=t_gold    // is type t_gold
VALUE=10       // valued at gold

ON=@Create
    COLOR = colors_blue
    
    
    //
    // Small Stone and Plaster House (from default script pack)
    //
[ITEMDEF 04064]                           // item ID 0x4064 (in mul files)
DEFNAME=i_multi_house_stone_plaster_small
NAME=Small Stone and Plaster House
TYPE=t_multi
VALUE=43800                               // valued at 43800 gold
MULTIREGION=-3,-3,3,4                     // size of the region, relative to location of the item
COMPONENT=i_door_wood,0,3,7               // adds a door at 0,3,7 (relative to location of the item)
COMPONENT=i_sign_brass_2,2,4,5            // adds a brass sign at 2,4,5 (relative to location of the item)
Retrieved from "https://wiki.spherecommunity.net/index.php?title=ITEMDEF&oldid=164"