Run any Skill in Manus with one click

wow-api-guild

Stars34

Forks2

UpdatedFebruary 12, 2026 at 21:50

Complete reference for WoW Retail Guild Management, Guild Bank, Guild Info, and Guild Event APIs. Covers guild management functions (invite, promote, demote, kick, disband, MOTD, info), guild roster (GetGuildRosterInfo, GuildRoster, sorting), guild bank functions (GetGuildBankItemInfo, deposit, withdraw, tab management, permissions), guild perks/reputation, C_GuildInfo, and the Club API guild integration (guilds are ClubType.Guild in the Club system). Use when working with guild management, guild roster, guild bank, guild chat, guild events, or guild achievements.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

JBurlison

JBurlison/WoWAddonAPIAgents

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

More from this repository

same repository

agent-file-specs

JBurlison/WoWAddonAPIAgents

Contains the complete specifications for AI coding assistant customization files including agents, skills, prompts, and instructions. Works with GitHub Copilot, Claude Code, Codex, OpenCode, and other providers. Use this skill when you need to reference the correct file format, required fields, supported attributes, file locations, or VS Code settings for any customization file. Follows the Agent Skills open standard (agentskills.io).

2026-02-1234

wow-addon-structure

JBurlison/WoWAddonAPIAgents

Verbose guide for WoW Retail AddOn structure, .toc metadata, loading order, SavedVariables, and C_AddOns metadata and load APIs. Use when planning addon folder layout, file order, or SavedVariables wiring.

2026-02-1234

wow-api-achievements

JBurlison/WoWAddonAPIAgents

Complete reference for WoW Retail Achievement, Statistics, and Achievement Criteria APIs. Covers C_AchievementInfo, global achievement functions (GetAchievementInfo, GetAchievementCriteriaInfo, GetStatistic, GetComparisonStatistic), achievement categories, guild achievements, achievement links, tracked achievements, toast notifications, and achievement-related events. Use when working with achievement tracking, achievement display, statistics, achievement criteria, guild achievements, or achievement completion detection.

2026-02-1234

wow-api-calendar-events

JBurlison/WoWAddonAPIAgents

Complete reference for WoW Retail Calendar and Event Scheduler APIs. Covers C_Calendar (event creation, editing, invites, holidays, raid resets, filtered events, date navigation, guild events, community events, texture lookups) and C_EventScheduler (scheduled event system). Use when working with the in-game calendar, creating events, managing invites, displaying holidays, or scheduling guild/community activities.

2026-02-1234

wow-api-collections

JBurlison/WoWAddonAPIAgents

Complete reference for WoW Retail Mount, Pet, Pet Battle, Toy, Stable, and Heirloom Collection APIs. Covers C_MountJournal (mount list, filtering, favorites, summoning, display info), C_PetJournal (pet collection, favorites, summoning, caging, abilities), C_PetBattles (pet battle system, turns, actions, pets, abilities, traps), C_PetInfo, C_ToyBox/C_ToyBoxInfo (toy collection, use, favorites), C_StableInfo (hunter pet stables), C_Heirloom/C_HeirloomInfo (heirloom collection, upgrades). Use when working with mount journal, pet journal, pet battles, toy box, heirloom collection, or hunter stables.

2026-02-1234

wow-api-combat

JBurlison/WoWAddonAPIAgents

Complete reference for WoW Retail Combat, Damage Meter, Threat, Loss of Control, Combat Text, Combat Audio Alert, Secret Values, and Spectator APIs. Covers the 12.0.0 combat log removal (CLEU no longer available to addons), C_DamageMeter built-in damage meter, C_Secrets secret predicates, C_CurveUtil/C_DurationUtil for secret value visualization, C_LossOfControl, C_CombatText, C_CombatAudioAlert, ENCOUNTER_STATE_CHANGED, threat functions, and the new COMBAT_LOG_MESSAGE event. Use when working with combat data, damage meters, threat, loss of control, combat text, encounter events, or any combat-related addon functionality.

2026-02-1234

name

wow-api-guild

description

Guild API (Retail — Patch 12.0.0)

Comprehensive reference for guild management, guild bank, and guild info APIs.

Source: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API Current as of: Patch 12.0.0 (Build 65655) — January 28, 2026 Scope: Retail only.

Scope

Guild Management — Invite, promote, demote, kick, disband, MOTD
Guild Roster — Member list, info, sorting
Guild Bank — Item management, tabs, permissions
C_GuildInfo — Guild info utilities
Club Integration — Guilds as C_Club entities

Guild Management

Core Functions

