2.4.0 API更新日志

• 汇总, 翻译: 昏睡墨鱼 月色狼影

---

重大更新

• 战斗记录机制彻底改善并以精确数据替代 UI 交付文本字符串, 参看 slouken 当前的 sneak-peak 报告细节, 战斗中同名单位的特定标识符显著包含详细的参与单位与玩家关系标志. -- 极适合日志分析.

  • 2.4.0 新战斗记录系统开发指南

• 对游戏中的界面设置界面做了革命性的调整, 新的界面设置框架可以让其他插件作者的设置嵌入其内, 而且没有被污染的危险. 在这个系统中, 其中的一个类别都是属于插件作者们自己的. 根据我们所提供的接口编写强大的设置界面. 我们在2.4 PTR服务器就让作者们进行研究,探讨以及修正工作. 现在你只需要查看UIOptionsPanels.lua即可了解详细信息

事件

• 在新版本中 PARTY_MEMBER_ENABLE 和 PARTY_MEMBER_DISABLE将不在提供队伍成员启用或禁用的信息

安全模板

• 现在SecureStateHeader提供了一个新的机制, 在状态更改后可以更改自身的属性

错误调试

• 在2.4中, 将可将协程作为第一参数(可选)传送到 debugstack()

可视化设置

• 新增 cVar unitHighlights; 0 = Alt+Z 后模型不高亮, 1 = Alt+Z 后模型高亮. (例如 /console unitHighlights 1)
• 玩家现在可以切换显示友方或敌对的玩家名字,以及他们的宠物及创造物.你也可以切换那些小伙伴.

提示模式

• 新增 - GameTooltip:SetTotem(slot)

文字显示

• 现在可以材质直接在显示于本地文字中. 使用方法: |T<材质路径>:<width>[:<height>:<xOffset>:<yOffset>]|t

• 现在可以在聊天中加入规定的材质.你只要在聊天框中输入{星星}{骷髅}即可.

人物角色函数

• 新增 - 护甲防御值 = GetArmorPenetration()

频道函数

• 新增 - DeclineInvite(channel)

战斗日志记录函数

• 新增 - CombatLogAddFilter

• 新增 - CombatLogAdvanceEntry

• 新增 - CombatLogClearEntries

• 新增 - CombatLogGetCurrentEntry

• 新增 - CombatLogGetNumEntries

• 新增 - CombatLogGetRetentionTime

• 新增 - CombatLogResetFilter

• 新增 - CombatLogSetCurrentEntry

• 新增 - CombatLogSetRetentionTime

好友函数

• 新增 - SetFriendNotes("name" or index, "notes")

公会函数

• 新增 - canEdit = CanEditGuildTabInfo(tab)

公会银行函数

• 新增 - QueryGuildBankText(tab)

• 新增 - SetGuildBankText(tab, "text")

背包函数

• 新增 - 空格, 物品类型 = GetContainerNumFreeSlots(bagIndex) --返回当前一个包裹的剩余空格数量以及进入包中的物品类型.在包裹类型中, 0 则可放置任何物品.

物品管理

• 新增 - 包裹类型 = GetItemFamily(itemID | "name" | "itemLink") -- 用于容器时, 将返回容器类型; 用于物品时, 将返回可放置的容器类型. 不过这是一个位标记, 因此 GetItemFamily 的物品能放置箭袋 (bagType 1) 和 弹药袋 (bagType 2) 则返回 3. 可放置箭矢及弹药的包裹也返回 3.

  • 0 = 未定义 (表示此包裹中可以放任何物品类型的东西)
    

  • 1 = 箭袋
    

  • 2 = 弹药袋
    

  • 4 = 灵魂碎片袋
    

  • 8 = 制品袋
    

  • 16 = 未知
    

  • 32 = 采药袋
    

  • 64 = 附魔袋
    

  • 128 = 工程包
    

  • 256 = 钥匙圈
    

  • 512 = 珠宝袋
    

  • 1024 = 采矿袋
    

  • 2048 = 未知
    

  • 4096 = 非战斗收集型宠物
    

• 新增 - 图标 = GetItemIcon(物品Id/ 物品名称/ 物品链接/ itemString) -- 返回此物品的图标.(物品必须要是一个存在的, 否则返回nil值)

任务函数

• 新增 - questLink = GetQuestLink(questLogId)

• 新增 - GetRewardTitle()

语言函数

• 新增 - numLanguages = GetNumLanguages()

拾取函数

• 新增 - isOptOutOfLoot = GetOptOutOfLoot()

• 新增 - SetOptOutOfLoot(boolean)

  • false: 你可以进行Roll拾取
  • true: 你现在放弃Roll失去

法术函数

• 新增 - name, rank, icon, cost, isFunnel, powerType, castTime, minRange, maxRange = GetSpellInfo(spellId or spellName or spellLink)

• 新增 - spellLink = GetSpellLink(spellId or spellName or spellLink)

• 新增 - spellLink = GetTalentLink(tab, index[, inspect])

召唤函数

• 新增 - canSummon = CanSummonFriend()

• 新增 - SummonFriend()

图腾函数

• 新增 - haveTotem, name, startTime, duration, icon = GetTotemInfo(slot)

  • 1 = 火焰
  • 2 = 土
  • 3 = 水
  • 4 = 空气

• 新增 - timeleft = GetTotemTimeLeft(slot)

单位函数

• 新增 - healthMod = GetUnitMaxHealthModifier("unit")

• 新增 - inRange = UnitInRange("unit") -- 判断目标是否在有效范围内(Blizzard修正).现在主要使用在the Blizzard Raid UI (有效距离基于快速治疗/治愈范围)

• 新增 - classLocal, class = UnitClassBase("unit")

• 新增 - raceLocal, race = UnitRaceBase("unit")

• 新增 - guid = UnitGUID("unit") -- 返回一字符串. 唯一标识符.其作用于战斗记录中,用来识别每一个单位

未知函数

• 新增 - DeclineName("name", gender, declensionSet)

• 新增 - GetNumDeclensionSets("name", gender)

• 新增 - CanGrantLevel()

• 新增 - GrantLevel()

• 新增 - CommentatorSetCameraCollision()

• 新增 - CommentatorSetTargetHeightOffset()

• 新增 - TogglePerformancePause()

链接

• 2.4战斗记录系统变更, 详情参阅战斗记录事件详解

---

WoW更新类