Skip to content

items

Jump to bottom
lilebonymace edited this page Feb 4, 2026 · 6 revisions

items : object[] (optional)

New item options. One element of this array is one MCM option. There are two types of options that you can create:

  1. Disabled-Enabled-Random-type options. These options represent one item (or a set of items given at once) that the player can set to Disabled, Enabled or Random (50% chance).
  2. Menu-type options: Disabled + Random + any number of menu options. These options represent a type of items (or sets of items given at once), from which the player can select a certain item or set it to Disabled or Random (a random option from the available ones with 100% chance).

If you want to change what the default item options give, you need not to create an addon but to edit SUR leveled lists.

Properties

fItem : form (required)

For Disabled-Enabled-Random-type options - the item(s) that this option gives to the player. It can be any type of item, including armor, weapons and LeveledItem (leveled list). If you want to add some randomization or give multiple different items via a single MCM option, you need to use a leveled list (create a new LeveledItem or use an existing one).

For menu-type options - you need to create a FormList record and specify it here. You can either keep the formlist empty and specify all items in the options property or pre-fill this formlist with items, or mix these two methods. Specifying an item in options allows you to set name and count for this item. For items not specified in options but present in the formlist the name will be automatically extracted (that doesn't work for leveled lists, since they don't have names).

iCount : integer (optional)

The count of items to add to the player. 1 if not set.

sName : string (optional)

The name of the MCM option. If not set, the name will be extracted from the item set in fItem. Leveled lists don't have names, so you have to specify a name if you use one. For menu-type options this property is required.

fItemByWealth : form[] (optional)

For Disabled-Enabled-Random-type options only. Allows to give different items depending on the player's Wealth. This is an array of 4 forms (same types as in "fItem") matching the 4 Wealth sets: Beggar, Poor, Medium and Wealthy. The one matching the selected Wealth will be given to the player instead of the one set in fItem (you can use that one in this array too, for one or more Wealth sets, and i recommend you do so). Same form can be present in the list multiple times.

"fItemByWealth" : [ BeggarForm, PoorForm, MediumForm, WealthyForm ]

options : object[] (optional)

For menu-type options only. One element of this array is one option inside the menu.

Properties:

  • fItem : form (required) - Same as fItem for Disabled-Enabled-Random-type options.
  • iCount : integer (optional) - The count of items to add to the player. 1 if not set. If iCount is set both on the item level and the option level, the resulting count will be the multiplication of the two counts.
  • sName : string (optional) - The name of this menu option. If this property is not set, the name will be extracted from the item set in fItem. Leveled lists don't have names, so you have to specify a name if you use one.
  • fItemByWealth : form[] (optional) - Same as fItemByWealth for Disabled-Enabled-Random-type options.

sDefaultOption : string (optional)

Sets the option selected by default in the MCM. Valid values: "Enabled" (not for menu-type options), "Random". If not set, the default value is "Disabled". Use fDefaultOption to choose a specific item for menu-type option

fDefaultOption : form (optional)

For menu-type options only. Sets the option selected by default in the MCM. Accepts the same form that you used in fItem inside "options"/in the formlist. If not set, the default value is "Disabled". Use sDefaultOption to make "Random" the default option.

Template

For Disabled-Enabled-Random-type options:

"items" :
[
    {
        "fItem" : "0x0|Plugin Name.esp",
        "iCount" : 1,
        "sName" : "MCM Option Name",
        "fItemByWealth" : [ "0x0|Plugin Name.esp", "0x0|Plugin Name.esp", "0x0|Plugin Name.esp", "0x0|Plugin Name.esp" ],
        "sDefaultOption" : "Random/Enabled"
    }
]

For menu-type options:

"items" :
[
    {
        "fItem" : "0x0|Plugin Name.esp",
        "iCount" : 1,
        "sName" : "MCM Option Name",
        "options" : [
            {
                "fItem" : "0x0|Plugin Name.esp",
                "iCount" : 1,
                "sName" : "Menu Option Name",
                "fItemByWealth" : [ "0x0|Plugin Name.esp", "0x0|Plugin Name.esp", "0x0|Plugin Name.esp", "0x0|Plugin Name.esp" ]
            }
        ],
        "sDefaultOption" : "Random",
        "fDefaultOption" : "0x0|Plugin Name.esp"
    }
]

Examples

3 Disabled-Enabled-Random type options:

  1. One broom. Named automatically.
  2. One flute. Named automatically.
  3. Three blood potions. A name is assigned.
"items" :
[
    {
        "fItem" : "0x6717F|Skyrim.esm"
    },
    {
        "fItem" : "0xDABA7|Skyrim.esm"
    },
    {
        "fItem" : "0x18EF3|Dawnguard.esm",
        "iCount" : 3,
        "sName" : "Blood Potions"
    }
]

From the Musical Instruments addon for Skyrim's Got Talent (both options are menu-type):

"items" :
[
    {
        "fItem" : "0xBC1567|Skyrim Unbound.esp",
        "sName" : "$SU_MusicalInstrument"
    },
    {
        "fItem" : "0x80A|Skyrim Unbound Addon - Skyrim's Got Talent.esp",
        "sName" : "$SU_MusicalInstrumentPlayingLevel",
        "options" : [
            {
                "fItem" : "0x805|Skyrim Unbound Addon - Skyrim's Got Talent.esp",
                "sName" : "$SU_SkyrimsGotTalentRank1"
            },
            {
                "fItem" : "0x806|Skyrim Unbound Addon - Skyrim's Got Talent.esp",
                "sName" : "$SU_SkyrimsGotTalentRank2"
            },
            {
                "fItem" : "0x807|Skyrim Unbound Addon - Skyrim's Got Talent.esp",
                "sName" : "$SU_SkyrimsGotTalentRank3"
            },
            {
                "fItem" : "0x808|Skyrim Unbound Addon - Skyrim's Got Talent.esp",
                "sName" : "$SU_SkyrimsGotTalentRank4"
            },
            {
                "fItem" : "0x809|Skyrim Unbound Addon - Skyrim's Got Talent.esp",
                "sName" : "$SU_SkyrimsGotTalentRank5"
            }
        ]
    }
]

Clone this wiki locally