Difference between revisions of "WornObject Script"

From the CreationKit Wiki
Jump to navigation Jump to search
imported>CraftySentinel
(Added some bland descriptions, fixed more typos)
imported>Egocarib
 
(2 intermediate revisions by 2 users not shown)
Line 24: Line 24:
:*Returns the worn objects max charge.
:*Returns the worn objects max charge.


:'''Float [[GetItemCharge - WornObject| GetItemCharge]](Actor ''akActor'', Int ''handSlot'', Int ''slotMask'')'''
:'''Float [[GetItemCharge - WornObject|GetItemCharge]](Actor ''akActor'', Int ''handSlot'', Int ''slotMask'')'''
:*Returns the current charge of the worn object.
:*Returns the current charge of the worn object.


:'''String [[GetDisplayName - WornObject| GetDisplayName]](Actor ''akActor'', Int ''handSlot'', Int ''slotMask'')'''
:'''String [[GetDisplayName - WornObject|GetDisplayName]](Actor ''akActor'', Int ''handSlot'', Int ''slotMask'')'''
:*Returns the name of the worn object (This is the name that is displayed)
:*Returns the name of the worn object (This is the name that is displayed)


:'''Bool [[SetDisplayName- WornObject| SetDisplayName]](Actor ''akActor'', Int ''handSlot'', Int ''slotMask'', String ''name'', Bool ''forced'')'''
:'''Bool [[SetDisplayName- WornObject|SetDisplayName]](Actor ''akActor'', Int ''handSlot'', Int ''slotMask'', String ''name'', Bool ''forced'')'''
:*Sets the display name of the worn object.
:*Sets the display name of the worn object.


:'''Enchantment [[GetEnchantment - WornObject| GetEnchantment]](Actor ''akActor'', Int ''handSlot'', Int ''slotMask''')'''
:'''Enchantment [[GetEnchantment - WornObject|GetEnchantment]](Actor ''akActor'', Int ''handSlot'', Int ''slotMask'')'''
:*Returns the player-made enchantment if there is one
:*Returns the player-made enchantment if there is one


:'''[[SetEnchantment - WornObject| SetItemMaxCharge]](Actor ''akActor'', Int ''handSlot'', Int ''slotMask'', Enchantment ''source'', Float ''maxCharge'')'''
:'''[[SetEnchantment - WornObject|SetEnchantment]](Actor ''akActor'', Int ''handSlot'', Int ''slotMask'', Enchantment ''source'', Float ''maxCharge'')'''
:*Changes an item's player-made enchantment to the specified Enchant and max charge.
:*Changes an item's player-made enchantment to the specified Enchant and max charge.


Line 48: Line 48:
:*Returns the nth Reference alias holding this worn object.
:*Returns the nth Reference alias holding this worn object.


== Notes ==
*These functions operate directly on worn/equipped items within the inventory. Valid values for ''handSlot'' are 0 (for left hand) or 1 (for right hand). Valid Slot Masks can be found [[Slot_Masks_-_Armor|here]]. Use slotMask of 0 for weapons.


[[Category:Scripting]]
[[Category:Scripting]]

Latest revision as of 00:07, 26 July 2014


Script for the manipulation of Worn Objects.


Definition

ScriptName WornObject


SKSE Global Functions

Float GetItemHealthPercent(Actor akActor, Int handSlot, Int slotMask)
  • Returns the item's tempering.
SetItemHealthPercent(Actor akActor, Int handSlot, Int slotMask, Float health)
  • Sets the item's tempering
SetItemMaxCharge(Actor akActor, Int handSlot, Int slotMask, Float maxCharge)
  • Sets the maximum charge of the worn object.(Only works on player enchants)
Float GetItemMaxCharge(Actor akActor, Int handSlot, Int slotMask)
  • Returns the worn objects max charge.
Float GetItemCharge(Actor akActor, Int handSlot, Int slotMask)
  • Returns the current charge of the worn object.
String GetDisplayName(Actor akActor, Int handSlot, Int slotMask)
  • Returns the name of the worn object (This is the name that is displayed)
Bool SetDisplayName(Actor akActor, Int handSlot, Int slotMask, String name, Bool forced)
  • Sets the display name of the worn object.
Enchantment GetEnchantment(Actor akActor, Int handSlot, Int slotMask)
  • Returns the player-made enchantment if there is one
SetEnchantment(Actor akActor, Int handSlot, Int slotMask, Enchantment source, Float maxCharge)
  • Changes an item's player-made enchantment to the specified Enchant and max charge.
CreateEnchantment(Actor akActor, Int handSlot, Int slotMask, Float maxCharge, MagicEffect[] effects, Float[] magnitudes, Int[] areas, Int[] durations)
  • Creates a new Enchantment on the worn object with the specified parameters.
Int GetNumReferenceAliases(Actor akActor, Int handSlot, Int slotMask)
  • Returns the number of reference aliases holding this worn object.
ReferenceAlias GetNthReferenceAlias(Actor akActor, Int handSlot, Int slotMask, Int n)
  • Returns the nth Reference alias holding this worn object.

Notes

  • These functions operate directly on worn/equipped items within the inventory. Valid values for handSlot are 0 (for left hand) or 1 (for right hand). Valid Slot Masks can be found here. Use slotMask of 0 for weapons.