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

На главную

## unit.GetFairyInfo( unitId )

Возвращает информацию о покровителе. Наличие покровителя можно определить по флагу isExist.

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

    -- объявление:
    function GetFairyInfo( unitId )

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

    -- возвращаемые значения:
    table or nil - если информация найдена, то таблица:

      isExist: boolean - true, если у игрока есть покровитель

      name: WString - имя покровителя
      description: WString - описание покровителя

      rank: number (int) - ранг покровителя
      level: number (int) - уровень покровителя
      experience: number (int) - опыт покровителя
      levelExperience: number (int) - опыт покровителя, необходимый для достижения этого уровня
      nextLevelExperience: number (int) - опыт покровителя, необходимый для достижения следующего уровня

      isHungry: boolean - благосклонен ли покровитель
      remainingMs: number (int) / nil - время в миллисекундах, которое покровитель будет благосклонен, nil - в случае отсутствия благосклонности
      isAlwaysActive: boolean - если true, то покровитель благосклонен всегда, независимо от значений isHungry и remainingMs
      currentRankRemainingMs: number (int) / nil - время в миллисекундах, которое у покровителя будет текущий ранг (временно хало 5-го уровня), nil - ранг навсегда

      dpsBonus: number (int) - во сколько раз увеличивается наносимый игроком урон
      healBonus: number (int) - во сколько раз увеличивается способность игрока лечить
      powerBonus: number (integer) - значение бонуса для характеристики "Могущество"

    -- пример:
    local info = unit.GetFairyInfo( unitId )
    if info then
      local powerBonus = info.powerBonus
    end

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

EventUnitFairyChanged
EventUnitFairyRankChanged
FunctionAvatarGetFairyMechanicsInfo
FunctionUnitGetFairyInfo
FunctionUnitGetFairyPowerBonus
FunctionUnitGetFairyZodiacSignInfo

CategoryLuaApi CategoryFunction CategoryUnit CategoryFairy

На главную