Function	Returns	Description
`IsInGuild()`	`inGuild`	Is player in a guild?
`GetGuildInfo(unit)`	`guildName, guildRankName, guildRankIndex, realm`	Guild info for unit
`GetGuildFactionGroup()`	`factionGroup`	Guild faction (0=Horde, 1=Alliance)
`GuildInvite(name)`	—	Invite player to guild
`GuildUninvite(name)`	—	Remove from guild
`GuildPromote(name)`	—	Promote one rank
`GuildDemote(name)`	—	Demote one rank
`GuildSetLeader(name)`	—	Transfer leadership
`GuildDisband()`	—	Disband guild
`GuildLeave()`	—	Leave guild
`GuildSetMOTD(motd)`	—	Set message of the day
`GetGuildRosterMOTD()`	`motd`	Get MOTD
`GuildRosterSetPublicNote(index, note)`	—	Set public note
`GuildRosterSetOfficerNote(index, note)`	—	Set officer note
`GuildControlSetRank(rankIndex)`	—	Select rank for editing
`GuildControlSetRankFlag(flagIndex, enabled)`	—	Set rank permission
`GuildControlGetRankFlags()`	`flags`	Get rank permissions
`GuildControlGetNumRanks()`	`numRanks`	Number of ranks
`GuildControlGetRankName(rankIndex)`	`name`	Rank name
`GuildControlAddRank(name)`	—	Add new rank
`GuildControlDelRank(rankIndex)`	—	Delete rank
`GuildControlSaveRank(name)`	—	Save rank changes

Guild Roster

Function	Returns	Description
`GetNumGuildMembers()`	`totalMembers, numOnline, numOnlineAndMobile`	Member counts
`GetGuildRosterInfo(index)`	`name, rankName, rankIndex, level, classDisplayName, zone, publicNote, officerNote, isOnline, status, class, achievementPoints, achievementRank, isMobile, isSoREligible, standingID`	Member info
`GetGuildRosterLastOnline(index)`	`years, months, days, hours`	Last online time
`GuildRoster()`	—	Request roster refresh
`SortGuildRoster(sortType)`	—	Sort roster
`SetGuildRosterShowOffline(showOffline)`	—	Toggle offline display
`GetGuildRosterShowOffline()`	`showOffline`	Showing offline?
`SetGuildRosterSelection(index)`	—	Select member
`GetGuildRosterSelection()`	`index`	Selected member

C_GuildInfo

Function	Returns	Description
`C_GuildInfo.GetGuildNewsInfo(index)`	`newsInfo`	Guild news item
`C_GuildInfo.GetGuildTabardInfo(unit)`	`tabardInfo`	Guild tabard details
`C_GuildInfo.GuildRoster()`	—	Request roster update
`C_GuildInfo.QueryGuildMemberRecipes(guildMemberGUID, skillLineID)`	—	Query member recipes
`C_GuildInfo.QueryGuildMembersForRecipe(skillLineID, spellID [, recipeLevel])`	—	Query who knows recipe
`C_GuildInfo.RemoveFromGuild(guid)`	—	Remove by GUID
`C_GuildInfo.IsGuildOfficer()`	`isOfficer`	Is player officer?
`C_GuildInfo.IsGuildRankAssignmentAllowed(guid, rankOrder)`	`isAllowed`	Can assign rank?
`C_GuildInfo.SetGuildRankOrder(guid, rankOrder)`	—	Set member rank
`C_GuildInfo.SetNote(guid, note, isPublic)`	—	Set public/officer note
`C_GuildInfo.CanEditOfficerNote()`	`canEdit`	Can edit officer notes?
`C_GuildInfo.CanSpeakInGuildChat()`	`canSpeak`	Can talk in guild chat?
`C_GuildInfo.CanViewOfficerNote()`	`canView`	Can view officer notes?
`C_GuildInfo.GetGuildRankOrder(guid)`	`rankOrder`	Member rank order
`C_GuildInfo.MemberExistsByName(name)`	`exists`	Member in guild?

Guild Bank

Guild Bank Items

Function	Returns	Description
`GetGuildBankNumSlots(tab)`	`numSlots`	Slots in bank tab
`GetGuildBankItemInfo(tab, slot)`	`texture, itemCount, locked, isFiltered, quality`	Item info
`GetGuildBankItemLink(tab, slot)`	`link`	Item link
`GetGuildBankItemValue(tab, slot)`	`value`	Item vendor value
`AutoStoreGuildBankItem(tab, slot)`	—	Move to bags
`SplitGuildBankItem(tab, slot, amount)`	—	Split stack
`PickupGuildBankItem(tab, slot)`	—	Pick up item
`QueryGuildBankTab(tab)`	—	Request tab data
`QueryGuildBankLog(tab)`	—	Request tab log
`QueryGuildBankText(tab)`	—	Request tab info text

Guild Bank Tabs

