无限 1.60 插件 API 手册

从本地国服 Beta 客户端(内部代号 Camelot)的 CASC 数据中提取,供插件开发参考。数据来源:Blizzard_APIDocumentationGenerated 插件、Wow.exe 字符串、Blizzard 插件 Lua 源码。

客户端版本
1.60.1.70790
编译日期
2026-11-03
Lua
5.1.4
C_ 命名空间
286
文档化函数
6621
事件
1816
枚举 / 结构
1757
受保护函数
12
版本变化 1.60.1.70634 → 1.60.1.70790:新增 3、改动 12、删除 1
1.60.1.70630 → 1.60.1.70634:新增 0、改动 1、删除 0
  • 改动枚举 NamePartType:新增 Combined = 2
1.60.1.70450 → 1.60.1.70630:新增 5、改动 1、删除 1
  • 新增事件 PET_ORDER_MOVE_TO_PENDING_CHANGED:载荷 isPetOrderMoveToPending: bool
  • 新增事件 SETTINGS_HEADER_TEXT_UPDATE:载荷 无
  • 新增函数 C_GameRules.SetForeverExperiencePresetPostLogin:(preset: ForeverExperiencePreset) → 无返回值
  • 新增函数 C_GameRules.SetForeverExperiencePresetPreLogin:(preset: ForeverExperiencePreset) → 无返回值
  • 新增函数 C_PetInfo.IsPetOrderMoveToPending:() → isPetOrderMoveToPending: bool
  • 改动枚举 ForeverExperiencePreset:新增 Enhanced = 1;删除 Modern
  • 删除函数 C_GameRules.SetForeverExperiencePreset
