weapons

weapons : object[] (optional)

New weapons (including arrows and bolts). Specific weapons can't be selected from the MCM directly: the player or the randomization selects a weapon type and a weapon set, and SUR chooses a random weapon that belongs to both the weapon type and the weapon set. By default there's only one weapon for each weapon type+set combination, but addons can add more. New weapons added to the default weapon types and sets can be get randomly when that type/set is selected. In fact a weapon doesn't have to belong to a weapon set: if there are no weapons of the selected type that belong to the selected weapon set, the iron and steel sets, a random weapon belonging to this weapon type will be picked.

Properties

fWeapon : form (required)

The weapon (a Weapon, Ammo or LeveledItem (leveled list) record).

sType : string (optional)

If your weapon belongs to one of the default weapon types, this must be the name of that type. Crossbows and Bolts are default types too, they're just hidden if no addons add anything to them. Valid values: "Dagger", "Sword", "Axe", "Mace", "Scimitar", "Greatsword", "Battleaxe", "Warhammer", "Bow", "Crossbow", "Arrow", "Bolt".

fWeaponTypeList : form (optional)

If your weapon belongs to an addon-added weapon type, this is the FormList of that weapon type (the record specified in fWeaponTypeList for that weapon type). This can be used to add weapons to weapon types added by other addons, as well as to the ones from your addon if you don't want to pre-fill the formlist (if you pre-fill it, you don't need to use this property).

sWeaponSet : string (optional)

If your weapon belongs to one of the default weapon sets, this must be the name of that weapon set. Valid values: "Iron", "Steel", "Imperial", "Orcish", "Elven", "Ancient Nord".

fWeaponSet : form (optional)

If your weapon belongs to an addon-added weapon set, this is the FormList of that weapon set (the record specified in fWeaponSet for that weapon set). This can be used to add weapons to weapon sets added by other addons, as well as to the ones from your addon if you don't want to pre-fill the formlist (if you pre-fill it, you don't need to use this property).

Template

"weapons" : 
[
    {
        "fWeapon" : "0x0|Plugin Name.esp",
        "sType" : "Dagger/Sword/Axe/Mace/Scimitar/Greatsword/Battleaxe/Warhammer/Bow/Crossbow/Arrow/Bolt",
        "fWeaponTypeList" : "0x0|Plugin Name.esp",
        "sWeaponSet" : "Iron/Steel/Imperial/Orcish/Elven/Ancient Nord",
        "fWeaponSet" : "0x0|Plugin Name.esp"
    }
]

Examples

From the Vanilla Crossbow addon:

"weapons" : 
[
    {
        "fWeapon" : "0x801|Dawnguard.esm",
        "sType" : "Crossbow",
        "sWeaponSet" : "Steel"
    },
    {
        "fWeapon" : "0xBB3|Dawnguard.esm",
        "sType" : "Bolt",
        "sWeaponSet" : "Steel"
    }
]

See the Beyond Skyrim Morrowind - Bonemold Weapon Pack addon for an example with a new weapon set.