brittyazel / Neuron

A full-featured World of Warcraft action bar and interface replacement addon
https://www.curseforge.com/wow/addons/neuron
MIT License
31 stars 21 forks source link
actionbar addons world-of-warcraft

Neuron

Neuron is a full-featured action Bar addon for World of Warcraft: Dragonflight, updated for Patch 10.0.0

Manual Install:

I do not recommend downloading this addon directly from Github, as there are CurseForge packaging modifications made to 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.

Want to Donate?

Making add-ons is a lot of work! Your help goes a huge way to making my add-on work possible. If you would like to Donate, Github Sponsors is the preferred method as they are currently matching donations dollar for dollar and take zero cut.

Translating

The efforts to translate Neuron into many languages is a community project, and it could use your help!

Head here to start translating.

Download:

The addon can be downloaded at these places:

Development:

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" and "/framestack"

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:

  1. Forking the project on GitHub (some people use GitHub Desktop, but I personally use GitKraken)
  2. Setting up your aforementioned development environment
  3. Backing up your WTF folder
  4. Symlinking your cloned Neuron git folder to your "World of Warcraft>_retail_>Interface>Addons" folder
  5. 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.

Alternative Development

If an IDE is not your scene, then we have provided a Nix based development environment. If you need Nix, then see the following section. Once you have Nix then you can type env NEURON_INSTALL_DIR="<your WoW addon path>/Neuron" nix-shell --run make and the build system will automatically install neuron and keep it synced with your changes

Nix

Installing Nix can probably be done from your package manage in Linux or WSL. Alternatively you can type sh <(curl -L https://nixos.org/nix/install) --daemon. See https://nixos.org for more details.

Disclaimer:

Neuron is a continuation of the amazing Ion Action Bars addon started by Connor H. Chenoweth. All credit for the work done prior to 2017 should go to him, accordingly.