Lua functions

SummonDumbFirePet

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

Historical signature: SummonDumbFirePet(spawn, target, pet_id, x, y, z)

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

Function: SummonDumbFirePet(spawn, target, pet_id, x, y, z)

Description: Create a temporary attacking pet during a spell callback. It receives the owner's level and faction, the summoning spell identity, and a dumbfire brain that attacks the target and expires according to the spell duration. Setup completes before publication. A configured spawn script is assigned to the new pet and its spawn callback receives that pet; the caster's spawn script is not replaced.

Parameters:

  • spawn (Spawn) - Player or NPC entity that owns the temporary pet.
  • target (Spawn) - Valid entity to attack.
  • pet_id (uint32) - Nonzero NPC database spawn ID.
  • x, y, z (float, optional; default 0) - Position coordinates. Each zero coordinate individually uses the corresponding owner coordinate.

Returns: The created pet Spawn object, or nil for invalid owner/target, missing/invalid NPC definition, unavailable or resisted spell, or rejected admission. Failed construction retires its owned allocation. This pet does not occupy the normal GetPet() combat-pet slot.

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.

SummonDumbFirePet(Caster, Target, PetID, x, y, z)

Evidence: server/Spells/Mage/Sorcerer/Warlock/AcidStorm.lua:14; binding EQ2Emu_lua_SummonDumbFirePet.

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