EQ2Emu
Discord Log in

Lua functions

AddQuestStepChat

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

Historical signature: AddQuestStepChat(quest, step, description, quantity, str_taskgroup, icon, npc_id)

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

Function: AddQuestStepChat(quest, step, description, quantity, str_taskgroup, icon, npc_id)

Description: Adds a displayable chat step in the players quest journal to point them towards an NPC their next action to Complete the step. The npc_id will need to match the destination NPC's spawn id if you select them and do /spawn details or refer to the spawn table in the database. This supports multiple npc_id's where only one must match.

Parameters:

  • quest (Quest) - Quest object representing quest.
  • step (int32) - Integer value step.
  • description (int32) - Integer value description.
  • quantity (int32) - Integer value quantity.
  • str_taskgroup (string) - String str_taskgroup.
  • icon (int32) - Integer value icon.
  • npc_id (int32) - Integer value npc_id.

Returns: None.

Connection lifetime: Each player or group-member connection resolved by this function is retained through the native call. A disconnect or reconnect during a callback cannot destroy that retained connection or switch the ongoing call to a replacement. A later Lua call resolves the current connection. This does not extend the lifetime of unrelated spawn or item userdata.

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.

AddQuestStepChat(Quest, 2, "Speak with Hartok.", 1, "I must speak to Hartok.", 11, 121309)

Evidence: server/Quests/Antonica/door_to_door_delivery.lua:37; binding EQ2Emu_lua_AddQuestStepChat.

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