Lua functions

SetIllusion

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

Historical signature: SetIllusion(spawn, model)

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

Function: SetIllusion(spawn, model)

Description: Sets the illusion of the Spawn to the model provided. See model ids by version on https://www.eq2emu.com/developers/references

Parameters:

  • spawn (Spawn) - Spawn object representing spawn.
  • model (uint16) - Integer value model.

Returns: None.

Original spell targets: When this function uses a spell's target list, it snapshots references to the originally selected actor allocations. It skips unavailable or departed targets instead of selecting another actor with a reused runtime ID. Accepted actors remain physically retained through the active protected callback, including Lua errors; saved userdata and target records do not keep them alive between callbacks. Explicit Spawn arguments retain their existing selection behavior. See Lua actor lifetime.

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.

SetIllusion(Caster, 0)

Evidence: server/Spells/Commoner/SpiritTotemoftheChokidai.lua:21; binding EQ2Emu_lua_SetIllusion.

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