wow-api-reputation（WOW API reputation 文档）

Reputation API (Retail — Patch 12.0.0)

Comprehensive reference for reputation, faction, major factions, paragon, and neighborhood initiative 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

• C_Reputation — Faction info, standings, watched faction, headers
• C_MajorFactions — Renown factions (Dragonflight+)
• Friendship Reputations — Friendship-style rep (Tillers, etc.)
• Paragon — Paragon reputation (post-max)
• C_NeighborhoodInitiative — Housing neighborhood rep (12.0.0)

C_Reputation — Core Reputation System

Faction Info

Faction Data Fields

The factionData table contains:

• factionID — Unique faction ID
• name — Faction name
• description — Description text
• reaction — Standing index (1=Hated to 8=Exalted)
• currentReactionThreshold — Min rep for current standing
• nextReactionThreshold — Rep needed for next standing
• currentStanding — Current rep value
• atWarWith — At war? (PvP hostile)
• canToggleAtWar — Can toggle at war?
• isChild — Is sub-faction?
• isHeader — Is a header row?
• isHeaderWithRep — Header that has rep?
• isCollapsed — Is header collapsed?
• isWatched — Is watched faction?
• hasBonusRepGain — Has rep bonus?
• canSetInactive — Can set inactive?

Watched Faction

Faction List Management

Standing Names

C_MajorFactions — Renown System

Major factions use renown levels instead of traditional reputation standings.

Major Faction Data Fields

• factionID — Faction ID
• name — Faction name
• celebrationSoundKit — Sound on level up
• renownLevel — Current renown level
• renownReputationEarned — Rep earned toward next level
• renownLevelThreshold — Rep needed for next level
• textureKit — UI texture kit
• expansionID — Which expansion
• isUnlocked — Is faction unlocked?
• unlockDescription — How to unlock

Friendship Reputations

Some factions use friendship instead of traditional reputation.

Friendship Data Fields

• friendshipFactionID — Faction ID
• standing — Current standing text (e.g., "Good Friend")
• maxRep — Max rep for current tier
• reputation — Current rep value
• nextThreshold — Next tier threshold
• text — Standing description
• texture — Standing icon
• reaction — Reaction index
• reversedColor — Reverse progress bar color?

C_NeighborhoodInitiative — Housing Neighborhood (12.0.0)

New in 12.0.0 for the player housing system.

Common Patterns

List All Factions with Standing

local numFactions = C_Reputation.GetNumFactions()
for i = 1, numFactions do
    local data = C_Reputation.GetFactionDataByIndex(i)
    if data and not data.isHeader then
        local standingNames = {"Hated","Hostile","Unfriendly","Neutral","Friendly","Honored","Revered","Exalted"}
        local standing = standingNames[data.reaction] or "Unknown"
        print(data.name, standing, data.currentStanding)
    end
end

Check Renown Level

local function GetRenownProgress(factionID)
    if C_Reputation.IsMajorFaction(factionID) then
        local data = C_MajorFactions.GetMajorFactionData(factionID)
        if data then
            print(data.name, "Renown:", data.renownLevel)
            print("Progress:", data.renownReputationEarned, "/", data.renownLevelThreshold)
            return data.renownLevel
        end
    end
    return nil
end

Check Paragon Reward

local function CheckParagonReward(factionID)
    if C_Reputation.IsFactionParagon(factionID) then
        local currentValue, threshold, questID, hasReward =
            C_Reputation.GetFactionParagonInfo(factionID)
        if hasReward then
            print("Paragon reward available for faction", factionID)
        end
        return hasReward
    end
    return false
end

Key Events

Gotchas & Restrictions

1. Headers in faction list — C_Reputation.GetFactionDataByIndex() returns headers. Check isHeader to skip.
2. Major factions vs traditional — Check C_Reputation.IsMajorFaction() to determine which API to use.
3. Paragon is post-exalted — GetFactionParagonInfo() only works for factions at Exalted (or max renown for major factions).
4. Friendship rep display — Friendship factions show custom standing names. Use GetFriendshipReputation() for proper display text.
5. Account-wide rep — Some 12.0.0 reps are account-wide. Check IsAccountWideReputation().
6. Collapsed headers — Collapsed headers hide child factions from the indexed list. Expand before iterating.
7. Faction IDs are stable — Unlike indices, factionIDs are stable and can be persisted in SavedVariables.
8. Neighborhood initiative — New 12.0.0 system; APIs may evolve.