Lua functions

GetAAInfo

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

Historical signature: GetAAInfo(spawn, type)

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

Function: GetAAInfo(spawn, type)

Description: Reads an AA balance by its case-insensitive field name. It also works while AA is disabled, so scripts can inspect preserved balances. Field names are assigned_aa, unassigned_aa, assigned_tradeskill_aa, unassigned_tradeskill_aa, assigned_prestige_aa, unassigned_prestige_aa, assigned_tradeskill_prestige_aa, and unassigned_tradeskill_prestige_aa.

Use AddAAPoints for awards and SetAARank for allocations; assigned balances must match owned ranks.

Parameters:

  • spawn: spawn whose AA fields are read.
  • type: field name.

Returns: A whole balance from 0 to 32767 for a known type. No result for an invalid target/type or out-of-range balance. Player reads additionally require the owning zone worker, loaded owned AA state, and agreement between ranks and stored balance fields; inconsistent data is logged and left unchanged. NPC field reads retain their original behavior within the range check.

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.