EQ2Emu
Discord Log in

Lua functions

AddQuestStepZoneLoc

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

Historical signature: AddQuestStepZoneLoc(quest, step, description, max_variation, str_taskgroup, icon, dest_x, dest_y, dest_z, dest_zone_id)

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

Function: AddQuestStepZoneLoc(quest, step, description, max_variation, str_taskgroup, icon, dest_x, dest_y, dest_z, dest_zone_id)

Description: Adds a quest step to the Player's journal requiring a new destination location be reached and can also supply a different zone id. The dest parameters can be repeated for multiple possible locations.

Parameters:

  • quest (Quest) - Quest object representing quest.
  • step (int32) - Integer value step.
  • description (int32) - Integer value description.
  • max_variation (int32) - Integer value max_variation.
  • str_taskgroup (string) - String str_taskgroup.
  • icon (int32) - Integer value icon.
  • dest_x (float) - Float value dest_x.
  • dest_y (float) - Float value dest_y.
  • dest_z (float) - Float value dest_z.
  • dest_zone_id (int32) - Integer value dest_zone_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. Arguments seven through ten provide one coordinate and zone ID group. The binding also handles arguments dynamically. This is a contextual call pattern, not a tested standalone script.

AddQuestStepZoneLoc(Quest, 1, "I must go to Crater Pond", 20, "I will seek out Crater Pond in Antonica.", 11, 85, -24, 502, 12)

Evidence: server/Quests/Antonica/a_tour_of_antonica.lua:14; binding EQ2Emu_lua_AddQuestStepZoneLoc.

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