View source for API:GetDatabaseQuestData

{{LuaApi|group=Quest}}
Returns the data of a quest by id, including its rewards. Used for quest links in chat.

<pre>
questData = GetDatabaseQuestData(questId)
</pre>

== Arguments ==
;questId : <code>number</code> – Id of the quest.

== Returns ==
;questData : <code>table</code> – A quest table with the same fields as the entries of [[API:GetQuestData|GetQuestData]], plus a <code>rewards</code> field. Nothing is returned if the quest is not found.

The <code>rewards</code> table has these fields:
{| class="wikitable"
! Key !! Type !! Meaning
|-
| <code>xp</code> || <code>number</code> || Experience reward.
|-
| <code>money</code> || <code>number</code> || Money reward.
|-
| <code>itemsGiven</code> || <code>table</code> || Array, indexed from 1, of [[API:GetInventoryItemData#Item data table|item data tables]] for the items always given.
|-
| <code>itemsChosen</code> || <code>table</code> || Array, indexed from 1, of [[API:GetInventoryItemData#Item data table|item data tables]] for the items to choose from.
|-
| <code>maxChoices</code> || <code>number</code> || How many of the <code>itemsChosen</code> items can be picked.
|}

== Details ==
* <code>questId</code> is converted to a 16-bit integer.
* The client first looks in its database of linked quests, then in the player's own quest log.
* The quest fields are filled by the same code as [[API:GetQuestData|GetQuestData]].

== Errors ==
None besides the generic ''Invalid Parameters'' message when the argument is missing or not a number.

== Example ==
From <code>ea_chatwindow/source/chathyperlinking.lua</code>:
<pre>
local questData = GetDatabaseQuestData( questId )
if( not questData )
then
    -- Show an error message
    return
end
</pre>

Reading a reward item, from the same file:
<pre>
local itemData = questData.rewards.itemsGiven[rewardIndex]
</pre>

== See also ==
* [[API:GetQuestData|GetQuestData]]
* [[API:GameData.GetQuestRewards|GameData.GetQuestRewards]]
* [[API:GetDatabaseAbilityData|GetDatabaseAbilityData]]