Neuron is a full featured action Bar addon for World of Warcraft: Battle for Azeroth, updated for Patch 8.1
I do not recommend downloading this addon directly from Github, as there are CurseForge packaging modifications made the the addon upon release. These modifications include updating all included libraries to their latest release versions and pulling in all of the crowd sourced localizations. I have made an effort to pull in periodic samplings of these, but what you will find in the packaged versions on CurseForge or WowInterface will be much more up to date.
The efforts to translate Neuron into many languages is a community project, and it could use your help!
Head here to start translating.
The addon can be downloaded at these places:
Neuron inherits all theming courtesy of the Masque addon. Neuron has full Masque compatibility, and the theming options found in Masque are quite in-depth, not to mention the robust portfolio of skins made to support Masque. In short, you can make your bars look any way you like!
- Neuron features an unlimited number of macros. You can create as many bars/buttons as you want/need per character!
- Are you a clicker extraordinaire? As many buttons on the screen you want where you want, when you want!
- Macros the size of Texas! Up to 1024 characters in length!
- Maul's unique mouse-over key-binding system - where the mouse-over binding system was born!
- Many other of the favorite desired bar addon features and then some!
- And, last but not least, MASQUE support!
Neuron contains a graphical bar editor that allows for nearly endless customization to bar shape, size, orientation, and much more! Further, Neuron has neither the limitations on max number of bars nor on the max number of buttons per bar, as you might find in addons such as Bartender4 or Dominoes.
If the command line is your thing, all of the options found in the graphical bar editor can also be set using the below command structure.
Type /neuron alone to display a list of available commands, which are:
- menu: Toggle the main menu
- create: Create a blank bar
- delete: Delete the currently selected bar
- config: Toggle configuration mode for all bars
- add: Adds buttons to the currently selected bar (add or add #)
- remove: Removes buttons from the currently selected bar (remove or remove #)
- edit: Toggle edit mode for all buttons
- bind: Toggle binding mode for all buttons
- scale: Scale a bar to the desired size.
- snapto: Toggle SnapTo for current bar
- autohide: Toggle AutoHide for current bar
- shape: Change current bar's shape
- name: Change current bar's name
- strata: Change current bar's frame strata
- alpha: Change current bar's alpha (transparency)
- alphaup: Set current bar's conditions to 'alpha up'
- arcstart: Set current bar's starting arc location (in degrees)
- arclen: Set current bar's arc length (in degrees)
- columns: Set the number of columns for the current bar
- padh: Set current bar's horizontal padding
- padv: Set current bar's vertical padding
- padhv: Adjust both horizontal and vertical padding of the current bar incrementally
- showgrid: Toggle the current bar's showgrid flag
- x: Change current bar's horizontal axis position
- y: Change current bar's vertical axis position
- state: Toggle states for the current bar (/neuron state <state>). Type /neuron statelist for vaild states
- statelist: Print a list of valid states
- load: Load a profile
- lock: Lock buttons
Neuron development is all done using the Intellij IDEA Community Edition IDE and with the assistance of the fantastic EmmyLua plugin. Detailed instructions on how I set up my development environment can be found here. Likewise, in game I make use of the addons BugGrabber, BugSack, and ViragDevTool, and in game tools such as "/eventtrace"
Development of Neuron requires an understanding of Lua syntax, the WoW API, and a working understanding of Git/GitHub. If you want to help with Neuron's development, I suggest:
- Forking the project on GitHub (some people use GitHub Desktop, but I personally use GitKraken)
- Setting up your aforementioned development environment
- Backing up your WTF folder
- Symlinking your cloned Neuron git folder to your "World of Warcraft>_retail_>Interface>Addons" folder
- Making your first change
A good place to start coding is by looking through the issue tracker to find any issues marked as "good first issue". All code change submissions should come in the form of pull requests, so that I can review it and provide comments before merging.
Translators:
- German: Aszkarath
- French: Cinedelle
- Brazilian Portuguese: Alanbre20
- Russian: Hubbotu
Disclaimer:
Neuron is a fork of the amazing Ion Action Bars addon started by Connor Chenoweth aka Maul, for World of Warcraft Legion and onwards. All credit for the bulk of this addon should go to him accordingly, along with SLOKnightFall for his maintainership throughout the years. I, Soyier, take no credit for the idea or implementation of this addon prior to my adoption of the code in the Fall quarter of 2017.