DakJaniels / FancyActionBarPlus

2 stars 4 forks source link

Fancy Action Bar+ builds on the original Fancy Action Bar by @andy.s, enhanced by @nogetrandom to add a large amount of customization in ability tracking including tracking for multiple instances of effects, stack tracking, tracking for debuffs on specific targets, timers for cast and channeled abilities, UI customization and much, much more!

Bug reports, feedback, and feature requests strongly encouraged! (GitHub preferred: GitHub)

User Guide and Menu Option Documentation for v2.10.2

ACTIONBAR SIZE & POSITION

Options for changing the size and position of the action bar, quickslot and ultimate slot

Keyboard UI or Gamepad UI

Keyboard UI and Gamepad UI have separate sub-menus but identical options

Adjust Quickslot Position

Applies an offset to the quickslot position. Applies to Keyboard UI or Gamepad UI depending on which UI mode is active.

Adjust Ultimate Slot Position

Applies an offset to the ultimate slot position. Applies to Keyboard UI or Gamepad UI depending on which UI mode is active. Companion Ultimates will appear to the right of wherever the ultimate slot is placed

Actionbar Size & Position

Adjust Bar Spacing and Offset

GENERAL

Front & Back Bars Position

Sets the position of the front and back action bars. By default, the front bar is on the bottom and the back bar is on the top

Back Bar Visibility

Hotkey Text

Show hotkeys (default: ON) – show the hotkeys under the action bar icons.

UI CUSTOMIZATION

Button Frames

Button frames options only apply to Keyboard UI

Active Ability Highlight

Active Ability Highlight

Miscellaneous

Skill Styles

TIMER DISPLAY – KEYBOARD UI or GAMEPAD UI

Keyboard UI and Gamepad UI have separate sub-menus, and slight different defaults but identical options

TIMER DISPLAY SETTINGS

Options in this menu include settings to configure the font, font size, font style, vertical alignment of the ability timer on the action slot (set positive values to shift the timer up, negative values to shift the timer down), and the color (default: white) of the ability timer (when not overridden by the separate expiration settings)

STACKS DISPLAY SETTINGS

Abilities that can “stack” effects (e.g. charges on crystal weapon, damage stacks on simmering frenzy, instances of echoing vigor applied by allies, etc.) can display a counter showing the value of these effects. These settings configure the display settings for the stack counter.

Ulfsild's Contingency variants will display a special stack icon (¤ symbol) to indicate that the initial effect has been cast and is available to be consumed.

Stacks Display Settings

Options in this menu include settings to configure the font, font size, font style, postion on the action slot (default: top right aligned), and the counter color (default:gold)

TARGETS DISPLAY SETTINGS

Abilities can also display a counter showing the number of targets that this ability has been applied to. These settings configure the display settings for the stack counter.

Options in this menu include settings to configure the font, font size, font style, position on the action slot (default: top left aligned), and the counter color (default: gold) More options for configuring the behavior of this counter are located under: ADDITIONAL TRACKING OPTIONS > Multitarget Effect Tracking Options.

Targets Display Settings

ULTIMATE TIMER SETTINGS

Options for displaying a timer for active Ultimate effects. If more than one ultimate is active it will show the timer for the current bar’s ultimate, otherwise it will show the timer for any active ultimate and will persist through barswap.

Ultimate Timer Settings

Options in this menu include settings to disable the timer (enabled by default), configure the font, font size, font style, color, and adjust the vertical and horizontal position relative to the ultimate slot. The default position is aligned to the outside right border of the ultimate slot.

ULTIMATE VALUE SETTINGS

Options for configuring display of your current ultimate value.

By default showing the current ultimate value is enabled. Several modes for displaying the ultimate value are supported through the "Display Mode" setting: “Current” (default) displays the current ultimate value. “Current / Cost (dynamic)” displays the current value / ultimate cost when the current value is less than the cost, but switches to just displaying the current value if the current value is enough to cast the ultimate. “Current / Cost (static)” always displays both the current value and the cost of the ultimate.

Additional options in this menu include settings to configure the font, font size, font style, and adjust the vertical and horizontal position of the ultimate number relative to the ultimate slot. The default position is aligned to the inside bottom right border of the ultimate slot.

FAB+ also supports the ability to dynamically set the ultimate value color. By default the ultimate value will be white, and change to gold when it is at 90% of the ultimate cast cost (this threshold is customizable in the menu). The ultimate value will then turn green when the ultimate is usable, and red when the maximum value of 500 ultimate is reached.

Ultimate Value Settings

Companion Ultimate Settings

The companion ultimate value will inherit the font and size (but not color) of the player ultiamte. Position of the companion ultimate with respect to the player ultimate can be adjusted. Options in this menu include settings to show or hide the companion ultimate (default: ON), and adjust the horizontal and vertical offset of the slot. By default the companion ultimate slot is anchored to the right of the player ultimate slot/timer.

QUICKSLOT DISPLAY SETTINGS

Options for customizing the display of the quickslot. Options in this menu include settings to show or hide the cooldown duration for the slotted item (default: ON), as well as to set the timer font, font size, style, color (default: Tangerine), and vertical and horizontal alignment of the cooldown timer within the slot (default: upper middle center).

KEYBOARD & GAMEPAD SHARED

This menu contains settings that are shared across both keyboard and gamepad UI modes.

Timer Fade

Duration Display Decimals

Display Changes for Expiring Effects

Expiring timer threshold (default: 2 seconds) – timers will be considered “expiring” and change to display decimals, or change their highlight color, when they fall below the selected amount of seconds remaining if their individual settings are enabled.

Timer Text

Highlight

ABILITY CONFIGURATION

CURRENTLY SLOTTED ABILITY IDS

Lists the currently slotted skill names and ability IDs for the skills on each action bar

TRACKED EFFECTS

Here you can edit which effect you want the timer for a specific skill to track. To track a different effect, make sure to enter the ID of the skill and the ID of the new effect, before clicking the button to confirm.

Example configuration change: Tracked Effects

BUFFS GAINED FROM OTHERS

Enable ability timers to track the duration of buffs gained from allies. You can also select which effects you do not want to have tracked if you are not the source. This feature is disabled by default

Blacklisting Options for Buffs Gained from Others: this menu contains a configuration tool to blacklist certain which will prevent other player's application of them from starting an action bar timer. By default this includes miscellaneous Restoration Staff Abilities, Vigor, Resolve, and some other common buffs. Blacklisted abilities can be removed by selecting an ability from the list and clicking “Remove from Blacklist”

DEBUFFS ON TARGET

By default FancyActionBar+ configures effect timers to track the basic ability duration. This feature enables an alternative behavior where the timers for debuffs will instead track durations for the given debuff on the specific enemy being targeted

This supports several options:

ADDITIONAL TRACKING OPTIONS

Effect Duration Thresholds

Set the limits for when to ignore effects based on their duration

Multitarget Effect Tracking Options

Additional options for configuring the Targets Tracker behavior that by default, appears on the top left corner of the action slot. This includes the ability to disable this counter, an option to show the counter when only one instance of an effect is active (by default the counter will only appear if more than one instance is active, except for debuffs in the Debuffs on Target mode where it always appears).

Additionally a menu is provided to allow blacklisting effects that you do not want to display a target counter for.

Miscellaneous Options

MISCELLANEOUS

Additional miscellaneous options include the ability to show the action bar while dead (default: OFF), prevent casting abilities while trading (default: ON), enable compatibility with the Perfect Weave addon (default: OFF), setting to adjust the health bar position to prevent overlap with FAB (default: ON), showing markers on enemies you are currently in combat with, and enabling a global cooldown tracker widget.