Inventory and Equipment Actions

All four actions accept the common item forms below. The target must expose an Actor or Container inventory; otherwise the action no-ops.

Form	Meaning
`item_id`	One item, count `1`.
`[item_id, ...]`	Each item, using the action's default count.
`{ item_id: count }`	Fixed count per item.
`{ item_id: { count?: integer	{ min?: integer, max: integer }, chance?: number

Item count range tables are sampled integer ranges and require max; their default min is 1. A chance is a number from 0 to 1, or { min?: number, max: number }; entry chance is tested independently. A nested item-detail map must provide count or chance. See random action ranges.

`add`

Shape: add: RecordId | RecordId[] | { RecordId: integer | { count?: integer | { min?: integer, max: integer }, chance?: number | { min?: number, max: number } } }

Creates and moves requested items into an Actor or Container inventory. String and array entries use count 1; map entries default to count 1 when only chance is supplied.

add:
  gold_001:
    count: 25
    chance: 0.5

Counts below one are not applied. An invalid target or failed inventory lookup returns a no-op.

`remove`

Shape: remove: RecordId | RecordId[] | { RecordId: integer | { count?: integer | { min?: integer, max: integer }, chance?: number | { min?: number, max: number } } }

Removes items from an Actor or Container inventory. A string requests one. Array entries use math.huge, so they remove all available copies of each listed record. Map counts request the specified amount and are capped at what is available.

remove:
  - glass claymore
  - ebony longsword

An absent item or unsupported target is a no-op. A partial available stack can be removed even when fewer than the requested count exists.

`equip`

Shape: equip: RecordId | RecordId[] | { RecordId: integer | { count?: integer | { min?: integer, max: integer }, chance?: number | { min?: number, max: number } } }

Queues a forced OpenMW UseItem event for each requested item on an Actor. If an item is missing, SSS creates the requested count before queueing the use. OpenMW decides whether the item equips or is consumed/used; this is not an equipment-slot API.

equip:
  imperial shield: 1

Non-actors, invalid counts, and failed inventory access no-op. The use is queued rather than a synchronous guarantee that the final equipment table has already changed.

`unequip`

Shape: unequip: RecordId | RecordId[] | { RecordId: integer | { count?: integer | { min?: integer, max: integer }, chance?: number | { min?: number, max: number } } }

Queues forced UseItem events for currently equipped matching items on an Actor. The requested count must already be equipped; missing items are not created.

unequip:
  imperial shield: 1

If fewer matching items are equipped than requested, that entry fails without partially queueing its requested count. As with equip, OpenMW processes the use event rather than the action synchronously.