EQ2Emu
Discord Log in

Lua functions

AddQuestStepKill

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

Historical signature: AddQuestStepKill(…) via current binding

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

Function: AddQuestStepKill(quest, step, description, quantity, percentage, taskgroup, icon, ...)

Description: Adds a kill quest step matching the supplied spawn definition IDs. A positive icon is set only when the requested quantity is also positive. If the quest already has a connected player, sends quest updates.

Parameters: quest: Quest userdata. step: unsigned step number. description: step text. quantity: unsigned required count. percentage: float update percentage passed to the quest-step engine. taskgroup: task-group text; empty means no group. icon: unsigned 16-bit icon ID; zero leaves it unset. ...: unsigned spawn definition IDs; omitted or zero terminates the list.

Returns: None. Invalid quest has no effect.

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. The shared kill-step helper reads the first target ID at argument eight. This is a contextual call pattern, not a tested standalone script.

AddQuestStepKill(Quest, 1, "I need to search Sabertooth battlers.", 6, 100, "I want to find the pages to the book.", 611, 120184)

Evidence: server/Quests/Antonica/ignatia_cellus_history_of_antonica.lua:15; binding EQ2Emu_lua_AddQuestStepKill.

Current registration: WorldServer/Lua/LuaInterface.cpp.