https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3ACharacterSettingsImportUiProfileAPI:CharacterSettingsImportUiProfile - Revision history2026-10-17T20:46:23ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:CharacterSettingsImportUiProfile&diff=30223&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:41:11Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=CharacterSettings}}<br />
Replaces the contents of one of the current character's UI profiles with a copy of another profile folder.<br />
<br />
<pre><br />
CharacterSettingsImportUiProfile(profileName, sourcePath)<br />
</pre><br />
<br />
== Arguments ==<br />
;profileName : <code>wstring</code> – Name of the current character's profile to import into.<br />
;sourcePath : <code>wstring</code> – Folder to copy from. The stock UI passes the <code>path</code> field of a profile from [[API:CharacterSettingsGetAllUiProfiles|CharacterSettingsGetAllUiProfiles]].<br />
<br />
== Returns ==<br />
Nothing.<br />
<br />
== Details ==<br />
* The target profile must exist for the current character and be owned by it. Otherwise one of the errors below is logged and nothing is copied.<br />
* If <code>sourcePath</code> does not exist on disk, nothing happens.<br />
* Otherwise the target profile's folder is replaced with a copy of <code>sourcePath</code>.<br />
* If the target is the active profile, the client clears its active profile setting and starts a profile switch, the same kind of switch [[API:CharacterSettingsSetActiveUiProfile|CharacterSettingsSetActiveUiProfile]] starts.<br />
* The client then fires <code>SystemData.Events.CHARACTER_SETTINGS_UPDATED</code>.<br />
* Both arguments must be wide strings. The function needs at least two arguments and only reads the last two.<br />
<br />
== Errors ==<br />
Logged; the call does not raise a Lua error:<br />
* <code>ERROR Importing to UI Profile '%s'. Profile does not exist for this character.</code><br />
* <code>ERROR Importing UI Profile '%s'. You may not modify a profile owned by another character.</code><br />
<br />
== Example ==<br />
Importing into the active profile, from <code>ea_uiprofileswindow/source/manageuiprofileswindow.lua</code>:<br />
<pre><br />
function EA_Window_ManageUiProfiles.OnNewCharacterImportPromptDoImport( profileData )<br />
<br />
-- Import to the active profile<br />
CharacterSettingsImportUiProfile( EA_Window_ManageUiProfiles.characterSettings.activeUiProfile, profileData.path )<br />
end<br />
</pre><br />
<br />
== See also ==<br />
* [[API:CharacterSettingsExportUiProfile|CharacterSettingsExportUiProfile]]<br />
* [[API:CharacterSettingsGetAllUiProfiles|CharacterSettingsGetAllUiProfiles]]<br />
* [[API:CharacterSettingsCreateUiProfile|CharacterSettingsCreateUiProfile]]</div>Maintenance script