ITEMDEF

From SphereWiki
Jump to: navigation, search
Help
Available languages



An ITEMDEF block defines the basic properties of an item.

Properties

Here is a list of all item definition properties.


Name Read/Write Description
AMMOANIM RW Overrides TDATA4 for bow/crossbow type weapons.
AMMOANIMHUE RW Sets the color of the effect when firing bow/crossbow type weapons.
AMMOANIMRENDER RW Sets the render mode of the effect when firing bow/crossbow type weapons.
AMMOCONT RW Sets the container UID or ID where to search for ammos for bow/crossbow type weapons.
AMMOTYPE RW Overrides TDATA3 for bow/crossbow type weapons.
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.
LAYER RW Gets or sets the layer that the item will occupy when equipped (1 or 0).
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.
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.
RESDISPDNID 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.
SKILL RW Gets or sets the skill that is used with the weapon.
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 R 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 Override† 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)
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)
MULTIREGION left, top, right, bottom RW  ?? Gets or sets the boundaries of the multi (t_multi, t_multi_custom, t_ship).
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)
SHIPSPEED.TILES RW Y Gets or sets the speed that a ship will move at. (t_ship only)
SHIPSPEED.PERIOD RW Y 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.

Some ITEMDEF properties can be overridden using tags. For example, TAG.OVERRIDE.SHIPSPEED.PERIOD and TAG.OVERRIDE.SHIPSPEED.TILES can be set on individual ships in-game to affect their speed.

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)