https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3AModulesLoadFromDirectoryAPI:ModulesLoadFromDirectory - Revision history2026-10-18T06:58:43ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:ModulesLoadFromDirectory&diff=30612&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:47:21Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Module}}<br />
Loads the definitions of all UI modules (<code>.mod</code> files) found under a folder on disk.<br />
<br />
<pre><br />
ModulesLoadFromDirectory(directory, moduleType)<br />
</pre><br />
<br />
== Arguments ==<br />
;directory : <code>wstring</code> – Folder to search, for example <code>L"interface/MythicApprovedAddOns"</code> or <code>SystemData.Directories.AddOnsInterface</code>. It must be a wide string.<br />
;moduleType : <code>number</code> – A <code>SystemData.UiModuleType</code> value from 1 to 5. Every module found is given this type.<br />
<br />
== Returns ==<br />
Nothing.<br />
<br />
== Details ==<br />
* The folder must exist on disk; folders inside the game archives are not searched.<br />
* The modules are only registered with the client. Call [[API:ModulesInitializeAllEnabled|ModulesInitializeAllEnabled]] afterwards to run them.<br />
* The type is what [[API:ModulesGetData|ModulesGetData]] reports as <code>moduleType</code>; nothing in the <code>.mod</code> file sets it.<br />
* <code>directory</code> must be a wide string, or an ''Invalid Parameters'' error is raised.<br />
<br />
== Errors ==<br />
These are written to the UI log; the call returns normally.<br />
* <code>Error in function call 'ModulesLoadFromDirectory': No directory specified</code><br />
* <code>Error in function call 'ModulesLoadFromDirectory': Directory path %ls does not exist</code><br />
* <code>Error in function call 'ModulesLoadFromDirectory': Module Type %d is invalid.</code><br />
<br />
== Example ==<br />
From <code>interfacecore/interfacecore.lua</code>:<br />
<pre><br />
ModulesLoadFromDirectory( SystemData.Directories.AddOnsInterface, SystemData.UiModuleType.USER_ADDON )<br />
</pre><br />
<br />
Loading a custom UI and checking that it contained at least one module, also from <code>interfacecore/interfacecore.lua</code>:<br />
<pre><br />
ModulesLoadFromDirectory( SystemData.Directories.CustomInterface, SystemData.UiModuleType.CUSTOM_INGAME )<br />
<br />
-- Ensure atleast one .mod file was found<br />
local modsData = ModulesGetData()<br />
if( modsData[1] == nil )<br />
then<br />
return false<br />
end<br />
</pre><br />
<br />
== See also ==<br />
* [[API:ModulesLoadFromListFile|ModulesLoadFromListFile]]<br />
* [[API:ModuleLoad|ModuleLoad]]<br />
* [[API:ModulesInitializeAllEnabled|ModulesInitializeAllEnabled]]</div>Maintenance script