Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:47:18Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Module}}
Enables or disables a UI module (addon) by name.

<pre>
ModuleSetEnabled(moduleName, enabled)
</pre>

== Arguments ==
;moduleName : <code>string</code> – The module's name, as in the <code>name</code> field of [[API:ModulesGetData|ModulesGetData]]. The comparison is case-sensitive.
;enabled : <code>boolean</code> – <code>true</code> to enable the module, <code>false</code> to disable it.

== Returns ==
Nothing.

== Details ==
* Only the module's enabled flag is changed. A module that is already running is not shut down, and a newly enabled module is not initialized. The change takes effect the next time modules are initialized, which is why the stock UI reloads the interface right after calling it.
* The flag is reported as <code>isEnabled</code> by [[API:ModulesGetData|ModulesGetData]].
* <code>enabled</code> must be a real boolean. Passing <code>nil</code> or a number raises an ''Invalid Parameters'' error.

== Errors ==
These are written to the UI log; the call returns normally.
* <code>Error in function call 'ModuleSetEnabled': %s is not a valid UiMod name.</code>

== Example ==
From <code>ea_uimodwindow/source/uimodwindow.lua</code>:
<pre>
function UiModWindow.SaveAndReloadMods()

WindowSetShowing( "UiModWindow", false )

for index, modData in ipairs( UiModWindow.modsListData ) do
ModuleSetEnabled( modData.name, modData.isEnabled )
end

BroadcastEvent( SystemData.Events.RELOAD_INTERFACE )

end
</pre>

== See also ==
* [[API:ModulesGetData|ModulesGetData]]
* [[API:ModulesInitializeAllEnabled|ModulesInitializeAllEnabled]]
* [[API:BroadcastEvent|BroadcastEvent]]

API:ModuleSetEnabled - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)