Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:47:24Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Pregame}}
Sends a new name for the selected character to the server, for characters that must be renamed because of a naming conflict.

<pre>
NamingConflictRequestNewName(newName)
</pre>

== Arguments ==
;newName : <code>wstring</code> – The new character name. It must be a wide string: <code>L"Name"</code> works, <code>"Name"</code> does not.

== Returns ==
Nothing.

== Details ==
* The call only works in the pregame state. At any other time it does nothing.
* An empty name is ignored.
* Otherwise the client stores the name on the character select screen and sends a name request for the currently selected character slot to the server.
* The answer arrives later. The stock rename window registers for <code>SystemData.Events.CHARACTER_PREGAME_NAMING_CONFLICT_RESPONSE</code> to get it, and is opened on <code>CHARACTER_PREGAME_NAMING_CONFLICT_POP_UP_WINDOW</code>.
* Passing an ordinary Lua string or a number raises an ''Invalid Parameters'' error.

== Errors ==
None besides the generic ''Invalid Parameters'' message when the argument is not a wide string.

== Example ==
From <code>interfacecore/source/renamewindow.lua</code>:
<pre>
local newName = TextEditBoxGetText( windowName.."TextInput" )
if( newName ~= L"" )
then
LabelSetText( windowName.."MessageText", GetPregameString( StringTables.Pregame.LABEL_RENAME_VALIDATING_NEW_NAME) )
EA_Window_Rename.LockInput()
NamingConflictRequestNewName( newName )
else
LabelSetText( windowName.."MessageText", GetPregameString( StringTables.Pregame.LABEL_RENAME_VALIDATING_ERROR ) )
end
</pre>

== See also ==
* [[API:TextEditBoxGetText|TextEditBoxGetText]]
* [[API:PregameSetCharacterSelectPage|PregameSetCharacterSelectPage]]

API:NamingConflictRequestNewName - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)