https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3AModuleInitializeAPI:ModuleInitialize - Revision history2026-10-17T16:13:07ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:ModuleInitialize&diff=30606&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:47:15Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Module}}<br />
Initializes one loaded UI module (addon) by name, together with its dependencies.<br />
<br />
<pre><br />
ModuleInitialize(moduleName)<br />
</pre><br />
<br />
== Arguments ==<br />
;moduleName : <code>string</code> – The module's name as given in its <code>.mod</code> file. The comparison is case-sensitive.<br />
<br />
== Returns ==<br />
Nothing.<br />
<br />
== Details ==<br />
* The module must already be known to the client, through [[API:ModuleLoad|ModuleLoad]], [[API:ModulesLoadFromDirectory|ModulesLoadFromDirectory]] or [[API:ModulesLoadFromListFile|ModulesLoadFromListFile]].<br />
* A module that is already initialized, has already failed, or is disabled is left alone.<br />
* The module's dependencies are initialized first. If a required one is missing, disabled, fails, or leads back to a module that is still being set up, the module is not initialized, its load status records the failure (see <code>loadStatus</code> in [[API:ModulesGetData|ModulesGetData]]) and an error is logged.<br />
* Initializing a module loads its files and then creates the windows and calls the functions listed in its <code>OnInitialize</code> section. While this happens the module is the client's current module. When it is done, <code>UiMod %s Initialized.</code> is written to the UI log.<br />
* This is the single-module form of [[API:ModulesInitializeAllEnabled|ModulesInitializeAllEnabled]]. The stock UI never calls it.<br />
<br />
== Errors ==<br />
These are written to the UI log; the call returns normally.<br />
* <code>Error in function call 'ModuleInitialize': %s is not a valid UiMod name.</code><br />
* <code>Error Loading UiMod %s: Required Dependency %s not found.</code><br />
* <code>Error Loading UiMod %s: Required Dependency %s is not Enabled.</code><br />
* <code>Error Loading UiMod %s: Required Dependency %s failed to Initialize.</code><br />
* <code>Error Loading UiMod %s: Circular Dependency detected with %s. Load Order = %s</code> (see [[API:SetCheckForCircularDependencies|SetCheckForCircularDependencies]])<br />
<br />
== Example ==<br />
A minimal example built from the signature:<br />
<pre><br />
ModuleLoad( L"Interface/AddOns/MyAddon/MyAddon.mod", SystemData.UiModuleType.USER_ADDON, true )<br />
ModuleInitialize( "MyAddon" )<br />
</pre><br />
<br />
== See also ==<br />
* [[API:ModulesInitializeAllEnabled|ModulesInitializeAllEnabled]]<br />
* [[API:ModuleLoad|ModuleLoad]]<br />
* [[API:ModulesGetData|ModulesGetData]]<br />
* [[API:SetCheckForCircularDependencies|SetCheckForCircularDependencies]]</div>Maintenance script