Skip to content

tes3armor⚓︎

An armor game object.

This type inherits the following: tes3item, tes3physicalObject, tes3object, tes3baseObject

Properties⚓︎

armorRating⚓︎

The armor's defensive rating.

Returns:

  • result (number)

armorScalar⚓︎

Read-only. This is the maximal contribution to actor's total Armor Rating for this piece of armor. For vanilla armors, this is slot based. Cuirasses have armorScalar = 0.3, helmets, pauldrons, greaves, boots and shields have 0.1, while gauntlets and bracers have armorScalar = 0.05.

Returns:

  • result (number)

blocked⚓︎

The blocked state of the object.

Returns:

  • result (boolean)

boundingBox⚓︎

The bounding box for the object.

Returns:


deleted⚓︎

Read-only. The deleted state of the object.

Returns:

  • result (boolean)

disabled⚓︎

Read-only. The disabled state of the object.

Returns:

  • result (boolean)

enchantCapacity⚓︎

The object's enchantment capacity.

Returns:

  • result (number)

enchantment⚓︎

The enchantment used by the object.

Returns:


icon⚓︎

The path to the object's icon. Relative to Data Files\\icons\\.

Returns:

  • result (string)

id⚓︎

Read-only. The unique identifier for the object.

Returns:

  • result (string)

isClosedHelmet⚓︎

Read-only. This property is true for closed helmets, which are unequippable for beast races. Closed helmets cover the head body part, while open helmets cover hair. Always false for armor other than helmets.

See also isWearableByBeasts.

Returns:

  • result (boolean)

isLeftPart⚓︎

Determines if the armor is the left part of a pair.

Returns:

  • result (boolean)

isLocationMarker⚓︎

True if this object is an editor marker for a gameplay location. These include travel, intervention, prison, door, and interior north markers. Markers are invisible in-game.

Returns:

  • result (boolean)

isUsableByBeasts⚓︎

Read-only. If this property is true, beast races can wear this piece of armor. This property is false for closed helmets and armor that covers feet.

See also isClosedHelmet.

Returns:

  • result (boolean)

maxCondition⚓︎

The object's maximum condition.

Returns:

  • result (number)

mesh⚓︎

The path to the object's mesh. Relative to Data Files\\meshes\\.

Returns:

  • result (string)

modified⚓︎

The modification state of the object since the last save.

Returns:

  • result (boolean)

name⚓︎

The player-facing name for the object.

Returns:

  • result (string)

nextInCollection⚓︎

The next object in parent collection's list.

Returns:


objectFlags⚓︎

Read-only. The raw flags of the object.

Returns:

  • result (number)

objectType⚓︎

Read-only. The type of object. Maps to values in tes3.objectType.

Returns:


owningCollection⚓︎

The collection responsible for holding this object.

Returns:


parts⚓︎

Read-only. An array-style table of the tes3wearablePart data on the object.

Returns:


persistent⚓︎

The persistent flag of the object.

Returns:

  • result (boolean)

previousInCollection⚓︎

The previous object in parent collection's list.

Returns:


scale⚓︎

The object's scale. The value range is (0, 10).

Returns:

  • result (number)

sceneCollisionRoot⚓︎

The scene graph node for this object's physics collision, if its mesh has a root collision node.

Returns:


sceneNode⚓︎

The scene graph node for this object.

Returns:


script⚓︎

The script that runs on the object.

Returns:


slot⚓︎

The slot used by the armor. Maps to tes3.armorSlot namespace.

Returns:


slotName⚓︎

Read-only. The name of the slot used by the armor.

Returns:

  • result (string)

sourceless⚓︎

The soruceless flag of the object.

Returns:

  • result (boolean)

sourceMod⚓︎

Read-only. The filename (including the extension) of the mod that owns this object. It has nil value if the object was anything other than loaded from an ESP or ESM file.

Returns:

  • result (string)

stolenList⚓︎

A list of actors that the object has been stolen from.

Returns:


supportsLuaData⚓︎

If true, references of this object can store temporary or persistent lua data.

Returns:

  • result (boolean)

value⚓︎

The value of the object.

Returns:

  • result (number)

weight⚓︎

The weight of the object.

Returns:

  • result (number)

weightClass⚓︎

Read-only. The weight class of the armor. This value maps to tes3.armorWeightClass constants.

Returns:


Methods⚓︎

__tojson⚓︎

Serializes the object to json.

local string = myObject:__tojson()

Returns:

  • string (string)

calculateArmorRating⚓︎

Calculates what armor rating is provided for a given mobile actor.

myObject:calculateArmorRating(mobile)

Parameters:


createCopy⚓︎

Creates a copy of this object.

local newObject = myObject:createCopy({ id = ..., addToObjectList = ..., sourceless = ... })

Parameters:

  • params (table)
    • id (string): Optional. The new object's ID. If one is not provided, a randomly generated one will be used.
    • addToObjectList (boolean): Default: true. If true, the object will be added to the data handler. If this is false, the new object may not have a randomly generated ID. Do not use this without knowing the implications.
    • sourceless (boolean): Default: false. If true, the object will be made sourceless, and will not be serialized to the save game. If the object is copied outside of a save game, the object will always be sourceless.

Returns: