Equipment: Difference between revisions

From Kolmafia
Jump to navigation Jump to search
imported>Raeith
imported>Raeith
Sooo many datatype links >_<.
Line 2: Line 2:
<p><em>Time to get dressed!</em></p>
<p><em>Time to get dressed!</em></p>


<p><strong>boolean equip( item it )</strong><br />
<p><strong>boolean equip( [[%28ASHRM%29_Dataype_Constants#.24item.5Bconstant.5D|item it]] )</strong><br />
Puts on the specified item in the &#8220;natural&#8221; slot.  For example, it won&#8217;t equip a weapon to the off-hand and it will only put a accessory into an empty slot.</p>
Puts on the specified item in the &#8220;natural&#8221; slot.  For example, it won&#8217;t equip a weapon to the off-hand and it will only put a accessory into an empty slot.</p>


<p><strong>boolean unequip( item it )</strong><br />
<p><strong>boolean unequip( [[%28ASHRM%29_Dataype_Constants#.24item.5Bconstant.5D|item it]] )</strong><br />
Takes off one of the specified item.</p>
Takes off one of the specified item.</p>


<p><strong>boolean equip_slot( slot sl, item it )<br />
<p><strong>boolean equip_slot( [[%28ASHRM%29_Dataype_Constants#.24slot.5Bconstant.5D|slot sl]], [[%28ASHRM%29_Dataype_Constants#.24item.5Bconstant.5D|item it]] )<br />
boolean unequip_slot( slot sl )</strong><br />
boolean unequip_slot( [[%28ASHRM%29_Dataype_Constants#.24slot.5Bconstant.5D|slot sl]] )</strong><br />
Equipment management that targets a specific slot.</p>
Equipment management that targets a specific slot.</p>


<p><strong>slot item_to_slot( item it )</strong><br />
<p><strong>slot item_to_slot( [[%28ASHRM%29_Dataype_Constants#.24item.5Bconstant.5D|item it]] )</strong><br />
Returns the natural slot for the item, if it is equippable.</p>
Returns the natural slot for the item, if it is equippable.</p>


<p><strong>item current_equipment( slot sl )</strong><br />
<p><strong>item current_equipment( [[%28ASHRM%29_Dataype_Constants#.24slot.5Bconstant.5D|slot sl]] )</strong><br />
Returns the item currently equipped in the given slot.<br />
Returns the item currently equipped in the given slot.<br />
<em>Sample</em>:[[%28ASHRM%29_Code_Samples#Sample_2:_Battlefield_gather|Battlefield_gather]]</p>
<em>Sample</em>:[[%28ASHRM%29_Code_Samples#Sample_2:_Battlefield_gather|Battlefield_gather]]</p>


<p><strong>boolean have_equipped( item it )</strong><br />
<p><strong>boolean have_equipped( [[%28ASHRM%29_Dataype_Constants#.24item.5Bconstant.5D|item it]] )</strong><br />
Tells you if the specified item is currently equipped (as it would not otherwise show up in item_amount()).</p>
Tells you if the specified item is currently equipped (as it would not otherwise show up in item_amount()).</p>


<p><strong>boolean can_equip( item it )</strong><br />
<p><strong>boolean can_equip( [[%28ASHRM%29_Dataype_Constants#.24item.5Bconstant.5D|item it]] )</strong><br />
Tells you if you meet the requirements to equip the given item (regardless of whether you own it).</p>
Tells you if you meet the requirements to equip the given item (regardless of whether you own it).</p>


<p><strong>string weapon_type( item )</strong><br />
<p><strong>string weapon_type( [[%28ASHRM%29_Dataype_Constants#.24item.5Bconstant.5D|item it]] )</strong><br />
Returns a string indicating the type of weapon which was passed as a parameter.</p>
Returns a string indicating the type of weapon which was passed as a parameter.</p>


<p><strong>int weapon_hands( item it )</strong><br />
<p><strong>int weapon_hands( [[%28ASHRM%29_Dataype_Constants#.24item.5Bconstant.5D|item it]] )</strong><br />
Tells you if a weapon will keep you from using your off-hand slot.  Even if a weapon is described as being 3-handed, this function will return 2.<br />
Tells you if a weapon will keep you from using your off-hand slot.  Even if a weapon is described as being 3-handed, this function will return 2.<br />
<em>Sample</em>:[[%28ASHRM%29_Code_Samples#Sample_2:_Battlefield_gather|Battlefield_gather]]</p>
<em>Sample</em>:[[%28ASHRM%29_Code_Samples#Sample_2:_Battlefield_gather|Battlefield_gather]]</p>


<p><strong>boolean ranged_weapon( item it )</strong><br />
<p><strong>boolean ranged_weapon( [[%28ASHRM%29_Dataype_Constants#.24item.5Bconstant.5D|item it]] )</strong><br />
Tells you if a weapon&#8217;s chance of hitting the opponent is based on your Moxie instead of your Muscle.</p>
Tells you if a weapon&#8217;s chance of hitting the opponent is based on your Moxie instead of your Muscle.</p>


<p><strong>boolean have_familiar( familiar pet )</strong><br />
<p><strong>boolean have_familiar( [[%28ASHRM%29_Dataype_Constants#.24familiar.5Bconstant.5D|familiar pet]] )</strong><br />
Tells you if you have placed the specified familiar in your Terrarium (or have it equipped now).</p>
Tells you if you have placed the specified familiar in your Terrarium (or have it equipped now).</p>


<p><strong>boolean equip_familiar( familiar pet )</strong><br />
<p><strong>boolean equip_familiar( [[%28ASHRM%29_Dataype_Constants#.24familiar.5Bconstant.5D|familiar pet]] )</strong><br />
Takes the specified familiar out of your Terrarium.  Use equip() and unequip() to manage your familiar&#8217;s gear.</p>
Takes the specified familiar out of your Terrarium.  Use equip() and unequip() to manage your familiar&#8217;s gear.</p>


<p><strong>item familiar_equipment( familiar pet )</strong><br />
<p><strong>item familiar_equipment( [[%28ASHRM%29_Dataype_Constants#.24familiar.5Bconstant.5D|familiar pet]] )</strong><br />
Returns the most common piece of equipment that is specially designed for the familiar&#8217;s type.  If you want to find out what item is being equipped by your familiar of a specific species, then you would need to take that familiar out of the Terrarium with equip_familiar() and then check current_equipment( $slot[ familiar ]).</p>
Returns the most common piece of equipment that is specially designed for the familiar&#8217;s type.  If you want to find out what item is being equipped by your familiar of a specific species, then you would need to take that familiar out of the Terrarium with equip_familiar() and then check current_equipment( $slot[ familiar ]).</p>



Revision as of 11:42, 9 January 2007

Part 3 - Equipment

Time to get dressed!

boolean equip( item it )
Puts on the specified item in the “natural” slot. For example, it won’t equip a weapon to the off-hand and it will only put a accessory into an empty slot.

boolean unequip( item it )
Takes off one of the specified item.

boolean equip_slot( slot sl, item it )
boolean unequip_slot( slot sl )

Equipment management that targets a specific slot.

slot item_to_slot( item it )
Returns the natural slot for the item, if it is equippable.

item current_equipment( slot sl )
Returns the item currently equipped in the given slot.
Sample:Battlefield_gather

boolean have_equipped( item it )
Tells you if the specified item is currently equipped (as it would not otherwise show up in item_amount()).

boolean can_equip( item it )
Tells you if you meet the requirements to equip the given item (regardless of whether you own it).

string weapon_type( item it )
Returns a string indicating the type of weapon which was passed as a parameter.

int weapon_hands( item it )
Tells you if a weapon will keep you from using your off-hand slot. Even if a weapon is described as being 3-handed, this function will return 2.
Sample:Battlefield_gather

boolean ranged_weapon( item it )
Tells you if a weapon’s chance of hitting the opponent is based on your Moxie instead of your Muscle.

boolean have_familiar( familiar pet )
Tells you if you have placed the specified familiar in your Terrarium (or have it equipped now).

boolean equip_familiar( familiar pet )
Takes the specified familiar out of your Terrarium. Use equip() and unequip() to manage your familiar’s gear.

item familiar_equipment( familiar pet )
Returns the most common piece of equipment that is specially designed for the familiar’s type. If you want to find out what item is being equipped by your familiar of a specific species, then you would need to take that familiar out of the Terrarium with equip_familiar() and then check current_equipment( $slot[ familiar ]).

boolean have_outfit( string outfit_name )
Lets you know if you could wear a specified outfit right now, either an in-game or a custom outfit. A false result means either that you are missing one or more pieces of the outfit or that your stats are not high enough to equip all of the pieces.
Sample:Seltzer

boolean outfit( string outfit_name )
Wears the specified outfit.
Sample:Battlefield_gather