ChaosPower shows you the current relative strength of your Chaos Bolt. This means if the number is bigger, your Chaos Bolt would do more damage if you cast it right now. So basically wait for that number to get as big as possible and then go all out with your Chaos Bolts.
For a Destruction Warlock, good DPS depend on casting those precious Chaos Bolts when they are going to do the most damage. Most guides say "stay at 3.5 embers, wait for trinket and/or weapon enchant procs, then activate Dark Soul and (and on-use-trinkets) and unload all your embers with Chaos Bolts". But in my experience there are large damage differences between different procs. This addons purpose is to make these differences visible, so that you are able to more reliably pick the very best moments for casting Chaos Bolts.
The time bar
The time bar is a dynamic bar that displays the time remaining at the current Chaos Bolt strength. The bar is only visible when at least one procc is active. The bar also has an indicator that highlights the time at which your Chaos Bolt would launch if you start casting it immediately after whatever you're currently casting. If the time bar is green, it means there's enough time to cast a Chaos Bolt after your current cast and still launch it at the currently displayed strength. If the bar is red, the corresponding procc runs out earlier and that next Chaos Bolt would launch with a diminished strength. Check the screenshot for examples.
ChaosPower only has some basic configuration options (unlock, size, font size, hide out of combat, toggle the icon, show/hide the time-bar, ...).
They are slash command based and are accessible via /cp or /chaospower.
"My warlock gets a specific procc that the time bar doesn't show!"
The time bar filters and shows your buffs based on a white list. That means it ignores everything that is not explicitely added to be shown. You can simply add more buffs to that list. It's a table called "trackedAuras" and can be found at the top of the main LUA file. You can get the spell ID from wowhead: find the aura corresponding to your procc and copy-paste the number from the URL ("spell=xyz").
If I missed some common buff/procc, please tell me so I can add it for everyone!
- fixed a bug that caused the second shortest time to not always be displayed
- bar for second shortest time is now grey instead of green to reduce confusion
- added a basic time-left-at-current-strength display