Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:42:53Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Game}}
Returns the ids of all actions bound to a given key or button combination.

<pre>
actionIds = GetActionsForButtonCombination(deviceId, buttons)
</pre>

== Arguments ==
;deviceId : <code>number</code> – Input device, for example <code>SystemData.InputDevice.KEYBOARD</code>.
;buttons : <code>number-table</code> – Array of button ids that make up the combination.

== Returns ==
;actionIds : <code>table</code> – Array of action ids (<code>number</code>), indexed from 1. Empty if nothing is bound to the combination.

== Details ==
* A binding matches when its device is <code>deviceId</code>, it has exactly as many buttons as <code>buttons</code>, and each of its buttons appears in <code>buttons</code>. The order of the buttons does not matter.
* Each action id appears at most once in the result.
* Use [[API:GetActionNameFromId|GetActionNameFromId]] to turn an id into a name.
* The stock UI never calls this function.

== Errors ==
None.

== Example ==
A minimal example built from the signature (42 and 29 are the left Shift and left Ctrl ids listed in <code>easystem_utils/source/keyutils.lua</code>):
<pre>
local ids = GetActionsForButtonCombination( SystemData.InputDevice.KEYBOARD, { 42, 29 } )
for _, id in ipairs( ids ) do
local name = GetActionNameFromId( id )
end
</pre>

== See also ==
* [[API:GetBindingsForAction|GetBindingsForAction]]
* [[API:GetActionNameFromId|GetActionNameFromId]]
* [[API:GetButtonName|GetButtonName]]

API:GetActionsForButtonCombination - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)