Signature (‘ITM ‘)

Version (‘V1 ‘)

Unidentified Name (strref)

Identified Name (strref)

BG1, BG2, BGEE:
Replacement item (ITM)

PSTEE:
Drop sound - played when the item is dropped in the inventory (WAV)

Flags

Item type

Usability bitmask

Item animation

Min Level

• Treated as average of all active class levels, rounded up.

Min Strength (unused in BG1)

Min Strength Bonus (unused in BG1)
Note: A strength of 19 or above is considered to have a Strength Bonus of 0, and would therefore not be able to equip any weapon with a Strength Bonus restriction.

Kit Usability 1

Min Intelligence (unused in BG1)

Kit Usability 2

Min Dexterity (unused in BG1)

Kit Usability 3

Min Wisdom (unused in BG1)

Kit Usability 4

Min Constitution (unused in BG1)

Weapon Proficiency

Min Charisma

Price

Stack amount

Inventory icon (BAM)

Lore to ID

Ground icon (BAM)

Weight

Unidentified Description (strref)

Identified Description (strref)

Description icon (BAM)

Enchantment

Offset to extended headers

Count of extended headers

Offset to feature blocks

Index into equipping feature blocks

Count of equipping feature blocks

Attack type

• 0 ⟶ None
• 1 ⟶ Melee
• 2 ⟶ Ranged
• 3 ⟶ Magical
• 4 ⟶ Launcher

For Item abilities:

