This is an old revision of the document!
QuestTracker 2.0.0
Quest Tracker (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:
QT builds its 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.
Install the free MistahMikeysLib addon from the store. QuestTracker 2.0.0 requires MistahMikeysLib 6.0.0; update the addon and library together.
The large quest catalog is stored as a packaged resource and loaded through MML instead of being constructed during initial Lua loading.
QT supports the following languages: EN, FR, JP, KR, CN, and TC. (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.
Travel to a quest issuer uses MML's shared travel coordination. Only one trip can run across participating addons. A competing request is rejected rather than queued or allowed to interrupt the current trip. Finish or cancel that trip through its owning addon before selecting another issuer. Reaching an issuer does not accept, complete, or otherwise advance the quest for you.
During a normal Lua reload or unload, MML cancels owned travel and waits for its movement and transport to settle before allowing the reload or unload to complete. An already-issued teleport or area transition may still finish during that cleanup. The next load does not resume the old trip. Saved profiles and addon data are retained; enabled settings or profile loading may start new addon work according to your existing settings.
This coordination applies only to participating addons. It cannot prevent unrelated addons from issuing their own movement. Avoid running conflicting movement automation at the same time.
The descriptions reflect the current release. Some screenshots show earlier layouts or English labels; the text describes the current controls.
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 unless it is on the last page of the table - in that situation, it will simply appear somewhere on that page. 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. |
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). |
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.
This tab displays a table of all the quests you have started. Everything works exactly the same as it does for the Completed 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.
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, where available for your job, Peloton. 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 or Peloton) 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 travel to the destination. 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 travel to the destination. This overrides your Mount Selection. |
The Display Language choice on Debug is saved with this addon's profile. Save the profile after changing it; loading that profile restores the choice. Profiles and the current-profile selection are separated by game region, not by the display language.
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 region 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 region. 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.
This tab is primarily intended for use in conjunction with consultation with support. It enables various test scenarios and debugging information that are used to help diagnose issues that might occur during operation. The controls on this tab are:
Changing Display Language refreshes presentation without resetting active work. It does not change game text, interaction matching, command destination names, or region-based profile selection. Some screenshots show earlier controls or English labels.
| Display Language | Choose Automatic (Game Language), English, French, Japanese, Chinese (Simplified), Korean, or Chinese (Traditional). This affects this addon's interface. Missing UI translations use English. |
| Enable Log File | When checked, a unique log file will be created for your session. This only needs to be checked if you are told to do so by support. |
| Enable Timestamp | When checked, the current tick count will be included in the debug messages. This provides information that facilitates debugging timing issues. |
| Debug Message Level Settings | The 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. When checked, the corresponding message class is enabled. |
| Enable Async Logging | When checked, log output for periodic writing is buffered. |
| Log Flush Interval (ms) | Shown when async logging is enabled; sets the buffer flush interval in milliseconds. |
| Cleanup Log Files | When clicked, runs the library's log-file cleanup; progress is shown while cleanup runs. |
Additional tracing and diagnostic panels may appear when authorized by the library. Use these with support guidance.
For bug support, please post a message 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:
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. This is a complex piece of software that can be negatively affected by a number of factors over which I have no control, including the 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.