Difference between revisions of "Equip"
Jump to navigation
Jump to search
imported>StDoodle m |
imported>Bale m |
||
(9 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | {{#vardefine:name|equip}} | + | {{ |
− | {{#vardefine:return_type|boolean}} | + | #vardefine:name|equip}}{{ |
+ | #vardefine:return_type|boolean}}{{ | ||
− | + | FunctionPage| | |
name={{#var:name}}| | name={{#var:name}}| | ||
− | |||
function1={{Function| | function1={{Function| | ||
Line 11: | Line 11: | ||
return_type={{#var:return_type}}| | return_type={{#var:return_type}}| | ||
return_also={{#var:return_also}}| | return_also={{#var:return_also}}| | ||
− | + | parameter1={{Param|item|equip_me}}| | |
}}| | }}| | ||
Line 25: | Line 25: | ||
}}| | }}| | ||
− | function_description=Attempts to equip the item {{pspan|equip_me}} in the slot {{pspan|where}} if specified, and returns true if the operation was successful, and false if it was not. If parameter {{pspan|where}} is not specified, it defaults to the "standard" place for such an item (main-hand for 1-handed weapons, first open slot for accessories or acc1 if no slots are open). If {{pspan|where}} is specified and {{pspan| | + | function_description=Attempts to equip the item {{pspan|equip_me}} in the slot {{pspan|where}} if specified, and returns true if the operation was successful, and false if it was not. If parameter {{pspan|where}} is not specified, it defaults to the "standard" place for such an item (main-hand for 1-handed weapons, first open slot for accessories or acc1 if no slots are open). |
+ | *If {{pspan|where}} is specified and {{pspan|equip_me}} is set to $item[none], this function will unequip whatever is in slot {{pspan|where}} and return true. | ||
+ | *If {{pspan|where}} is not specified and {{pspan|equip_me}} is set to $item[none], the function aborts and you get a funky error because that makes no sense. | ||
+ | *If you cannot equip {{pspan|equip_me}}, or {{pspan|where}} is supplied and the item cannot be used in that slot, you will be given an error message and this function will return false. | ||
+ | | | ||
− | + | code1={{CodeSample| | |
+ | title=Code Sample| | ||
+ | description=Equips the Swashbuckling Getup carefully to ensure that the parrot is in the second accessory slot.| | ||
+ | code= | ||
+ | <syntaxhighlight> | ||
+ | equip($item[eyepatch]); | ||
+ | equip($item[swashbuckling pants]); | ||
+ | equip($slot[acc2], $item[stuffed shoulder parrot]); | ||
+ | </syntaxhighlight> | ||
+ | }}| | ||
see_also={{SeeAlso|can_equip|equipped_amount|equipped_item|have_equipped}}| | see_also={{SeeAlso|can_equip|equipped_amount|equipped_item|have_equipped}}| | ||
cli_equiv=The CLI commands "equip" (and others, for specific slots) function similarly.| | cli_equiv=The CLI commands "equip" (and others, for specific slots) function similarly.| | ||
}} | }} | ||
− | + | ||
+ | [[Category:Equipment]] |
Latest revision as of 22:10, 21 May 2010
Function Syntax
boolean equip(slot where ,item equip_me )
- where is the slot to place the item in (optional)
- equip_me is the item to equip
Attempts to equip the item equip_me in the slot where if specified, and returns true if the operation was successful, and false if it was not. If parameter where is not specified, it defaults to the "standard" place for such an item (main-hand for 1-handed weapons, first open slot for accessories or acc1 if no slots are open).
- If where is specified and equip_me is set to $item[none], this function will unequip whatever is in slot where and return true.
- If where is not specified and equip_me is set to $item[none], the function aborts and you get a funky error because that makes no sense.
- If you cannot equip equip_me, or where is supplied and the item cannot be used in that slot, you will be given an error message and this function will return false.
Code Sample
Equips the Swashbuckling Getup carefully to ensure that the parrot is in the second accessory slot.
equip($item[eyepatch]);
equip($item[swashbuckling pants]);
equip($slot[acc2], $item[stuffed shoulder parrot]);
CLI Equivalent
The CLI commands "equip" (and others, for specific slots) function similarly.