UseItemAbility(S:Object*,O:Target*,I:Slot*SLOTS,I:Ability*)

[morpheus562]

The IESDP used to have information regarding the below Action specific to IWDEE; however, it is no longer listed. Prior, the IESDP noted it was part of IWDEE but could be imported and used into Baldur's Gate.

UseItemAbility(S:Object*,O:Target*,I:Slot*SLOTS,I:Ability*)

The description for UseItem() states:

Quote

This action instructs the active creature to use the specified item (object) on the specified target (target). The ability number (i.e. extended header index) to use may be specified. This action is most often used to allow use of potions and wands. The item to be used must exist in the active creature’s inventory (not in a container within the inventory) - though it need not be equipped.

Is UseItemAbility still applicable, or how do I state the ability number within UseItem()?

[argent77]

Not all script action variants are listed in ACTION.IDS. You have to add the function signature first to make it accessible from scripts, like this:

APPEND ~ACTION.IDS~ ~34 UseItemAbility(S:Object*,O:Target*,I:Slot*SLOTS,I:Ability*)~ UNLESS ~UseItemAbility~
CLEAR_IDS_MAP

The latter command is important for WeiDU to register the ACTION.IDS changes.

[morpheus562]

12 hours ago, argent77 said:

Not all script action variants are listed in ACTION.IDS. You have to add the function signature first to make it accessible from scripts, like this:

APPEND ~ACTION.IDS~ ~34 UseItemAbility(S:Object*,O:Target*,I:Slot*SLOTS,I:Ability*)~ UNLESS ~UseItemAbility~
CLEAR_IDS_MAP

The latter command is important for WeiDU to register the ACTION.IDS changes.

This is exactly what I do to use this action within my scripts. What I'm asking is why is it no longer showing within the IESDP? Why does the IESDP state UseItem can specify the ability when that is actually not part of UseItems functionality?

What other script action variants are missing from the IESDP? That could be very helpful information to know as I rely on the IESDP to tell me how and what I can make the scripts do.

Edited September 28, 2023 by morpheus562

[argent77]

There are actually three different variants listed for action 34 in IESDP:

34 UseItem(S:Object*,O:Target*)

34 UseItemSlot(O:Target*,I:Slot*Slots)

34 UseItemSlotAbility(O:Target*,I:Slot*Slots,I:Ability*)

One of them can be used to select the ability. However, the item seems to be chosen by item slot instead of a resref.

But you're right about the missing fourth variant. It should be listed even though it isn't defined in ACTION.IDS. There's already a precedent for this. Action 293 StartDialogOverride() lists the undefined variant for talking with conversable items.

[morpheus562]

Are there other actions not specified within ACTION.IDS?

Edited September 28, 2023 by morpheus562
Created an issue request on the IESDP git

[lynx]

This was likely lost in the refactoring into proper data, where I think action.ids was used as the lookup table. So it should be easy to check if anything else was known, but also thus omitted.

[lynx]

I can see no reference in IESDP to this action from now to before iwdee was released. So HUH? But I added it.