EQ2Emu
Discord Log in

Lua functions

AddQuestStepObtainItem

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

Historical signature: AddQuestStepObtainItem(quest, step, description, quantity, percentage, str_taskgroup, icon, obtain_item_id)

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

Function: AddQuestStepObtainItem(quest, step, description, quantity, percentage, str_taskgroup, icon, obtain_item_id)

Description: Adds a quest step to the player's journal requiring an item be obtained for the complete action to be performed. Multiple obtain_item_id's can be passed with only one requiring to match. The player must obtain the item either by looting, item purchase (such as merchant, broker), summon item.

Parameters:

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

Returns: None.

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.

AddQuestStepObtainItem(Quest, 1,  "I need to collect six old weapons.", 6, 100,  ".", 5,  4583)

Evidence: server/Quests/Darklight/one_mans_waste.lua:18; binding EQ2Emu_lua_AddQuestStepObtainItem.

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