• Do NOT use 0|None, will crash the game.
• Only Magical abilities can be drained (along with opcode #243’s other restrictions).
• Type 4 cannot be used except from scripts (icon won’t show up in actionbar).

For Weapon abilities:

• Do NOT use 0|None, will crash the game.
• Melee: Ignores the projectile field (always uses #1|None). Valid for Weapon Styles.
• Ranged:
  • Utilizes projectile field.
  • Item cannot be equipped in off-hand, unless its itemtype can only be equipped in the off-hand slot, from ITEMTYPE.2DA.
  • If equipped in off-hand, it will attack as normal (at least for the offhand).
  • Off-hand weapon will be suppressed while this item ability is selected in mainhand (EE only).
• Magical: Identical to Melee, except that it can be drained.
• Launcher:
  • In the mainhand slots:
    • Ability cannot actually be selected, nor is the item considered “equipped” by script triggers or opcode #183.
    • Equipped effects, stats and on-hit effects are added to the currently selected weapon ability IF that ability requires a launcher of this type.
  • In the off-hand slot:
    • Item cannot be equipped in off-hand, unless its itemtype can only be equipped in the off-hand slot, from ITEMTYPE.2DA.
    • Attack cycle will stop when this weapon would have attacked (must be re-initiated manually or by script).
      • The creature will stop attacking when the off-hand attack would have occurred. Similar to pressing the group “Stop” button (F3).

ID Req.

• bit 0 ⟶ ID Required
• bit 1 ⟶ Non-ID Required

Location

• 0 ⟶ None
  • Ability will not be selectable through the UI (but still available to scripts and spell-casting opcodes).
• 1 ⟶ Weapon
  • Ability can be used/selected in Quick-weapon slots (when equipped in one of the mainhand/ammo/fist/magical weapon slots).
• 2 ⟶ Spell
  • SPL only.
• 3 ⟶ Equipment / Item
  • Ability can be selected from Quick-item slots, when equipped in one of those slots, or from the “Use Item (F8)” button if equipped elsewhere (except the Magical Weapon Slot).
• 4 ⟶ Innate
  • SPL only.
• 5+ ⟶ As 0.

Alternative dice sides

Use icon

Target type

• 0 ⟶ Invalid (cannot be selected)
• 1 ⟶ Living actor
  • Targets Portrait, Creature/Actor, Container, or Door. Checks Range.
• 2 ⟶ Inventory
  • Can’t be activated manually.
• 3 ⟶ Dead actor
  • As Living Actor. It really just ignores any Range requirement, including being in the same area.
• 4 ⟶ Any point within range
  • Targets location. Checks Range.
• 5 ⟶ Caster
  • Targets Self.
• 6 ⟶ Crash
  • Can’t be activated manually.
• 7 ⟶ Caster (EE only)
  • Targets Self. In particular:
    • Used instantly (even while the game is paused).
    • Ignores one item per round rule.
    • Ignores projectile (uses #1|None).

Target count

• Only usable by Item abilities, and only with Ability Targets 1, 3, or 4.
• Targeting reticle will display amount remaining while selecting targets.
• Double-clicking a target/location will target it for the remaining amount.
• Regardless of the number of targets, only a single “Charge” will be expended.
• This feature cannot be utilized by scripts.
  • Scripts will treat this field as if it’s always 1.

Range

Launcher required

• 0 ⟶ None
• 1 ⟶ Bow
  • Any Ranged ability with this field set to this value will require a weapon with the corresponding ITEMCAT.IDS (Item category) in one of the mainhand weapon slots (not off-hand, fist, or magical weapon slot).
• 2 ⟶ Crossbow
  • Any Ranged ability with this field set to this value will require a weapon with the corresponding ITEMCAT.IDS (Item category) in one of the mainhand weapon slots (not off-hand, fist, or magical weapon slot).
• 3 ⟶ Sling
  • Any Ranged ability with this field set to this value will require a weapon with the corresponding ITEMCAT.IDS (Item category) in one of the mainhand weapon slots (not off-hand, fist, or magical weapon slot).
• 40 ⟶ Spear
• 100 ⟶ Throwing Axe

In particular:

• It ONLY checks items for BOW / XBOW / SLING and will always use that item’s first ability header – it doesn’t matter what that ability’s Type is (Melee/Ranged/Magical/Launcher).
  • This also means that you can’t make an Arrow that requires being shot out of a Sword.
• ITEMCAT is offset 0x1C of the ITM file (which is also linked to ITEMTYPE.2DA).
• Only the Mainhand, Ammo, and Magical Weapon slots can utilize launchers. The off-hand ignores this field, while the fist slot uses it (only to crash).
• Weapons of any ITEMCAT can use this field, as long as it is equipped in one of the proper slots.
  • This also means that you can make a Sword that requires being shot out of a Bow.
• Bows, Crossbows, and Slings with multiple abilities can even use themselves as their required launcher.

Alternative dice thrown

Speed Factor

• See opcode #190.

Alternative damage bonus

THAC0 bonus

A successful hit will always occur if any of the conditions below is true

• This field is set to 32767.
• The target creature(s) is STATE_HELPLESS.
• The target is affected by Time Stop.

Dice sides

Primary Type (School)

• See MSCHOOL.2DA.

Dice thrown

Secondary Type

• See MSECTYPE.2DA.

Damage bonus

Damage type

• 0 ⟶ None
  • Deals Crushing damage, uses base AC (ignores all 4 specific AC).
    • If #dice = 0: Deals damage as normal, just no dice amount.
    • If #dice > 0: Sets target’s HP to Damage Dealt, ignores crushing resistance.
• 1 ⟶ Piercing
• 2 ⟶ Crushing
• 3 ⟶ Slashing
• 4 ⟶ Missile
• 5 ⟶ Fist
  • Deals non-lethal damage, but uses Crushing AC.
• 6 ⟶ Piercing/Crushing (Better)
  • Uses whichever damage type and AC the creature has the worst damage resistance against (regardless if its AC is better or worse). Uses Piercing if equal resistance.
• 7 ⟶ Piercing/Slashing (Better)
  • Uses whichever damage type and AC the creature has the worst damage resistance against (regardless if its AC is better or worse). Uses Piercing if equal resistance.
• 8 ⟶ Crushing/Slashing (Worse)
  • Uses whichever damage type and AC the creature has the better damage resistance against (regardless if its AC is better or worse). Uses Slashing if equal resistance.
• 9 ⟶ Blunt Missile
  • Same as None
    • Either it’s bugged or Blunt Missile has always been an IWD2-only feature.
    • It’s probably meant to deal crushing damage while using Missile AC.
• 10+ ⟶ Same as None

Count of feature blocks

Index into feature blocks

Max Charges

Charge depletion behaviour

• 0 ⟶ Item remains
  • Item becomes unusable (except as a weapon) when Max Charges reaches zero. Can be recharged by selling or by resting if it has the Recharge after resting flag.
• 1 ⟶ Item vanishes
  • Item disappears when Max Charges reaches zero. Can be recharged prior to reaching zero (through either method).
• 2 ⟶ Replace with used up
  • When Max Charges reaches zero, item is replaced with the item specified at offset 0x10. Can be recharged prior to reaching zero (through either method).
• 3 ⟶ Item recharges
  • This is very likely no different from Item remains or 4+, i.e. defaults to 0.

Flags

Projectile Animation (projectl.ids/missile.ids)

Melee animation

• It should total 100, but not mandatory on EE games.
• Not needed if Arrow/Bolt/Bullet is used.
• It should work as such:
  Engine rolls 0 – 99.
  • overhand range = 0 to (overhand - 1)
  • backhand range = overhand to (overhand + backhand - 1)
  • thrust range = (overhand + backhand) to (overhand + backhand + thrust - 1)

  A couple of examples:

  • With values 34, 33, and 33:
    • 0 – 33: Overhand
    • 34 – 66: Backhand
    • 67 – 99: Thrust
  • With values 100, 100, 100:
    • 0 – 99: Overhand
    • 100 – 199: Backhand (never used)
    • 200 – 299: Thrust (never used)
• Along with Is arrow?/Is bolt?/Is bullet?, it is only used for attack animations. If all are zero, no animation will be used for attacking. Activated Item abilities can leave them all 0, as they are not used.

Arrow qualifier / Is arrow?

• 0 ⟶ No
• 1 ⟶ Yes

It controls which firing animation the ability will use. It needs to be set on any launcher and/or ammo, but the launcher will override the ammo.

Bolt qualifier / Is bolt?

• 0 ⟶ No
• 1 ⟶ Yes

It controls which firing animation the ability will use. It needs to be set on any launcher and/or ammo, but the launcher will override the ammo.

Bullet qualifier / Is bullet?

• 0 ⟶ No
• 1 ⟶ Yes

It controls which firing animation the ability will use. It needs to be set on any launcher and/or ammo, but the launcher will override the ammo.

Opcode Number

Target type

• 0 ⟶ None
• 1 ⟶ Self
• 2 ⟶ Projectile target
• 3 ⟶ Party
• 4 ⟶ Everyone
• 5 ⟶ Everyone except party
• 6 ⟶ Caster group
• 7 ⟶ Target group
• 8 ⟶ Everyone except self
• 9 ⟶ Original caster

Power

Parameter 1

Parameter 2

Timing mode

• 0 ⟶ Instant/Limited
• 1 ⟶ Instant/Permanent
• 2 ⟶ Instant/While equipped
• 3 ⟶ Delay/Limited
• 4 ⟶ Delay/Permanent
• 5 ⟶ Delay/While equipped
• 6 ⟶ Limited after duration
• 7 ⟶ Permanent after duration
• 8 ⟶ Equipped after duration
• 9 ⟶ Instant/Permanent (after Death)
• 10 ⟶ Instant/Limited
• 4096 ⟶ Absolute duration

Dispel / Resistance

The default behaviour is that effects cannot be dispelled and ignore magic resistance.

• bit 0 ⟶ Can be dispelled, affected by magic resistance
• bit 1 ⟶ Ignores magic resistance (when used in combination with bit 0)

This can also be presented in the more traditional way:

• 0 ⟶ Natural/Nonmagical
• 1 ⟶ Can be dispelled/Affected by resistance
• 2 ⟶ Cannot be dispelled/Ignores resistance
• 3 ⟶ Can be dispelled/Ignores resistance

The only difference between 0 and 2 is that 0 will automatically convert to 2 when targeting yourself.

Duration

Probability 1

Probability 2

Resource

Dice Thrown / Maximum Level

Dice Sides / Minimum Level

Saving throw type

• bit 0 ⟶ Spells
• bit 1 ⟶ Breath
• bit 2 ⟶ Paralyze / Poison / Death
• bit 3 ⟶ Wands
• bit 4 ⟶ Petrify / Polymorph
• bit 10 ⟶ Ignore primary target (EE only)
• bit 11 ⟶ Ignore secondary target (EE only)
• bit 24 ⟶ Bypass mirror image (EE/TobEx only)
• bit 25 ⟶
  • Ignore difficulty (EE only)
  • Limit effect stacking (ToBEx only)
• bit 26 ⟶ TobEx internal (don’t use)

Saving Throw Bonus

TobEx: Stacking ID. Checked when bit 25 of the Saving Throw Type is set.

If two effects of the same opcode are applied, both have Limit Effect Stacking bit set, and both have the same stacking ID, then the latter applied effect is suspended in application until the former effect expires. Regardless of whether it is applied, the latter effect will expire at the same time that it would expire if it was applied. In other words, the total duration of some non-stacking effect opcode is not extended because more than one copy of the effect was applied.

Stacking IDs are unique to the opcode being applied. To maintain uniqueness of stacking IDs between different mods, one recommendation is to use the higher word of Special as the modder’s Infinity Engine Community Prefix, then use the lower word as an identifying ID. For example, 0x41360001 (‘A6’ 0x0001).