Giter Club home page Giter Club logo

adibuttonauras's Introduction

AdiButtonAuras

Display auras, and more, on action buttons.

AdiButtonAuras is a rewrite of Inline Aura, but with different design decisions based on my experience with the latter.

AdiButtonAuras uses a set of rules that apply to one or more spells. Each rule can track an aura on one or more units and change the display of the spell accordingly.

AdiButtonAuras has several custom rules to suggest using spells at meaningful times. By default, these suggestions are displayed using a rotary, shinning star on the associated action buttons. These can be disabled.

Development version build status: GitHub Workflow Status

Getting started

Before heading straight into a raid and/or playing with the options, you may want to read this short Getting started guide, which will introduce you to the basics of AdiButtonAuras.

Options

Global options

  • do not show flashing border for actions on cooldown (does not affect Blizzard flash)
  • do not show flashing border for actions out of combat (does not affect Blizzard flash)
  • select how suggestions are displayed (hidden, rotary star or flashing border)

Spell/item options

  • disable the spell
  • Show flash instead: replace any highlight with the flashing border animation
  • Inverted highlight: highlight the spell when it is missing
  • select which rules should apply

Theme options

  • customizable texts: font, size and colors
  • change the colors of the "good" and "bad" highlights
  • select the highlight amongst 11 different textures

User-defined rules

AdiButtonAuras allows you to enter and save your own rules, using a Lua-based language. Take a look at the rule reference to see what is available.

TODOs

  • sharing of custom rules in-game using hyperlinks, and out-of-game using copy-pastable strings.
  • better documentation with more examples about custom rules.

Supported classes and specializations

Most of the simple (de)buffs are supported through embedded libraries:

Special cases and hints are handled using customized rules, see below.

There is also a default rule for items not supported by LibItemBuffs-1.0.

FAQ

When I try to configure a spell, the button is dimmed and I cannot choose it. Why?

AdiButtons has no rule about this spell yet. Consider filling an issue.

Why are some rules ending with some obscure characters between brackets, like [LPS-DRUID-5.4.1-7]?

These are references to the libraries AdiButtonAuras used to create the rule.

  • LPS-XXX-A.B.C-N: data from LibPlayerSpells-1.0 for class XXX, patch A.B.C, Nth revision. E.g. "[LPS-DRUID-5.4.1-7]" stands for "rule created accordingly to LibPlayerSpells-1.0 data for druid, patch 5.4.1, 7th revision."
  • LSB-N: LibSpellbook-1.0, Nth revision.
  • LIB-N-XXX: LibItemBuffs-1.0, Nth revision, XXX data version

Are you going to support ElvUI?

AdiButtonAuras should work with ElvUI. I am not going to support its skin though.

Are you going to add a configuration panel to create custom rules?

Not in the way InlineAura did it. However you can create custom rules in-game using the Lua API.

Contributions & feedback

The project is open-source and hosted on github.com. You can report issues there. Pull request are also welcome. Adirelle often hangs around on the freenode IRC network in the #wowace channel.

Before reporting issues

  • Please check if any errors happened and paste the exact error messages in the issue.
  • Open the configuration panel, check "Debugging tooltip" and look for the spell identifier by hovering the spell icon in the spellbook, on your action bars and in the (de)buff display. Report these numbers in the issue.
  • Regarding flashing, disable AdiButtonAuras and check if the unwanted behavior is caused by the default UI. Please do not report issues caused by the default UI.

Acknowledgment

Thanks to the following people for testing and contributing to AdiButtonAuras and related libraries.

Contributors:

Contributor avatars

Made with contributors-img.

License

AdiButtonAuras is licensed under the GNU General Public License version 3.

adibuttonauras's People

Contributors

adirelle avatar rainrider avatar arcadepro avatar myth384 avatar nomoon avatar dafzor avatar sani avatar tuller avatar xergio avatar grimsbain avatar ls- avatar ckaotik avatar luukvbaal avatar rioto avatar vderaa avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.