# Пользовательские дополнения

На главную

## avatar.GetItemBonus( itemId )

Возвращает таблицу с информацией о бонусах, даваемых предметом.

    -- библиотека:
    avatar

    -- объявление:
    function GetItemBonus( itemId )

    -- параметры:
    itemId: ObjectId (not nil) - идентификатор предмета

    -- возвращаемые значения:
    table or nil - таблица с информацией о предмете или nil (в случае ошибок)
    поля:
     innateStats: table - бонус к основным характеристикам персонажа, поля аналогичны таковым из avatar.GetInnateStats(), но поле effective содержат сумму только base и enchants

     resistances: table - бонус к сопротивляемостям персонажа, поля аналогичны таковым из avatar.GetResistances(), но поле effective содержат сумму только base и enchants

     misc: table - (устарела после введения энчантов, не пользоваться, взамен пользоваться miscStats, см. ниже) различные бонусы, поля:
       power: number (float) - Могущество (miscStats.power.effective)
       stamina: number (float) - Выносливость (miscStats.stamina.effective)
       wisdom: number (float) - Мудрость (miscStats.wisdom.effective)
       minDamage: number (float) - (miscStats.minDamage.effective)
       maxDamage: number (float) - (miscStats.maxDamage.effective)
       weaponSpeed: number (float) - (miscStats.weaponSpeed)
       spellPower: number (float) - среднее значение (miscStats.spellPower.effective) (см. также maxSpellPower и minSpellPower)
       maxSpellPower: number (float) - максимальное значение (miscStats.maxSpellPower.effective)
       minSpellPower: number (float) - минимальное значение (miscStats.minSpellPower.effective)

     miscStats: table - различные бонусы, формат полей (кроме weaponSpeed) аналогичен формату из avatar.GetInnateStats() (только отсутствует поле secondary); назначение полей аналогично полям таблицы misc (которая соответственно устарела)
       power: table
       stamina: table
       wisdom: table
       minDamage:  table
       maxDamage: table
       spellPower: table
       maxSpellPower: table
       minSpellPower: table
       weaponSpeed: number (float)

    -- пример:
    local bonus = avatar.GetItemBonus( itemId )
    if bonus then
      local power = bonus.miscStats.power.effective
    end

Бонус к основным характеристикам персонажа: avatar.GetInnateStats.

Бонус к сопротивляемостям персонажа: avatar.GetResistances.

#### Связанные страницы: "CategoryLuaApi" "CategoryItemInfo"

CategoryItemLib
EnumItemSource
EnumToolProperty
EventGameItemChanged
EventGameItemCursedChanged
EventItemDisabled
EventItemRelatedQuestsChanged
EventShowItemsInfo
FunctionAvatarActivateItem
FunctionAvatarActivateItemAlternative
FunctionAvatarCanActivateItem
FunctionAvatarCanActivateItemAlternative
FunctionAvatarCanDisassembleItem
FunctionAvatarConvertMetaEnhancer
FunctionAvatarDuplicateMetaEnhancerItem
FunctionAvatarGetItemActionGroupsInfo
FunctionAvatarGetItemActivationInfo
FunctionAvatarGetItemActivators
FunctionAvatarGetItemActivatorsAlternative
FunctionAvatarGetItemBonus
FunctionAvatarGetItemBundle
FunctionAvatarGetItemChildCategories
FunctionAvatarGetItemCompatibleSlots
FunctionAvatarGetItemContainerInfo
FunctionAvatarGetItemCouponInfo
FunctionAvatarGetItemCraftInfo
FunctionAvatarGetItemCraftToolImproverInfo
FunctionAvatarGetItemCraftToolInfo
FunctionAvatarGetItemDressConditions
FunctionAvatarGetItemExtraDescs
FunctionAvatarGetItemExtraDescsRatings
FunctionAvatarGetItemMetaInfo
FunctionAvatarGetItemRelatedQuestObjectives
FunctionAvatarGetItemResourceId
FunctionAvatarGetItemResourceInfo
FunctionAvatarGetItemRootCategories
FunctionAvatarGetItemStateCooldownMs
FunctionAvatarGetItemValuedObject
FunctionAvatarHasItemGuildComponent
FunctionAvatarImproveCraftTool
FunctionAvatarIsItemEnabledForActions
FunctionAvatarIsMetaEnhancerDuplicator
FunctionAvatarPurifyItem
FunctionAvatarRequestItemQuests
FunctionAvatarRequestQuestsForItem
FunctionAvatarUseItem
FunctionAvatarUseItemOnItemAndTakeActions
FunctionAvatarUseItemOnPoint
FunctionItemMallGetItemInfo
InstancedEventResourceId
ItemId
LootGroupId

CategoryLuaApi CategoryFunction CategoryAvatar CategoryItemInfo

На главную