Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:47:57Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=RvR}}
Asks the server to move a keep upgrade to a new level. The stock UI calls it from the keep upgrade interaction window.

<pre>
PurchaseKeepUpgrade(upgradeId, targetLevel)
</pre>

== Arguments ==
;upgradeId : <code>number</code> – Id of the keep upgrade. Only the low 16 bits are used.
;targetLevel : <code>number</code> – Level the upgrade should go to. The stock UI uses the same call for raising and for lowering a level.

== Returns ==
Nothing.

== Details ==
* The request is sent as an interaction with the object the player last interacted with. Nothing is sent if there is no such object or if the network connection is not ready.
* The client does not check the id, the level, or the cost; the server decides.
* The stock keep upgrade window first calls [[API:CancelKeepUpgrade|CancelKeepUpgrade]] when an upgrade is running in the opposite direction, then calls this function.
* The function needs at least two arguments and only reads the last two.

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

== Example ==
From <code>default/ea_interactionwindow/source/interactionkeepupgrades.lua</code> (<code>EA_Window_InteractionKeepUpgrades.OnSave</code>):
<pre>
if (keepUpgrade.targetLevel < keepUpgrade.currentLevel) then
-- User is currently downgrading. We need to cancel the downgrade first.
CancelKeepUpgrade(keepUpgrade.id)
end
...
EA_Window_InteractionKeepUpgrades.AddUpgradeToActiveList(keepUpgrade.id)
PurchaseKeepUpgrade(keepUpgrade.id, keepUpgrade.localTargetLevel)
</pre>

== See also ==
* [[API:CancelKeepUpgrade|CancelKeepUpgrade]]
* [[API:GetKeepData|GetKeepData]]

API:PurchaseKeepUpgrade - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)