API:GetFortressStatuses

UI Lua API · RvR functions
Version: WAR 1.4.8

Returns the owner of each fortress and of its sub-areas.

fortresses = GetFortressStatuses()

Arguments

None.

Returns

fortresses: table – Array of fortress tables, indexed from 1, or nothing if the client has no fortress data.

Each fortress table has these fields:

Key	Type	Meaning
`id`	`number`	Fortress (keep) id.
`currentOwningRealm`	`number`	Realm that owns the fortress.
`currentOwningGuild`	`wstring`	Name of the owning guild. Empty if no guild owns it; the stock UI then shows "unclaimed".
`[1]` … `[n]`	`table`	The fortress's sub-areas, see below.

Each sub-area table:

Key	Type	Meaning
`id`	`number`	Sub-area id.
`currentOwningGuild`	`wstring`	Name of the guild owning the sub-area, or empty.

Details

The fortress table mixes named fields and an array part. ipairs(fortress) walks only the sub-areas.
The entries are ordered by fortress id, and the sub-areas by sub-area id.
A new table is built on every call.

Errors

None.

Example

From default/ea_advancedwarwindow/source/advancedwarwindow.lua (shortened):

EA_Window_AdvancedWar.fortressData = GetFortressStatuses()

for index, data in ipairs( EA_Window_AdvancedWar.fortressData )
do
    local keepId = EA_Window_AdvancedWar.fortressData[index].id
    ...
    for subareaIndex, subareaData in ipairs( EA_Window_AdvancedWar.fortressData[index] )
    do
        local subareaId = subareaData.id
        ...
        LabelSetText(labelSubareaOwner, subareaData.currentOwningGuild)

Return of Reckoning