`AddCharacterTitle`

Registered in this checkout as EQ2Emu_lua_AddCharacterTitle; implementation found at WorldServer/Lua/LuaFunctions.cpp:13955.

Historical signature: AddCharacterTitle(Spawn, TitleName)

Parameter and behavior details in the historical explanation are under review against the current implementation.

Function: AddCharacterTitle(Spawn, TitleName)

Description: Provides the Spawn (Player Character) a new title they can apply from their Profile.

Parameters:

Player: Spawn - The Spawn (Player only) to provide the new title.
TitleName: String - Title to set to the Spawn.

Returns: SInt32 -1 if invalid, otherwise provides Title database ID.

Checked example

Active call in a local runtime Lua script. Argument count matches current fixed C++ readers. This is a contextual call pattern, not a tested standalone script.

AddCharacterTitle(Spawn, "Lord")

Evidence: server/SpawnScripts/IsleRefuge1/TitleBot.lua:16; binding EQ2Emu_lua_AddCharacterTitle.

Current registration: WorldServer/Lua/LuaInterface.cpp. Historical explanation: EQ2Emu Lua documentation.