1.60.1.70374 → 1.60.1.70450:新增 25、改动 10、删除 4
  • 新增事件 EXTERNAL_EVENT_LAUNCH_URL_RESULT:载荷 result: bool
  • 新增事件 EXTERNAL_EVENT_URL_CHANGED:载荷 无
  • 新增事件 MAIL_OPEN_ALL_CANCELED:载荷 无
  • 新增事件 SECURE_TRANSFER_CONFIRM_TAKE_MAIL_MONEY:载荷 无
  • 新增事件 SHARD_TRANSFER_CANCELLED:载荷 无
  • 新增函数 C_AuctionHouse.GetItemKeySampleLink:(itemKey: ItemKey) → sampleItemLink?: string
  • 新增函数 C_BattleNet.AreRealIDFriendsEnabled:() → areRealIDFriendsEnabled: bool
  • 新增函数 C_BattleNet.GetFriendLevelFromInviteText:(inviteText: cstring) → friendLevel: BattleNetFriendLevel
  • 新增函数 C_ExternalEventURL.CanShow:() → canShow: bool
  • 新增函数 C_SecureTransfer.GetMailReceiveInfo:() → mailInfo: MailReceiveInfo
  • 新增函数 C_SecureTransfer.GetMailSendInfo:() → mailInfo: MailSendInfo
  • 新增函数 C_SecureTransfer.ShouldShowTradeRMTWarning:() → shouldShow: bool
  • 新增函数 C_SecureTransfer.TakeMailMoney:() → 无返回值
  • 新增函数 C_Tutorial.SendTutorialStartButtonTelem:(skipTutorial: bool) → 无返回值
  • 新增函数 GetCreditsDisplayInfo:() → info: table
  • 新增函数 GetCursorCenterPosition:() → posX: number, posY: number
  • 新增函数 GetOffhandHitModifier:() → result: number
  • 新增函数 GetPetCritChance:() → meleeCrit: number, spellCrit: number
  • 新增函数 GetPetDodgeChance:() → result: number
  • 新增函数 IsCursorVisible:() → visible: bool
  • 新增枚举 SdToggleUsageLocation:4 项
  • 新增枚举 SdToggleUsageLocationUI:4 项
  • 新增结构 CreditsDisplayInfo:7 项
  • 新增结构 MailReceiveInfo:2 项
  • 新增结构 MailSendInfo:2 项
  • 改动事件 GROUP_BUFF_VISUAL_ALERTS_CHANGED:说明文字改了
  • 改动事件 HIDDEN_GROUP_BUFFS_CHANGED:说明文字改了
  • 改动事件 PLAYER_LEVEL_UP:载荷 (level: number, healthDelta: number, powerDelta: number, numNewTalents: number, numNewPvpTalentSlots: number, strengthDelta: number, agilityDelta: number, staminaDelta: number, intellectDelta: number) → (level: number, healthDelta: number, powerDelta: number, numNewTalents: number, numNewPvpTalentSlots: number, strengthDelta: number, agilityDelta: number, staminaDelta: number, intellectDelta: number, spiritDelta: number)
  • 改动函数 C_GameRules.SetSDHDToggleValue:参数 (setToSD: bool) → (setToSD: bool, usageLocation: SdToggleUsageLocationUI)
  • 改动函数 C_UnitAuras.GetGroupBuffVisualAlerts:说明文字改了
  • 改动函数 C_UnitAuras.GetHiddenGroupBuffs:说明文字改了
  • 改动结构 GroupBuffItem:新增 displaySpellID: number
  • 改动结构 PVPScoreInfo:新增 gender: number
  • 改动表 LegacyConsts:新增 LEGACY_DEFAULT_CATEGORY_WARRIOR = 15585、LEGACY_DEFAULT_CATEGORY_PALADIN = 15580、LEGACY_DEFAULT_CATEGORY_HUNTER = 15578、LEGACY_DEFAULT_CATEGORY_ROGUE = 15582、LEGACY_DEFAULT_CATEGORY_PRIEST = 15581、LEGACY_DEFAULT_CATEGORY_SHAMAN = 15583、LEGACY_DEFAULT_CATEGORY_MAGE = 15579、LEGACY_DEFAULT_CATEGORY_WARLOCK = 15584、LEGACY_DEFAULT_CATEGORY_DRUID = 15577
  • 改动表 UnitAuraUIConstants:改为 HIDDEN_GROUP_BUFF_LIST_SIZE 32 → 128、GROUP_BUFF_VISUAL_ALERT_LIST_SIZE 32 → 128
  • 删除事件 EXTERNAL_EVENT_LAUNCH_URL_FAILED
  • 删除函数 C_GamepadTargeting.HasReticleHoverTarget
  • 删除函数 C_SecureTransfer.GetMailInfo
  • 删除结构 MailInfo