Function	Returns	Description
`GetNumGuildBankTabs()`	`numTabs`	Number of bank tabs
`GetGuildBankTabInfo(tab)`	`name, icon, isViewable, canDeposit, numWithdrawals, remainingWithdrawals`	Tab info
`SetGuildBankTabInfo(tab, name, icon)`	—	Edit tab name/icon
`BuyGuildBankTab()`	—	Purchase new tab
`GetGuildBankTabCost()`	`cost`	Next tab cost
`GetGuildBankText(tab)`	`text`	Tab info text
`SetGuildBankText(tab, text)`	—	Set tab info text
`CanGuildBankRepair()`	`canRepair`	Can repair from guild bank?
`GetGuildBankWithdrawMoney()`	`amount`	Withdrawal allowance
`GetGuildBankMoney()`	`money`	Guild bank gold
`DepositGuildBankMoney(amount)`	—	Deposit gold
`WithdrawGuildBankMoney(amount)`	—	Withdraw gold
`CanWithdrawGuildBankMoney()`	`canWithdraw`	Can withdraw gold?
`GetGuildBankMoneyTransaction(index)`	`type, name, amount, years, months, days, hours`	Money log entry
`GetNumGuildBankMoneyTransactions()`	`numTransactions`	Money log count

Guild Bank Log

Function	Returns	Description
`GetNumGuildBankTransactions(tab)`	`numTransactions`	Tab transaction count
`GetGuildBankTransaction(tab, index)`	`type, name, itemLink, count, tab1, tab2, year, month, day, hour`	Transaction entry

Guild + Club Integration

Guilds are represented as clubs with Enum.ClubType.Guild in the C_Club system:

-- Get guild as a club
local clubs = C_Club.GetSubscribedClubs()
for _, club in ipairs(clubs) do
    if club.clubType == Enum.ClubType.Guild then
        local guildClubId = club.clubId
        -- Use C_Club functions for guild chat streams
        local streams = C_Club.GetStreams(guildClubId)
        break
    end
end

Common Patterns

Iterate Guild Roster

local function PrintGuildMembers()
    local numMembers = GetNumGuildMembers()
    for i = 1, numMembers do
        local name, rankName, rankIndex, level, classDisplayName, zone,
              publicNote, officerNote, isOnline = GetGuildRosterInfo(i)
        if isOnline then
            print(name, level, classDisplayName, zone)
        end
    end
end

-- Must request roster first
C_GuildInfo.GuildRoster()

Guild Bank Interaction

-- List items in guild bank tab 1
local function ListGuildBankTab(tab)
    local numSlots = GetGuildBankNumSlots(tab)
    for slot = 1, numSlots do
        local texture, itemCount, locked, isFiltered, quality = GetGuildBankItemInfo(tab, slot)
        if texture then
            local link = GetGuildBankItemLink(tab, slot)
            print(link, "x" .. (itemCount or 1))
        end
    end
end

Key Events

Event	Payload	Description
`GUILD_ROSTER_UPDATE`	canRequestRosterUpdate	Roster data refreshed
`GUILD_RANKS_UPDATE`	—	Rank structure changed
`GUILD_MOTD`	motdText	MOTD received
`GUILD_NEWS_UPDATE`	—	Guild news updated
`GUILD_INVITE_REQUEST`	inviter, guildName, guildAchievementPoints, oldGuildName, isNewGuild, ...	Guild invite received
`GUILD_INVITE_CANCEL`	—	Invite cancelled
`PLAYER_GUILD_UPDATE`	unitTarget	Guild status changed
`GUILD_TRADESKILL_UPDATE`	—	Guild tradeskill updated
`GUILD_RECIPE_KNOWN_BY_MEMBERS`	—	Recipe query result
`GUILDBANK_ITEM_LOCK_CHANGED`	—	Bank item lock changed
`GUILDBANK_UPDATE_TABS`	—	Bank tabs updated
`GUILDBANK_UPDATE_MONEY`	—	Bank money changed
`GUILDBANK_UPDATE_TEXT`	tab	Bank info text updated
`GUILDBANKBAGSLOTS_CHANGED`	—	Bank slots changed
`GUILDBANKFRAME_OPENED`	—	Bank frame opened
`GUILDBANKFRAME_CLOSED`	—	Bank frame closed
`GUILDBANKLOG_UPDATE`	—	Bank log updated

Gotchas & Restrictions

Roster request required — Call C_GuildInfo.GuildRoster() before reading roster. Data isn't always current.
Guild bank requires NPC — Guild bank functions only work when at a guild bank NPC.
Permissions vary by rank — Check permissions before attempting operations. CanGuildBankRepair(), CanWithdrawGuildBankMoney(), etc.
QueryGuildBankTab is async — Must query each tab and wait for GUILDBANK_UPDATE_TABS before reading items.
Guild = Club — Guild chat uses C_Club with Enum.ClubType.Guild. Use C_Club.SendMessage() for guild chat.
Rank indices — Rank 0 = Guild Master. Higher indices = lower ranks.
GetGuildRosterInfo index — 1-based index into the roster. Not related to rank or any other ordering.
MOTD event timing — GUILD_MOTD fires during login. Register early to catch it.