Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Robert5204/FFLogsUploader/llms.txt

Use this file to discover all available pages before exploring further.

The Parse Viewer is a side panel that opens alongside the main plugin window and displays detailed performance data for every fight in an FFLogs report. It fetches data from the FFLogs GraphQL v2 API and shows each player’s DPS, rDPS, aDPS, and parse percentile — color-coded by tier — so you can review a pull immediately after it uploads, without opening a browser.

FFLogs API setup

The Parse Viewer requires an FFLogs API client to fetch parse data. Creating one is free and takes under a minute.
1

Go to the FFLogs API clients page

Open https://www.fflogs.com/api/clients in your browser. You must be logged in to your FFLogs account.
2

Create a new client

Click Create Client. Enter any name (for example, “Dalamud Plugin”) and leave the redirect URI blank — client credentials flow does not need one. Submit the form.
3

Copy the Client ID and Client Secret

FFLogs displays your new client’s Client ID and Client Secret. Copy both values — the secret is only shown once.
4

Paste the credentials into the Parse Viewer

Open the Parse Viewer (click View Parses after any upload, or use the plugin’s window). If your API credentials are not yet configured, the viewer shows a setup prompt. Paste the Client ID and Client Secret into the respective fields and click Save & Connect.The credentials are saved to the plugin configuration and will not need to be entered again.
The Parse Viewer uses the OAuth2 client credentials flow (grant_type=client_credentials) to obtain a bearer token from https://www.fflogs.com/oauth/token. The token is cached in memory and refreshed automatically when it expires.

Viewing parses for a report

1

Open the Parse Viewer

Click View Parses in the main window after a live log or file upload completes. The Parse Viewer opens pre-loaded with the just-uploaded report code, and the fight list loads automatically.You can also open the viewer manually and type any report code into the Report field, then click Fetch.
2

Select a fight

The left panel lists every fight in the report. Each entry shows the boss name, fight duration, local start time, and outcome:
  • Kills are shown in green.
  • Wipes are shown in red, with the boss HP percentage at wipe if available.
Click a fight to load its parse data. The side panel opens to the right of the main window.
3

Review the parse table

The side panel shows a sortable table with one row per player. Click any column header to sort by that column. The default sort is Parse % descending.
ColumnDescription
NameCharacter name and home world server
JobJob or specialization
DPSRaw damage per second (total damage ÷ fight duration)
rDPSRaid DPS — your personal damage adjusted to account for the buffs you applied to others and received from others
aDPSAdjusted personal DPS — personal damage adjusted for buffs received
Parse %Percentile ranking for this pull against all recorded parses for this fight
4

Open the report on FFLogs

Click Open on FFLogs in the Parse Viewer header to open https://www.fflogs.com/reports/{code} in your default browser.
If no parse data appears yet, the report is still being processed by FFLogs. The side panel shows a Refresh button when the data is empty — click it to retry. Percentiles typically appear within a minute of the report being terminated.

Parse percentile color coding

Parse % values are color-coded to match FFLogs tier colors:
ColorRangeMeaning
Gold99–100Exceptional — among the top 1% of all logged parses
Orange95–98Very high — top 5%
Purple75–94High — above average
Blue50–74Average
Green25–49Below average
Gray0–24Low

Build docs developers (and LLMs) love