1.60.1.70338 → 1.60.1.70374:API 文档没有变化
    1.60.1.70245 → 1.60.1.70338:新增 20、改动 52、删除 0
    • 新增事件 VOICE_CHAT_ACTIVE_VOICE_PROVIDER_CHANGED:载荷 voiceProviderID: VoiceProviderID
    • 新增事件 VOICE_CHAT_DISCORD_SETTINGS_UPDATED:载荷 无
    • 新增事件 VOICE_CHAT_VOICE_PROVIDERS_AVAILABLE_CHANGED:载荷 无
    • 新增事件 VOICE_CHAT_VOICE_PROVIDER_CHANGED:载荷 voiceProviderID: VoiceProviderID
    • 新增函数 C_Discord.IsVoiceEnabled:() → enabled: bool
    • 新增函数 C_VoiceChat.GetActiveVoiceProviderID:() → activeVoiceProviderID: VoiceProviderID
    • 新增函数 C_VoiceChat.RestoreActiveVoiceProvider:() → changed: bool
    • 新增函数 C_VoiceChat.SetActiveVoiceProvider:(voiceProviderID: VoiceProviderID) → success: bool
    • 新增函数 GetGlancingBlowChance:(playerWeaponSkill?: number, targetDefenseSkill: number) → result: number
    • 新增函数 GetGlancingBlowPenalty:(playerWeaponSkill?: number, targetDefenseSkill: number) → result: number
    • 新增枚举 DiscordChannelID:1 项
    • 新增枚举 DiscordGuildID:1 项
    • 新增枚举 DiscordID:1 项
    • 新增枚举 DiscordLobbyID:1 项
    • 新增枚举 DiscordMemberID:1 项
    • 新增枚举 DiscordMessageID:1 项
    • 新增枚举 EditModeGamepadMainActionBarSetting:5 项
    • 新增枚举 LFGEntryVoiceMode:4 项
    • 新增枚举 VoiceProviderID:2 项
    • 新增表 QuestInfoLuaConsts:0 项
    • 改动事件 VOICE_CHAT_CHANNEL_ACTIVATED:载荷 (channelID: number) → (channelID: VoiceChatID)
    • 改动事件 VOICE_CHAT_CHANNEL_DEACTIVATED:载荷 (channelID: number) → (channelID: VoiceChatID)
    • 改动事件 VOICE_CHAT_CHANNEL_DISPLAY_NAME_CHANGED:载荷 (channelID: number, channelDisplayName: cstring) → (channelID: VoiceChatID, channelDisplayName: cstring)
    • 改动事件 VOICE_CHAT_CHANNEL_JOINED:载荷 (status: VoiceChatStatusCode, channelID: number, channelType: ChatChannelType, clubId?: ClubId, streamId?: ClubStreamId) → (status: VoiceChatStatusCode, channelID: VoiceChatID, channelType: ChatChannelType, clubId?: ClubId, streamId?: ClubStreamId)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_ACTIVE_STATE_CHANGED:载荷 (memberID: number, channelID: number, isActive: bool) → (memberID: VoiceChatID, channelID: VoiceChatID, isActive: bool)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_ADDED:载荷 (memberID: number, channelID: number) → (memberID: VoiceChatID, channelID: VoiceChatID)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_ENERGY_CHANGED:载荷 (memberID: number, channelID: number, speakingEnergy: number) → (memberID: VoiceChatID, channelID: VoiceChatID, speakingEnergy: number)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_GUID_UPDATED:载荷 (memberID: number, channelID: number) → (memberID: VoiceChatID, channelID: VoiceChatID)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_MUTE_FOR_ALL_CHANGED:载荷 (memberID: number, channelID: number, isMutedForAll: bool) → (memberID: VoiceChatID, channelID: VoiceChatID, isMutedForAll: bool)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_MUTE_FOR_ME_CHANGED:载荷 (memberID: number, channelID: number, isMutedForMe: bool) → (memberID: VoiceChatID, channelID: VoiceChatID, isMutedForMe: bool)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_REMOVED:载荷 (memberID: number, channelID: number) → (memberID: VoiceChatID, channelID: VoiceChatID)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_SILENCED_CHANGED:载荷 (memberID: number, channelID: number, isSilenced: bool) → (memberID: VoiceChatID, channelID: VoiceChatID, isSilenced: bool)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_SPEAKING_STATE_CHANGED:载荷 (memberID: number, channelID: number, isSpeaking: bool) → (memberID: VoiceChatID, channelID: VoiceChatID, isSpeaking: bool)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_STT_MESSAGE:载荷 (memberID: number, channelID: number, message: string, language: string) → (memberID: VoiceChatID, channelID: VoiceChatID, message: string, language: string)
    • 改动事件 VOICE_CHAT_CHANNEL_MEMBER_VOLUME_CHANGED:载荷 (memberID: number, channelID: number, volume: number) → (memberID: VoiceChatID, channelID: VoiceChatID, volume: number)
    • 改动事件 VOICE_CHAT_CHANNEL_MUTE_STATE_CHANGED:载荷 (channelID: number, isMuted: bool) → (channelID: VoiceChatID, isMuted: bool)
    • 改动事件 VOICE_CHAT_CHANNEL_PTT_CHANGED:载荷 (channelID: number, pushToTalkSetting: cstring) → (channelID: VoiceChatID, pushToTalkSetting: cstring)
    • 改动事件 VOICE_CHAT_CHANNEL_REMOVED:载荷 (channelID: number) → (channelID: VoiceChatID)
    • 改动事件 VOICE_CHAT_CHANNEL_TRANSCRIBING_CHANGED:载荷 (channelID: number, isTranscribing: bool) → (channelID: VoiceChatID, isTranscribing: bool)
    • 改动事件 VOICE_CHAT_CHANNEL_TRANSMIT_CHANGED:载荷 (channelID: number, isTransmitting: bool) → (channelID: VoiceChatID, isTransmitting: bool)
    • 改动事件 VOICE_CHAT_CHANNEL_VOLUME_CHANGED:载荷 (channelID: number, volume: number) → (channelID: VoiceChatID, volume: number)
    • 改动函数 C_Discord.GetDiscordUserID:返回值 userID: DiscordID → userID: DiscordMemberOpaqueID
    • 改动函数 C_Discord.GetDiscordUserName:参数 (userID: DiscordID) → (userID: DiscordMemberOpaqueID)
    • 改动函数 C_VoiceChat.ActivateChannel:参数 (channelID: number) → (channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.ActivateChannelTranscription:参数 (channelID: number) → (channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.DeactivateChannel:参数 (channelID: number) → (channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.DeactivateChannelTranscription:参数 (channelID: number) → (channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.GetActiveChannelID:返回值 channelID?: number → channelID?: VoiceChatID
    • 改动函数 C_VoiceChat.GetChannel:参数 (channelID: number) → (channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.GetLocalPlayerMemberID:参数 (channelID: number) → (channelID: VoiceChatID);返回值 memberID?: number → memberID?: VoiceChatID
    • 改动函数 C_VoiceChat.GetMemberGUID:参数 (memberID: number, channelID: number) → (memberID: VoiceChatID, channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.GetMemberID:参数 (channelID: number, memberGUID: WOWGUID) → (channelID: VoiceChatID, memberGUID: WOWGUID);返回值 memberID?: number → memberID?: VoiceChatID
    • 改动函数 C_VoiceChat.GetMemberInfo:参数 (memberID: number, channelID: number) → (memberID: VoiceChatID, channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.GetMemberName:参数 (memberID: number, channelID: number) → (memberID: VoiceChatID, channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.IsMemberLocalPlayer:参数 (memberID: number, channelID: number) → (memberID: VoiceChatID, channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.IsMemberMutedForAll:参数 (memberID: number, channelID: number) → (memberID: VoiceChatID, channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.IsMemberSilenced:参数 (memberID: number, channelID: number) → (memberID: VoiceChatID, channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.LeaveChannel:参数 (channelID: number) → (channelID: VoiceChatID)
    • 改动函数 C_VoiceChat.Login:参数 () → (channelType?: ChatChannelType);新增标记 SecretArguments
    • 改动函数 C_VoiceChat.SetPortraitTexture:参数 (textureObject: SimpleTexture, memberID: number, channelID: number) → (textureObject: SimpleTexture, memberID: VoiceChatID, channelID: VoiceChatID)
    • 改动函数 GetFrameStrata:新增标记 SecretReturnsForAspect
    • 改动函数 SetFrameStrata:SecretArguments NotAllowed → AllowedWhenUntainted;新增标记 SecretArgumentsAddAspect
    • 改动枚举 ChatChannelType:新增 DiscordParty = 5、DiscordGuild = 6、DiscordSolo = 7
    • 改动枚举 EditModeSystem:新增 GamepadMainActionBar = 30
    • 改动枚举 SecretAspect:新增 FrameStrata = 16777216
    • 改动枚举 TieredEntranceTierFlag:新增 None = 0、DisableTraitSystem = 2
    • 改动结构 DiscordChatInfo:改为 userID None → None
    • 改动结构 LfgEntryData:新增 voiceMode: LFGEntryVoiceMode
    • 改动结构 LfgListingCreateData:新增 voiceMode: LFGEntryVoiceMode
    • 改动结构 LfgSearchResultData:新增 voiceMode: LFGEntryVoiceMode
    • 改动结构 VoiceChatChannel:改为 channelID None → None
    • 改动结构 VoiceChatMember:改为 memberID None → None
    1.60.1.70094 → 1.60.1.70245:新增 3、改动 3、删除 0
    • 新增事件 PLAYER_PVP_FLAG_CHANGED:载荷 isPvpFlagged: bool
    • 新增函数 C_Spell.GetItemCooldown:(itemID: number) → spellCooldownInfo: SpellCooldownInfo
    • 新增函数 UnitUsesAmmo:(unit: UnitToken) → result: bool
    • 改动函数 C_BattleNet.SetBlocked:新增标记 HasRestrictions
    • 改动函数 C_PlayerInfo.GetName:返回值 name?: string → name: string;新增标记 MayReturnNothing
    • 改动枚举 EventToastEventType:新增 RenownFactionLeveledUp = 27

    运行时

    脚本引擎是标准 Lua 5.1.4(exe 内版权字符串 $Lua: Lua 5.1.4),与正式服相同。客户端是 Mainline 代码库,Housing、Mythic+ 等 12.0 时代的 API 都在,再通过 GameType 为 camelot 的规则关闭。

    可用的标准库

    stringtablemathcoroutinebit (band, bor, bxor, bnot, lshift, rshift, arshift)

    没有 io,没有 os(只保留 date、time、difftime 作为全局),没有 package.loadlib、dofile、require。debug 库只剩 debugstack、debuglocals、debugprofilestart、debugprofilestop。

    WoW 扩展的全局函数

    strsplitstrjoinstrconcatstrtrimstrlenutf8strcmputf8itostringallwipetinserttremovegetnformatgsubstrfindstrmatchstrsubstrlenstrupperstrlowerstrbytestrcharstrrepfloorceilabssqrtmaxminrandomfastrandomdatetimedifftimedebugstackdebuglocalsdebugprofilestartdebugprofilestopgeterrorhandlerseterrorhandlerloadstringsetfenvgetfenvnewproxygcinfocollectgarbageCopyTabletContainstInverttDeleteItemtIndexOf

    安全与污染(taint)

    securecallsecurecallfunctionsecureexecuterangeissecureissecurevariableforceinsecurehooksecurefuncscrubcanaccessobjectissecretvalueissecrettablecanaccessvaluecanaccesstablesecretwrapsecretunwrapInCombatLockdownRunScript

    插件代码默认是"受污染"的。调用受保护函数或向安全框架写入会触发 ADDON_ACTION_BLOCKED 或 ADDON_ACTION_FORBIDDEN。查看 taint 用 CVar taintLog,脚本错误用 scriptErrors。

    机密值(secret values)

    这是 12.0 引入、无限客户端完整继承的机制。在战斗、首领战、PvP 对局、聊天锁定等受限状态下,部分 API 不再返回明文,而是返回 <secret>。机密值可以原样交给接受它的 API(文档里 SecretArguments 为 AllowedWhenTainted 的,如 FontString:SetText),可以拼接(结果仍是机密值)、交给 string.format、作为值存进表;插件代码对它运算、与同类型的值比较、取长度、当表的键、判断机密布尔值,或把它交给 math.*、string.upper 这类转换数字或字符串的函数,都会直接报 Lua 错误(1.60.1.70338 实测)。

    资源配额

    启动日志显示 LimitedLuaResources 机制存在但当前关闭(Enabled = false)。预设配额:每插件 Frame 10000、Texture 40000、FontString 5000、Font 300、Timer 500、AnimGroup 2000、Animation 5000;全局 Frame 100000、Texture 400000。另有 CVar luaScriptBucketThrottleEnabled 系列控制脚本每秒执行时间上限,受限状态下阈值更低。

    相关 CVar

    scriptErrorsscriptWarningsscriptProfiletaintLogcheckAddonVersionluaErrorExceptionsluaScriptBucketThrottleEnabledluaScriptBucketThrottleMaxMsPerSecondNormalluaScriptBucketThrottleMaxMsPerSecondRestrictedluaScriptBucketThrottleMaxMsBurstNormalluaScriptBucketThrottleMaxMsBurstRestrictedallowUntaintedCreationenableDeprecationAddons