GoldenChrysus / ffxiv-ember-overlay

Powerful, data-focused DPS overlay and spell timers for Final Fantasy XIV (FFXIV). Can be used with the OverlayPlugin and ACTWebSocket plugins for Advanced Combat Tracker (ACT). Updated for Dawntrail.
GNU General Public License v3.0
142 stars 31 forks source link
act actwebsocket dawntrail ember endwalker ffxiv ffxiv-act ffxiv-overlays overlayplugin overlayplugin-skin spell-timers

FFXIV Ember Overlay & Spell Timers

Powerful, data-focused DPS overlay and spell timers for Final Fantasy XIV. Can be used with the OverlayPlugin and ACTWebSocket plugins for Advanced Combat Tracker.

Updated for Dawntrail.

GitHub GitHub package.json version GitHub last commit (branch) Works with OverlayPlugin Works with ACTWebSocket Discord GitHub package.json dynamic

Funding

Donate on Cash App Donate at PayPal ペイペイで施してください Donate at Ko-fi Become a Patron Donate at Streamlabs

Usage with OverlayPlugin

Create a new overlay from one of the Ember presets. Alternatively, set your OverlayPlugin URL to https://goldenchrysus.github.io/ffxiv/ember-overlay/

Usage with ACTWebSocket with OverlayProc

Add a new skin URL to https://goldenchrysus.github.io/ffxiv/ember-overlay/ and create a new overlay window from this skin.

Discord

Join the Discord server to receive live updates, report bugs, or request features at: https://discord.gg/7Kdpw6C

Navigation

Features

Informative tabs for damage, healing, tanking, raiding, and aggro.

DPS tab Healing tab Tanking tab Raid tab Aggro tab

Click on any player's name to view detailed statistics.

Detailed statistics

Optional minimal, Light, Classic, and Clear Blue themes (minimal can be combined with any theme).

Minimal theme Light theme Classic theme Clear Blue theme

Compact yet fully-featured horizontal layout available for every theme combination.

Horizontal layout

Spell timers.

Spell, buff, DOT, and debuff timers.

Spell, buff, DOT, and debuff timers

Optional minimal layout.

Minimal layout

Flexible layout options.

Flexible layout Icon layout

Powerful but easy spell timer setup.

Powerful but easy setup

Text to speech alerts.

Customizable text to speech alerts

Powerful overlay and data settings.

Customizable overlay

Quality of life features.

Collapsible interface to save space and show only your stats.

Collapsible interface

Blur player names for privacy (optionally blur job icons).

Blur player names

Browse encounter history (up to five encounters).

View encounter history

Minimize the entire overlay to the left or right when not in use to free up screen space.

Minimize when not in use

Share customizable stats with your party or raid group on Discord.

Discord webhook

Easily see the recent changes since your last visit.

About and changelog

Clear encounter data or load sample data to perfect your setup.

Clear encounter and load sample data Load sample spell data

Installation

Other Languages Available

To use this overlay, you need Advanced Combat Tracker (ACT) and OverlayPlugin. Please follow the guide based on your situation:

You don't have ACT or OverlayPlugin

Please follow the ACT + OverlayPlugin installation guide from the beginning.

You already have ACT but need OverlayPlugin

Please follow the OverlayPlugin installation guide.

You already have ACT and OverlayPlugin

Choose the guide based on your version of OverlayPlugin:

ngld OverlayPlugin

  1. Within ACT, navigate to Plugins > OverlayPlugin.dll.
  2. Set your overlay URL to https://goldenchrysus.github.io/ffxiv/ember-overlay/ or add a new overlay with the Ember preset selected (presets available in ngld OverlayPlugin 0.13.0 or later).

hibiyasleep or RainbowMage OverlayPlugin

  1. Within ACT, navigate to Plugins > OverlayPlugin.dll > Mini Parse.
  2. Set the URL to https://goldenchrysus.github.io/ffxiv/ember-overlay/
  3. Click "Reload overlay," and the overlay should now be visible in your FFXIV game.

Older Guides (ACTWebSocket and 0.3.4.0 OverlayPlugin)

If you need to see the old ACTWebSocket or 0.3.4.0 OverlayPlugin guides, they can be accessed here.

Changelog

View the full changelog here.

Staging Site

You can access and test features in advance by using the staging site. Instead of the regular URL, set your overlay to https://goldenchrysus.github.io/ffxiv/ember-overlay-dev/

Please note that the staging site is for pre-release testing, so you may encounter errors. Please report these errors as GitHub issues or in the #bug-reports channel on the Discord.

When viewing the changelog, you will be able to determine which changes are available on the staging site because they will be prefixed with "!" in the changelog for the latest development version.

Credits

Translations

Featured Donors

Donors

Misc.

Building

To build this yourself, do the following:

  1. Clone the repository using git, e.g. git clone https://github.com/GoldenChrysus/ffxiv-ember-overlay.git

  2. Run npm install to install the Node packages.

  3. Make a file .env-cmdrc and provide environment variables as necessary, using .env-cmdrc.sample as a guide.

  4. To launch the server immediately:

    1. Run npm start to start the React app on your machine on port 3000.
    2. Navigate to your.server.host:3000 to view the app.
  5. To build the app for usage on a Web server:

    1. Run one of the following build commands depending on your environment:
      • npm run build:development to build the development environment.
      • npm run build:staging to build the staging environment.
      • npm run build to build the production environment.
    2. Copy the contents of /build to the desired path on your Web server.
    3. Navigate to your.server.host/path/to/app to view the app.

Contributing

Process

  1. For new features, it would be best to first discuss your plans in an issue. This is to ensure that I haven't already completed a similar feature locally, that I agree with your approach, and that your feature aligns with the overall vision of the project. Bypassing this and sending new features straight to pull may result in pull rejection.
  2. Create a fork.
  3. Make your changes and follow the coding guidelines.
  4. Commit with meaningful messages that describe your changes.
  5. Create a pull request.
  6. Ensure your pull request describes the nature and purpose of your changes.

Coding Guidelines

This list is not exhaustive and generally applies to formatting. Your merge request may be rejected for other reasons including but not limited to: formatting issues not specified here, architectural concerns, or functionality concerns.

License

GNU General Public License v3.0 only

Copyright

Copyright (C) 2019-2021, Patrick Golden. All rights reserved.

Copyrights licensed under GNU General Public License v3.0 only.

See the accompanying LICENSE file for terms.