Lua functions

SetAAInfo

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

Historical signature: SetAAInfo(spawn, type, value)

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

Function: SetAAInfo(spawn, type, value)

Description: Sets an unassigned AA balance through the validated AA service. The signature and no-return contract are preserved. The target must be a player attached to the owning zone; AA must be enabled. Type names are case insensitive.

Accepted writable types: unassigned_aa, unassigned_tradeskill_aa, unassigned_prestige_aa, and unassigned_tradeskill_prestige_aa. Values must be integers 0–32767 and consistent with existing allocated ranks and pool caps. Assigned balances are derived from ranks; change those with SetAARank. Refused changes are logged and leave the character unchanged. Prefer AddAAPoints for awards and a success/failure result.

Parameters:

  • spawn: player spawn.
  • type: AA field name.
  • value: nonnegative integer balance.

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

No checked example is published for this function yet. No active script call with the current C++ argument count was found.

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