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.

FFLogs Uploader stores its settings using the Dalamud plugin configuration system. Most settings are saved automatically when you log in or start an upload, so there is rarely a need to reconfigure anything between sessions. This page covers every configurable option and what it controls.

Login credentials

Your FFLogs account email and password are required to create and upload reports. Enter them in the login window that appears the first time you open the plugin with /fflogsuploader. The Remember me checkbox controls whether credentials are saved between sessions. When enabled, the email and encrypted password are written to the plugin configuration file so you are logged in automatically on the next launch.
On Windows, the password is encrypted using DPAPI (Data Protection API). DPAPI ties the encrypted blob to your Windows user account, so the saved password cannot be decrypted on a different machine or user account.
To log out, click Log Out in the top-right corner of the main window. This clears the active session but does not delete saved credentials if Remember me was enabled.

Guild selection

The guild dropdown lists every guild associated with your FFLogs account. The list is populated from the login response when you authenticate.
  • Select Personal Logs to upload to your personal FFLogs profile.
  • Select a guild name to upload the report to that guild’s log section. The guild must be one you are a member of on FFLogs.
Your selected guild is applied to all uploads — both file uploads and live logging sessions — until you change it.

Region

The region selector sets the serverOrRegion value sent to FFLogs when creating a report. Choose the region that matches your character’s home world data center.
OptionAPI valueData centers
NA1Aether, Crystal, Dynamis, Primal
EU2Chaos, Light
JP3Elemental, Gaia, Mana, Meteor
OC6Materia
The region selector is only visible when Personal Logs is selected. Guild uploads use the region configured on the FFLogs guild itself. See Regions for a complete reference.

Visibility

The visibility setting controls who can view the report on FFLogs after it is uploaded.
OptionValueWho can see it
Public0Anyone — the report appears in search results
Private1Only you — the report is hidden from all listings (default)
Unlisted2Anyone with the direct link, but not listed publicly
Private is the default. Change to Public or Unlisted in the dropdown before uploading if you want to share the report.

Log directory

The log directory is the folder where ACT writes FFXIV log files. The plugin auto-detects the standard ACT path on startup:
%APPDATA%\Advanced Combat Tracker\FFXIVLogs
If your ACT installation uses a different path, click Browse in the Live Log or Upload a Log tab and select the correct folder. The directory is saved automatically when you start a live log session or upload a file. For file uploads, you can also browse to a specific .log file rather than a directory. The path field accepts both.

FFLogs API credentials

The Parse Viewer requires a separate set of API credentials — a Client ID and Client Secret — to fetch parse data from the FFLogs GraphQL v2 API. These are different from your account email and password. You can create a free API client at https://www.fflogs.com/api/clients. Paste the Client ID and Client Secret into the setup prompt that appears the first time you open the Parse Viewer. They are saved to the plugin configuration and reused automatically. See Viewing parses for step-by-step API setup instructions.

When settings are saved

  • Credentials: saved immediately after a successful login when Remember me is checked.
  • Log directory, region, and visibility: saved when you click Start Live Logging or Go!.
  • API credentials: saved when you click Save & Connect in the Parse Viewer setup prompt.
  • Guild selection: not persisted between sessions — reselect your guild after restarting the plugin.

Build docs developers (and LLMs) love