armors

armors : object[] (optional)

New armor sets. One element of this array is one armor set option. New armor sets can be included into the randomization by adding AddToRandom flag.

If you want to add variants to the default armor sets or change them in any other way, you need not to create an addon but to edit SUR leveled lists.

Properties

fArmorSet : form (required)

LeveledItem (leveled list) or Outfit record that contains this armor set. If a leveled list or outfit containing all the armor parts you need already exists, you can just use it. If it doesn't, you can create a new one in xEdit or CK. Yes, you can't just list armor parts in JSON. There are no limitations on the structure and contents of the armor set list. The only rules:

• If you want to define a default headgear, include it into the armor set. Depending on the Headgear selected by the player, it will be either untouched, removed or replaced with a hood.
• If you want to specify a shield that should be given with your armor set, include it into the armor set. If the shield is not included, the defaullt one will be given (hide shield for clothes and light armor, iron shield for heavy armor). The shield will be automatically removed when it's not needed.

In fact you can add any additional items that need to be given with this armor set into it.

sName : string (required)

The name of this armor set.

sType : string (required)

The armor type of this armor. Valid values: "Clothes", "Light", "Heavy".

fAutoWeaponSet : form (optional)

Allows to specify a weapon set that will be always given with this armor set if Weapon Set is Random in the MCM. The form is the same FormList that you specified in fWeaponSet for your weapon set. Does the same as fAutoWeaponSetOn for weapon sets, no need to use both.

fAddToLists : form[] (optional)

Allows to add this armor set to the specified FormLists. Useful to add armor sets to default armor lists or armor lists used in location conditions of addon-added locations.

sFlags : string[] (optional)

Flags here are strings in the array. To add a flag, add it to the array. Flags:

• "AddToRandom" - Includes this armor set into the randomization (new armors are not included into the randomization without this flag).
• "EntryLevelArmor" - Includes this armor set into the randomization if Only Entry-Level Armors is enabled in the MCM. Does nothing for clothes, since SUR considers any clothes entry-level armor. Needed even without AddToRandom, because Only-Entry Level Armors is also applied to the armors specified in the armorIs/armorAddToRandom condition on the location. The default armors considered entry-level are: Hide, Fur, Iron, Stormcloak, Imperial, Imperial Light.
• "MageOutfit" - Sets this armor set as only suitable for mages. Prevents getting 0 spells with this armor set if spells are randomized, or getting this armor set randomly if the player disabled spells. This affects randomization.
• "VampireOutfit" - Sets this armor set as only suitable for vampires. Prevents getting this armor set randomly if the player is vampire.
• "NoRandomHood" - Prevents getting a college hood with this armor set when headgear is randomized, or getting this armor set when headgear is set to Hood.
• "NoRandomShield" - Prevents getting a shield with this armor set when weapons are randomized, or getting this armor set randomly when one-handed combination is set to Shield. Not needed for clothes, since shields are not randomly given with clothes.
• "Scimitar" - Prevents getting a 2H weapon or a 1H weapon other than scimitar or dagger with this armor set when weapons are randomized, or getting this armor set randomly if the player has selected to have a 2H weapon or a 1H weapon other than scimitar or dagger.

Template

"armors" :
[
    {
        "fArmorSet" : "0x0|Plugin Name.esp",
        "sName" : "Armor Set Name",
        "sType" : "Clothes/Light/Heavy",
        "fAutoWeaponSet" : "0x0|Plugin Name.esp",
        "fAddToLists" : [ "0x0|Plugin Name.esp", "0x0|Plugin Name.esp" ],
        "sFlags" : [ "AddToRandom", "EntryLevelArmor", "MageOutfit", "VampireOutfit", "NoRandomHood", "NoRandomShield", "Scimitar" ]
    }
]

Examples

1. Whiterun Guard Armor. Not added to randomization.
2. Forsworn Armor. Not added to randomization. Has flags to prevent getting hoods and shields randomly, because forsworn don't use them.
3. Chef Clothes. Added to randomization.

"armors" :
[
    {
        "fArmorSet" : "0xD33C6|Skyrim.esm",
        "sName" : "Whiterun Guard Armor",
        "sType" : "Light"
    },
    {
        "fArmorSet" : "0x43BD9|Skyrim.esm",
        "sName" : "Forsworn Armor",
        "sType" : "Light",
        "sFlags" : [ "NoRandomHood", "NoRandomShield" ]
    },
    {
        "fArmorSet" : "0x1BC5E|Skyrim.esm",
        "sName" : "Chef Clothes",
        "sType" : "Clothes",
        "sFlags" : [ "AddToRandom" ]
    }
]

For an example with custom leveled lists check the Thalmor addon. It uses leveled lists that have the same structure as the default SUR ones, though this structure is not required.