Lua functions

CreateConversation

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

Historical signature: CreateConversation()

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

Function: CreateConversation([previous])

Creates an opaque conversation builder that owns its choice text and callback names.

Parameters:

  • previous (Conversation, optional): an existing builder to discard and invalidate before creating the new one.

Returns: A new Conversation userdata value.

Use AddConversationOption to add choices. A consumed, replaced or expired builder cannot be used again. Unsent values are released when the userdata is collected or expires. The builder does not own a Spawn, Item or Player.

Checked example

Active call in a local runtime Lua script. A missing conversation is replaced with a new one. This is a contextual call pattern, not a tested standalone script.

local con = CreateConversation()

Evidence: server/SpawnScripts/antonica/AGriffonTamer.lua:76; binding EQ2Emu_lua_CreateConversation.

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