User Tools

Site Tools



questtracker

This is an old revision of the document!


Quest Tracker (QT)

What it does

QT allows you to track the progress of your FFXIV quests. It provides detailed information in a tabular format about your completed quests, current quests, and uninitiated quests. The uninitiated quests information is particularly useful, as it gives you insight into what quests you haven't tackled yet. It also allows you to select individual quests and perform additional functions such as:

  • View the previous quest requirements and to use that information to subsequently select those quests, allowing you to “walk back” through all previously required quests.
  • Automatically travel to the quest issuer.
  • Request more detailed quest information by displaying the corresponding quest page on Gamerescape.com.
  • See the following quest information: Key, Name, Level, Previous Quest Requirements, Job Category, Journal Genre, Journal Category, Journal Section, Expansion, Repeatability, Issuer, Issuer Area, and Issuer Position.
  • Sort each table column in ascending or descending order
  • Search the Key, Name, or Issuer columns by text string or LUA pattern

Limitations

QT builds it's quest tables by using in-game quest data provided by Square Enix and Minion reversed functions that can query the completion or in-progress state of quests, allowing quests to be filtered into three bins - completed, current, and uninitiated. The completed and current quest information should be accurate, but the uninitiated quest information has a few quirks. First, while it will show you quests that you haven't yet started, that information will include quests you may not be able to start - such as the quests associated with the Grand Companies in which you are not a member, or quests associated with seasonal and special events. Also, there may be additional requirements to start uninitiated quests other than just having completed previous quests. This is where using the feature to display the gamerescape.com information is very helpful, as it will typically identify what those additional requirements are.

Requirements

You must also download MistahMikeysLib from the store. It's free, of course.

QT supports the following languages: EN, FR, JP, KR, and CN. (Note: gamerescape.com only supports EN)

You must ensure FFXIV, Minion, and QT are always updated to their latest versions.

IMPORTANT

QT can move your character to most quest issuers, but you may run into cases where it cannot. First and foremost, it is limited by the Minion Mesh system - if the location you wish to travel to is on a mesh, then QT has a good chance of getting to it. If it's not on the mesh, then QT cannot move to it - however, you can use the Minion mesh editing tool (the Navigation menu item on the Minion main menu) to fix such mesh deficiencies, and you can submit those fixes through me to have them incorporated into the Minion baseline. Second, QT is able to get to any location that can be directly accessed after traveling to an aetheryte, aethernet, or city gate. Locations that are behind secondary gates (like when you must talk to an NPC, open a door, or travel through a zone line) are likely not accessible - but - I have provided access to a handful of useful ones. Secondary gate access includes locations in: all the housing areas, the Island Sanctuary, any GC barracks or city inn, the door to The Rising Suns - including the door to Unukalhai, and Diadem. If you need access to locations behind secondary gates not currently available, make a request in the QT discord new-feature-requests channel: https://discord.gg/KgTt9jdWYr.

UI

You start QT via the FFXIVMinion menu drop down. It's under the “MistahMikey” menu item. Clicking “Quest Tracker” should pop up its UI window. The UI consists of different input areas called tabs that are selected by clicking the tab name that appears on the first line of the UI. Each tab is described below.

GENERAL UI USAGE NOTE

When entering a value into a field control, when you begin to enter the text, the text will appear dimmed as a visual cue you are in the process of modifying the current value of the field. The field value is not entered until you hit either the RETURN key or the TAB key, at which time the value might be checked, resulting in a popup if an error is detected. After dismissing an error popup, you should be returned to the field control to correct the error. If you navigate away from a field control by focusing other controls (say, by clicking in a different field control) before entering the value, the current value will be redisplayed and the value you were in the process of entering will be lost.

In the control descriptions, if the control label has a asterisk appended, it means that value is saved in your profile (see the Profile Tab.)

When a table has sortable columns, the column headers provide buttons that allow you to sort the list according to values in that column: “^” sorts in the ascending direction (lowest to highest values), while “v” sorts in the descending direction (highest to lowest values).

When a table supports searching column data for a particular entry, the following controls will appear before the table:

