https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3AGetQuestData
API:GetQuestData - Revision history
2026-10-18T06:58:52Z
Revision history for this page on the wiki
MediaWiki 1.43.11
https://wiki.returnofreckoning.com/index.php?title=API:GetQuestData&diff=30451&oldid=prev
Maintenance script: UI Lua API import (WAR 1.4.8)
2026-10-16T19:44:46Z
<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Game}}<br />
Returns the quests in the player's quest log.<br />
<br />
<pre><br />
quests = GetQuestData()<br />
</pre><br />
<br />
== Arguments ==<br />
None.<br />
<br />
== Returns ==<br />
;quests : <code>table</code> – Array of quest tables, indexed from 1.<br />
<br />
Each quest table has these fields:<br />
{| class="wikitable"<br />
! Key !! Type !! Meaning<br />
|-<br />
| <code>id</code> || <code>number</code> || Quest id.<br />
|-<br />
| <code>name</code> || <code>wstring</code> || Quest name.<br />
|-<br />
| <code>area</code> || <code>wstring</code> || —<br />
|-<br />
| <code>startDesc</code> || <code>wstring</code> || —<br />
|-<br />
| <code>journalDesc</code> || <code>wstring</code> || —<br />
|-<br />
| <code>complete</code> || <code>boolean</code> || —<br />
|-<br />
| <code>maxTimer</code> || <code>number</code> || —<br />
|-<br />
| <code>timeLeft</code> || <code>number</code> || Time left on a timed quest. The stock UI counts it down itself and treats 0 as "no timer".<br />
|-<br />
| <code>zones</code> || <code>table</code> || Array of tables, indexed from 1, each with <code>id</code> (<code>number</code>) and <code>zoneName</code> (<code>wstring</code>).<br />
|-<br />
| <code>tracking</code> || <code>boolean</code> || <code>true</code> if the quest is in one of the player's 10 quest tracker slots.<br />
|-<br />
| <code>trackingPin</code> || <code>boolean</code> || —<br />
|-<br />
| <code>questTypes</code> || <code>table</code> || Table of 7 booleans with keys <code>0</code>–<code>6</code>.<br />
|-<br />
| <code>conditions</code> || <code>table</code> || Array of conditions, indexed from 1. Each has <code>name</code> (<code>wstring</code>), <code>curCounter</code> (<code>number</code>), <code>maxCounter</code> (<code>number</code>) and <code>failureCondition</code> (<code>boolean</code>).<br />
|}<br />
<br />
== Details ==<br />
* If there is no player object, or the Lua state is not available, the function returns nothing.<br />
* A new table is built on every call. The stock UI caches it in <code>DataUtils.GetQuests()</code> (<code>easystem_utils/source/datautils.lua</code>) and rebuilds it only when <code>GameData.Player.questsDirty</code> is set. <code>DataUtils.GetQuestData(questId)</code> searches that cached list by id.<br />
<br />
== Errors ==<br />
None.<br />
<br />
== Example ==<br />
From <code>easystem_utils/source/datautils.lua</code>:<br />
<pre><br />
function DataUtils.GetQuests()<br />
if( GameData.Player.questsDirty ) then<br />
GameData.Player.questsDirty = false<br />
DataUtilsData.quests = GetQuestData()<br />
end<br />
return DataUtilsData.quests<br />
end<br />
</pre><br />
<br />
Counting down quest timers, from the same file:<br />
<pre><br />
if( questData.timeLeft ~= 0 ) then<br />
questData.timeLeft = questData.timeLeft - timePassed<br />
</pre><br />
<br />
== See also ==<br />
* [[API:GetQuestPointConditions|GetQuestPointConditions]]<br />
* [[API:GetActiveObjectivesData|GetActiveObjectivesData]]</div>
Maintenance script