Skip to content

Installation

github-actions[bot] edited this page Oct 13, 2026 · 5 revisions

Installation

Requirements

Requirement Details
Game version Retail 12.1 (Interface 120100, 120105) or Forever / Camelot 1.60.1 (Interface 16001)
External addons None — all libraries are bundled
Optional AzeriteUI for Midnight (AzeriteUI6), AzeriteUI5 – JuNNeZ Edition (any theme), or AzeriteUI 5.x — if installed, the addon also colors their player and pet frames

Method 1 — CurseForge App (recommended)

  1. Open the CurseForge desktop app and search for ABCS – Advanced Bar Coloring System (Project ID 1286164).
  2. Click Install.
  3. Launch WoW — the addon is ready.

Method 2 — Manual Installation

  1. Download the latest release ZIP from the Releases page.
  2. Unzip the archive. You should end up with a single folder called AzUI_Color_Picker.
  3. Move that folder into your WoW AddOns directory:
World of Warcraft\_retail_\Interface\AddOns\AzUI_Color_Picker\

For Forever beta, use _classic_beta_\Interface\AddOns instead. Keep both TOCs; the client selects the appropriate one. AzeriteUI must also support the chosen client: JuNNeZ Edition and AzeriteUI6 1.0.7 or later both run on Forever.

The final structure inside the folder should look like this:

AzUI_Color_Picker\
├── AzUI_Color_Picker.toc
├── AzUI_Color_Picker_Camelot.toc
├── Bindings.xml
├── Core.lua, Effects.lua, Pets.lua, Rules.lua, Paint.lua, Frames.lua,
│   Share.lua, Profiles.lua, Options.lua, QuickPalette.lua
├── Pages\            (the option pages)
├── Locales\          (translations)
├── icon.tga
├── Options\          (the ABCS window)
└── Libs\
    ├── LibStub\
    │   └── LibStub.lua
    ├── CallbackHandler-1.0\
    │   └── CallbackHandler-1.0.lua
    ├── LibDBIcon-1.0\
    │   ├── LibDBIcon-1.0\
    │   │   └── LibDBIcon-1.0.lua
    │   └── LibDataBroker-1.1\
    │       └── LibDataBroker-1.1.lua
    ├── AceAddon-3.0\
    ├── AceDB-3.0\
    ├── AceGUI-3.0\
    └── AceConfig-3.0\
        ├── AceConfig-3.0.lua
        ├── AceConfigDialog-3.0\
        └── ...
  1. Start (or /reload) WoW and enable the addon in the AddOns list at the character select screen.
  2. Type /ahui in-game to open the options panel.

Verifying the Installation

After logging in:

  • A small ABCS icon should appear on your minimap (unless you have hidden it) and in the AddOn Compartment.
  • Type /ahui — the options panel should open immediately.
  • If neither of these happen, check that the addon is enabled in the AddOns list and that there are no Lua errors in your chat.

Updating

CurseForge App

The app handles updates automatically. You can also click Check for Updates manually.

Manual

  1. Delete the old AzUI_Color_Picker folder from your AddOns directory.
  2. Download the new ZIP from Releases and repeat the steps above.

Your saved colors and presets are stored in WTF\Account\<account>\SavedVariables\AzUI_Color_PickerDB.lua and are not deleted when you update the addon.


Uninstalling

  1. Delete the AzUI_Color_Picker folder from your AddOns directory.
  2. (Optional) Delete AzUI_Color_PickerDB.lua from your SavedVariables folder to remove all saved data.

Bundled Libraries

All dependencies ship inside the Libs\ folder — you do not need to install anything else.

Library Purpose
LibStub Library stub loader used by all Ace libs
CallbackHandler-1.0 Event callback system (used by AceDB and LDB)
AceAddon-3.0 Core addon framework (also used to find AzeriteUI)
AceDB-3.0 Saved variables and profile manager
AceGUI-3.0 Widgets for the options panel
AceConfig-3.0 Options table definition system (incl. AceConfigDialog and AceConfigRegistry)
LibDataBroker-1.1 Data broker for minimap / Titan Panel
LibDBIcon-1.0 Minimap icon and AddOn Compartment launcher

Clone this wiki locally