Find Text Field Enter a search command that will be matched against one or more predetermined columns. When a hit occurs, the row containing the hit will be scrolled to the first displayed row. If there are multiple hits, use the “Find Next” Button control to go to the next one. When no more hits are available, you will receive a popup informing you the search will continue from the beginning of the table. You can use the “Clear” Button control to terminate the search.
LUA pattern Enabled Check Box When checked, the search command is treated as a LUA pattern (Please see https://www.lua.org/pil/20.2.html for the details) that any column matching it will hit. When not checked, the search command is treated as a text string that any column containing it will hit.

Main Tab

This tab generally controls the overall operation of QT. The controls on this tab are:

Enabled* When checked, enables you to travel to quest issuers.
Reset Resets all settings to their default initial values. You can use this to abort certain operations you've started if you can catch it in time. If you have a current profile set, and Load Current Profile After Reset (Profile Tab) is enabled, then your saved profile values will be loaded. The Reset button will disappear while the reset is in progress, and will reappear when it completes. If you complete or start quests while QT is running, you must use Reset to update the quest tables!
Discord Icon Takes you to the QT Discord channel if you need support. Be advised I am in the Eastern Time zone (UTC-05:00).

Completed Tab

This tab displays a table of all the quests you have completed. The total number of completed quests is displayed above the table. The Find function searches these columns for a hit: Key, Name, or Issuer.

In the table, any row that has previous quest requirements will have a “View” Button control. Clicking that button will display a popup window that contains Button controls for each previous quest. Clicking on those buttons will change to the appropriate quest table tab (if necessary) and scroll the quest to the first displayed row. The popup window will remain until you dismiss it.

Double right clicking on any quest row will cause your character to travel to the quest issuer (QT must be enabled for this to occur.) Double left clicking on any quest row will cause the corresponding gamerescape.com quest page to be displayed.

Current Tab

This tab displays a table of all the quests you have started. Everything works exactly the same as it does for the Completed Tab.

Uninitiated Tab

This tab displays a table of all the quests you have not yet started. Everything works exactly the same as it does for the Completed Tab. While you can get the information provided by the Completed and Current tabs using the in-game journal (albeit not quite as conveniently as you can using QT), you cannot get information about what quests you haven't yet started from the game. So if you are a completionist, this is likely where you will spend most of your time when using QT. It will greatly help you understand what quests you need to work towards completing. In some cases, you can get those quests going immediately, especially if you haven't completed many. But as you whittle down the easy ones, you will inevitably wind up having to sift through a lot of information to determine when a quest is available and what you need to do to unlock it. This is where the gamerescape.com information can be very helpful - keeping in mind the limitations I have already covered.

Movement Tab

The Movement Tab allows you to control what kind of movement speed will be used to move your character within the zones QT visits. There are two types of movement speed enhancements that are used: running speed actions and mounts. Running speed actions include Sprint, and if you use the right character, Peloton and Fists of Wind. These are invoked as they are available when the distance you must move is fairly short as indicated by the Mount Cutoff Distance. When the distance is longer than the Mount Cutoff Distance, a selected or random mount will be used to travel that distance. The controls on this tab are:

Enable Speed Actions When checked, QT will attempt to use speed actions (Sprint, Peloton, Fists of Wind) whenever they are available and it is appropriate. The mount will take priority if the cutoff distance requirement is met.
Speed Action Cutoff Distance (yalms) The distance above which QT will use Speed Actions to move your character.
Enable Mount When checked, QT will attempt to use a mount whenever one is available and it is appropriate.
Mount Cutoff Distance (yalms) The distance above which QT will use a mount to move your character.
Mount Selection A list of mounts from which you can chose one to use whenever a mount is needed to run that long distance to the placard. Be aware that this list, due to limitations in Minion, contains more mounts than you really own. If you pick one it turns out you cannot use (because you don't own it or you are in a zone where mounts aren't allowed), a popup will appear informing you of the situation.
Select Random Mount When checked, QT will randomly pick an available mount that you own to run to the placard. This overrides your Mount Selection.

Profile Tab

The Profile Tab allows you to persistently store most of QT's settings. The profile settings are stored in files unique to the character and game language used to create the profile. You can create as many profiles as you like. The controls on this tab are:

Load Current Profile After Reset When checked, if you hit Reset on the Main Tab, or when QT is loaded when you start Minion, after all settings are initialized to their default values, the saved settings in your current profile are loaded.
Current Profile Name The settings file you selected to be the current profile being used by QT.
Load Load all settings from the current profile.
Save Save all settings to the current profile.
Add New Profile The name of a new profile you wish to add (must be a valid file name).
Add Create the new profile and save all current settings to it.

The table is a list of all the profiles you have created for the current character and game language. Using the “Selection” column, you can select specific profiles for the operations Delete or Make Current. Obviously, only one profile at a time can be made current, so you can only select one for that operation, but you can select as many as you like for the Delete operation. You can select/deselect all profiles by using the checkbox in the operation row. Be aware that profile values are only saved when you explicitly request them to be saved via the Save button.

Debug Tab

This tab is primarily intended for use in conjunction requesting QT support. It enables various test scenarios and debugging information that are used to help diagnose issues that might occur during QT's operation. The controls on this tab are:

Enable Log file When checked, QT will create a unique log file for your session. This only needs to be checked if you are told to do so by QT support.
Enable Timestamp When checked, QT will include the current tick count in the debug messages. This provides information that facilitates debugging timing issues.
Debug Message Level Settings QT's debug message system implements a simple filtering mechanism that can be used to allow or inhibit certain message classes, generally in increasing order of verbosity. The default settings are fairly “quiet”, but to debug issues you encounter you will be asked to enable more verbose settings to gather diagnostic information.

Support

For bug support, please post a message on on discord: https://discord.gg/k8pBJpMnZw. I will respond as soon as I am able, generally within 24 hours at most.

When you need support, please provide me, at a minimum, the following:

  1. Enable the debug information category on the Debug Tab and do what you did to create the problem. Then take a screen shot of your Minion Console Log when the problem occurs. Make sure the Log's window as big as possible to show the maximum amount of output. If the output is larger than the window, then scroll the offscreen portions into view and send multiple screen shots.
  2. A screen shot of your QT main tab

If you post this information to the specified channel (NOT RECOMMENDED), please ensure it does not contain any information that identifies your account, character, or server. For complete anonymity, just DM it to mistahmikey#4073. Additionally, you should not use an account you use for in-game communications so you can't be doxed as a botter.

If that initial information is insufficient for me to determine the cause, I will ask you to set other debug settings that will provide more information. QT is a complex piece of software, and can be negatively affected by a number of factors over which I have no control, not the least of which is what other addons you run. I appreciate your patience in working with me to solve your issue when it is not slam-dunk easy. As long as you are willing to try the debugging measures I request, I will work with you until your problem is solved.

questtracker.1744253347.txt.gz · Last modified: 2025/04/10 02:49 by mistahmikey