Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:40:20Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Interact}}
Marks one choice reward of the current quest as selected.

<pre>
AddSelectedReward(rewardIndex)
</pre>

== Arguments ==
;rewardIndex : <code>number</code> – Number of the choice reward, <code>1</code> to <code>25</code>.

== Returns ==
Nothing useful. See Details.

== Details ==
* The client keeps a set of selected choice rewards. This function adds <code>rewardIndex</code> to it. Values outside 1–25 are ignored.
* Nothing is sent to the server by this call. The client reads the selection later, when it builds the interaction request that completes the quest. The stock quest window selects rewards first and then broadcasts <code>SystemData.Events.INTERACT_COMPLETE_QUEST</code>.
* The client does not check how many rewards the quest allows. The stock UI compares against <code>GameData.InteractQuestData.maxChoices</code> itself.
* After a successful call the function reports one return value without pushing one, so Lua receives the value on top of the stack, which is the last argument passed. Do not rely on this.
* The function needs at least one argument and only reads the last one.

== Errors ==
None besides the generic ''Invalid Parameters'' message when the argument is not a number.

== Example ==
Selecting the only allowed reward, from <code>default/ea_interactionwindow/source/interactionquestwindow.lua</code>:
<pre>
if( EA_Window_InteractionQuest.choiceRewardsData[btn].selected == true )
then
ClearSelectedRewards()
AddSelectedReward( btn )
end
</pre>

== See also ==
* [[API:RemoveSelectedReward|RemoveSelectedReward]]
* [[API:ClearSelectedRewards|ClearSelectedRewards]]

API:AddSelectedReward - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)