Lua functions

CompleteTransmute

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

Historical signature: CompleteTransmute(…) via current binding

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

Function: CompleteTransmute(player)

Description: Complete the transmutation bound to the currently executing Transmute Item spell. The cast must originate from a confirmed transmutation request. Calling this function from an unrelated spell, timer, or ordinary script event has no effect.

Parameters:

  • player (Player spawn): the original player who confirmed this cast's input item.

Returns: None.

Behavior:

  • Uses the original item allocation, player, connection generation, and scene captured for this cast. A later prompt or cast cannot replace its input.
  • The original input must still be eligible, carried by that player, and available for exclusive use. Missing, moved, replaced, busy, or otherwise invalid inputs produce no materials.
  • Prepares all rolled materials before committing. Input consumption, all material placements or stacks, and the input's pending database deletion publish together. A failed preparation leaves the input and inventory unchanged.
  • Each accepted cast consumes its input once. Duplicate completion calls cannot award additional materials.
  • Reward item descriptions use the produced materials. Packet publication and item notifications require the original connection audience to remain current.

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.

CompleteTransmute(Caster)

Evidence: server/Spells/Commoner/TransmuteItem.lua:11; binding EQ2Emu_lua_CompleteTransmute.

Current registration: WorldServer/Lua/LuaInterface.cpp.