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

На главную

## avatar.GetQuestObjectiveInfo( objectiveId )

Получить информацию об одной цели какого-либо задания игрока.

См. QuestLocation.

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

    -- объявление:
    function GetQuestObjectiveInfo( objectiveId )

    -- параметры
    objectiveId: ObjectId - идентификатор цели задания

    -- возвращаемые значения: nil или таблица с описанием задания вида:
    questId: QuestId - идентификатор ресурса квеста
    id: ObjectId - идентификатор цели квеста
    name: WString - название цели квеста
    description: WString - описание цели квеста
    sysDebugName: string or nil - дебажный строковый идентификатор (путь к файлу) или nil для финальной версии
    progress: number (int) - текущее значение счетчика (например, сколько уже собрано предметов на квест)
    required: number (int) - целевое значение счетчика (например, сколько надо собрать предметов на квест)
    isInternal: boolean - счётчик внутренний, поэтому, счётчик и маркер вообще не должны быть показаны пользователю
    type: number (enum QUEST_COUNT_...) - тип цели квеста, см. ниже
    showCounterValue: boolean - нужно показывать пользователю прогресс (цифры progress и required)
    alwaysShowMarker: boolean - всегда показывать маркер квеста на карте, даже если isInternal=true
    items: table of ObjectId - если имеется список предметов, то таблица с идентификаторами этих предметов
    dressSlots: table of number (enum DRESS_SLOT_...) - если имеется список слотов предметов, то таблица со значениями слотов
    locations: table of QuestLocation - таблица с описаниями точек цели задания

    -- objective type
    QUEST_COUNT_KILL
    QUEST_COUNT_ITEM
    QUEST_COUNT_SPECIAL
    QUEST_COUNT_KILL_AVATAR
    QUEST_COUNT_MONEY
    QUEST_COUNT_SHIP_UPGRADE_MONEY
    QUEST_COUNT_UPGRADABLE_SHIP
    QUEST_COUNT_REPUTATION
    QUEST_COUNT_ALT_CURRENCY

Пример:

    local progress = avatar.GetQuestProgress( questId )
    if progress then
      local objectives = progress.objectives;
      for index, objectiveItem in objectives do
        local objective = avatar.GetQuestObjectiveInfo( objectiveItem.id )
        if objective.items then
          LogInfo( "  objective.items[0]: ", objective.items[0] )
        end
      end
    end

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

CategoryQuest
EnumQuestFindNextQuestMode
EnumQuestType
EventCurrentQuestChanged
EventInteractionStarted
EventItemQuestsReceived
EventQuestAbandoned
EventQuestAcceptError
EventQuestBookChanged
EventQuestBookLimitsChanged
EventQuestCompleted
EventQuestDiscarded
EventQuestFailed
EventQuestFindNextResult
EventQuestFinishFailedNoSpace
EventQuestMarkUpdated
EventQuestObjectiveUpdated
EventQuestReadyToReturnChanged
EventQuestReceived
EventQuestShareInvitation
EventQuestShareInvitationResult
EventQuestShareInvitationTimeout
EventQuestSkipResult
EventQuestStartFailedLogFull
EventQuestStartFailedNoSpace
EventQuestTimerFinished
EventQuestTimerUpdated
EventQuestUpdated
FunctionAvatarAcceptQuest
FunctionAvatarAcceptShareQuest
FunctionAvatarDeclineShareQuest
FunctionAvatarDiscardQuest
FunctionAvatarFindNextQuest
FunctionAvatarFindNextSecretComponentQuest
FunctionAvatarGetAvailableItemQuests
FunctionAvatarGetAvailableQuests
FunctionAvatarGetCurrentQuest
FunctionAvatarGetQuestAstralUnlocks
FunctionAvatarGetQuestBook
FunctionAvatarGetQuestHistory
FunctionAvatarGetQuestImage
FunctionAvatarGetQuestInfo
FunctionAvatarGetQuestObjectiveInfo
FunctionAvatarGetQuestProgress
FunctionAvatarGetQuestReward
FunctionAvatarGetQuestShareInvitations
FunctionAvatarGetQuestsLimit
FunctionAvatarGetReturnableQuests
FunctionAvatarGetSkipQuestCost
FunctionAvatarRequestInteractions
FunctionAvatarRequestQuestsForItem
FunctionAvatarReturnQuest
FunctionAvatarSetCurrentQuest
FunctionAvatarShareQuest
FunctionAvatarSkipQuest
FunctionCartographerGetQuestGeodata
FunctionCartographerGetQuestObjectiveGeodata
FunctionCartographerGetZonesMapLowQuests
FunctionCartographerGetZonesMapQuests
FunctionCartographerIsFinalQuestCompleted
FunctionDeviceGetRelatedQuestObjectives
FunctionObjectGetInteractorQuests
FunctionUnitGetRelatedQuestObjectives
QuestId
QuestLocation
QuestShareResult

CategoryLuaApi CategoryFunction CategoryQuest CategoryAvatar

На главную