Altoholic

Altoholic is an Ace 3 addon written for people who dedicate most of their time to leveling alts, and who want to have as much information as possible in one addon. The main feature of the addon is the search functionality which allows users to search their alts' bags or loot tables in an Auction-House-like frame (see screenshots). All this with multiple-realms/accounts support.

I've been playing WoW since the European release, and I used to rely on addons like character viewer to check my alts' inventory, but since it was more or less abandoned and not always stable for me, I decided to write an addon myself and to improve the search feature as much as I could. I hope you'll enjoy it as much as I do

The addon has been in development since December 2007 and was officially released in late March 2008. It's still not final, and although it has considerably evolved since the initial release, there are still a lot of things I haven't had time to implement yet.
Please note that this is my first addon, and that English is not my native language.

Features:

- Languages supported: enUS, frFR, deDE, esES, ruRU, zhCN & zhTW.

- Account-wide data summary:

Characters' talents: Full talent trees & glyphs are supported for both specializations.

Money, /played, rest xp for each character, subtotals by realm, and grandtotals for the account.

Bag usage: see at a glance which characters should get bigger bags (bag size, free slots and types included)

Characters' skills: skill summary on one screen, namely the 2 main professions + the 3 secondary skills as well as riding. I may add more if there's demand. Profession cooldowns included.

Reputations: a list of all the reputations of the current realm's characters. You can see at a glance if all your alts are at least honored with Honor Hold if you want to get the new 2.4 blue PVP set. Suggestions on how to gring reputations will be available soon.

- View containers (bags, bank, keyring) of all alts, on all realms.

- Guild banks : You have 10 alts in 10 different guilds on the same server, all of them with access to a guild bank ? Not a problem, you can see them all here.

- E-mail: allows you to see which alts have mail without having to reconnect them. The addon will tell you when mail is about to expire on a character. Threshold configurable (up to 15 days). Multiple realm support as well. Mails sent to a known alt (one you've logged on at least once) will be visible in the addon without having to reconnect it.

- Equipment: See the equipment of the current realm's alts in one screen. Very useful when purchasing stuff for your alts at the AH. Multiple realms supported. Right-clicking any equipment piece will allow you to find an upgrade, this feature is similar to the official wow armory feature, and is quite performant, even though it doesn't match the accuracy of the official one.

- Search: the most important feature of the addon, it uses an AH-like frame to display search results. You can either search bags on the current realm, on all realms, or a loot table.
The loot table is a table based on AtlasLoot, but which contains only item id's, and therefore keeps memory usage minimal.

The Search menu allows you to find items based on their name (even partial), level, type or rarity, almost like at the AH. It is also possible to search known recipes.

- Quest Log: See the quest logs of all your alts, as well as an indication of which alts are on a specific quest. Clicking on a quest link in the chat log will tell you which alts are on that quest.

- Suggestions: Currently, only profession leveling suggestions are available when mousing over your current level in a specific profession. Suggestions are based on the leveling guides posted on the official US forums (credit goes to their respective authors). The addon also suggests you where to quest/grind xp depending on your character level.

Suggestions were also added for the most recent factions. More to come later.

- Auction house: You can see which auctions/bids you've placed with an alt without being logged in or being at the AH.

- Professions: You can browse all known recipes in a thotbot like frame (see screenshot).

- Mounts & Pets of all your alts.

- Achievements are tracked for all you alts (see screenshot).

- Guild Members: a list of your connected guildmates, along with their alts (if they're using Altoholic too), and their average item level. Clicking their AiL will also allow you to "remotely" inspect their equipment.

- Guild Skills: a list of altoholic users in your guild, along with their alts and direct profession links. All professions are available in one click.

- Guild Bank tabs: a list of altoholic users and the time at which they last visited the guild bank. If you haven't visited the guild bank for a few days, you can remotely update your local data without going to a capital city.

- I'd like to thank my guild, Odysseüs on EU-Marécages de Zangar, for assisting me since the earliest phases, thanks guys for everything you've done
- Thanks to the wowace community, you've been very helpful and this addon would not be there without the technical answers you gave me (especially Xinhuan, author of BankItems)
- Thanks to all the guys who are behind AtlasLoot, keeping the loot table up-to-date is a tremendous work, and the search functionality of Altoholic would not be what it is without your hard work.
- Thanks to Ayindi (wowace) & sLiz3r (curse) for the German translation.
- Thanks to NightOwl (wowace) for the zhTW translation.
- Thanks to Wang (wowace) for the zhCN translation.
- Thanks to Hellbot for the ruRU translation.
- Thanks to Laumac for the frFR translation.
- Thanks to IrregularByte for the esES translation.
- Brykrys for the LinkWrangler support.

IMPORTANT NOTE: As with every new expansion, many things have changed in the API, and it is REQUIRED to clear your Saved Variables for the addon.
This means cleaning the following files in \WTF\Account\<your_account>\SavedVariables : Altoholic.lua & All DataStore*.lua

There WILL be bugs if you use your old files without cleaning them first.
Some fixes to work around API changes are too time consuming, so cleaning is required. A meager price to pay once per expansion.

6.1.006 (08/05/2015)

- Updated list of archaeology projects with WoD projects. I apparently messed up and lost the file that contained the update in 6.1.001, it's now ok.
- Moved several UI templates to their own folder.
- Completely rewrote the Blizzard's DropDownMenu widget to use my own version.
I was tired of some of the constraints of their implementation, and of the loss of time it caused me every time I wanted to use one.
So I invested some time in making it my way.
- Account Summary -> The amount of uncollected garrison resources now appears in yellow when resources exceed 300, and in red when they exceed 450.
- Account Summary -> Added icons with drop-down menus to filter your list of alts by faction, level, profession and class.
- Account Summary -> Fixed the expand/collapse button that did not work anymore after the complete rewrite of the pane.
- Achievements lists updated ! (Thanks Bluemage29 for your help !!)
- Fixed a Lua error when viewing the Guild tab with an character not in a guild.

6.1.005 (20/04/2015)

- The garrison mission tooltip now shows a red exclamation mark '!' when no missions are active.
- In the account summary, the last column used to sort the view is now remembered, and is restored when you log in again.
- Character's tab: fixed a lua error when mousing over the professions' icon of a character that does not have 2 professions.
- Account Summary: modified the garrison followers pane to show followers at iLvl 675 and a column for their weapon/armor iLvl.

6.1.004 (11/04/2015)

- Fixed sorting the account summary by "Last Online" where the order was sometimes incorrect.
- Added an option to show the tooltip counters without details (no 'equipped', 'bank', ..). Disabled by default.
- No longer wiping the list of followers before scanning them.
- Added a tooltip to the garrison resources in the account summary, it now shows when resources were last collected, and when you will reach the maximum of uncollected resources.
- Fixed incorrect tooltip after multiple searches in the search tab.
- DataStore_Garrisons: Some clean-up to properly report active missions.
- The garrison mission tooltip that shows a '*' when missions are complete now shows it in red if all active missions are complete.

6.1.003 (07/04/2015)

REMINDER: If you are looking for a free Heroes of the Storm Beta key for the European Region, you should check the comments section on Curse & WoW Inteface.. I still have a few keys to give away.

- Updated scanning of currencies (honor points), total no longer needs to be divided by 100 since 6.1.
- Updated the garrison followers pane in the account summary to show followers with an iLvl greater than 660.
- DataStore Characters: updated GetRestXPRate() to account for Pandaren extra rest xp.
- Fixed Auction House scanning, and cleaning of expired auctions.
- The summary tab has been fully rewritten so that all 6 panes use the same frames.
This will make the addition of future content much easier.
Some new features here and there while I was at it (quality of life improvements mostly), I'll let you discover them :)
This is an update I wanted to do for a long time, and there are more things planned (more filters).. the other tabs will get an update too.

6.1.001 (25/02/2015)

- Added support for Garrison missions ! Warnings are not in yet, but available and active missions are now visible in the characters' tab.
Note: Active missions can only be correctly tracked if the mission is started with this version of Altoholic, so currently active missions will be visible, but their expiration will not. Sorry, this info is not provided by the game, I have to "manually" keep track of it.
- Fixed the spam of mail expiry warnings, this time for good (hopefully ! feedback appreciated on this one!).
- Now refreshing the follower's pane immediately when the followers' list is updated.
- Updated list of followers not recruited at the inn.
- Updated list of archaeology projects with WoD projects.
- Cleaned up the .pkgmeta of DataStore modules, my sources tell me this should prevent some problems with the Curse Client :) (Thanks Myrroddin !)
- Removed "already known/could be learned by" information from tooltips for companions, as they have been account-wide for a while.
- More code cleanup.

Note: I made several attempts at fixing the double guild bank counters in the tooltip, thanks to all of you who sent me their SV files, the issue is now clear.
Nevertheless, a complete perfect fix is not yet possible, as Blizzard does not provide the real/full realm name to which the guild actually belongs.
The best I can get in my case is "MarécagedeZangar" when I actually expect "Marécage de Zangar", and that value is nowhere to be found in the API.
Long story short, I have to come up with a way to work around this that does not force you guys to respect weird conditions to make it work..

6.0.004 (09/01/2015)

A massive code cleanup was performed, it should be mostly transparent for all of you, but code maintenance will be greatly improved for me.
I also simplified a lot of XML frames with new conventions that Blizzard had activated certainly a while ago, but that I never had time to change.
It's not finished, but it's a step in the right direction :)

- Many options were not saved correctly, this has been fixed, as a result, these options have been reset (tooltip options, etc..)
This options bug had, among others, impact on the account sharing feature that couldn't be launched anymore, Thanks Elfana for helping me on this !
- DataStore_Garrisons: Fixed scanning collection of garrison cache resources. It could occasionally be wrongly reset when getting resources from other sources.
- DataStore_Garrisons: Followers are now stored based on their id's, instead of their names. You will have to check your missions' table again with your alts to update follower information.
- DataStore_Garrisons: added a slider to configure when the reporting for uncollected resources should happen (350 -> 475)
- Grids -> Garrison Followers: added a drop down list to filter followers on whether they are collected, not collected, and if they were recruited at the inn or not.
- Garrison blueprints now appear in red if already known, I applied the same rule as for BOP recipes from Garrison trainers, thus any BOP item with "Already known" will appear red in a merchant frame.
- DataStore_Agenda: fixed another Lua error at logon introduced with previous fix. (Thanks again SpareSimian!)
- DataStore_Mails: added an option to report mails about to expire to the chat frame, in addition to the already existing dialog box. This will allow you to see on which alt the mail can be found. Please keep me informed if you detect real bugs thanks to this.

6.0.003 (27/12/2014)

- DataStore_Garrisons: fixed a bug where saved buildings are deleted from the DB.
- Added tracking of uncollected garrison resources. They can be seen in the currency pane of the account summary.
- Added a warning when uncollected garrison resources are >400 on a given alt. There is an option to disable this warning if you want to.
- Added Garrison-related achievements, now listed in a proper way in the achievements' tab.
- Checked recipes that kept appearing in green at garrison trainers.. there was no bug actually, recipes stayed green because they could be learned by other alts.
What I did instead is to check if a recipe is BOP. If it is BOP, and already known, it will appear in red.
- Removed mounts from the addon, as they have been account-wide for a while now. The icon is still there as a placeholder in the grids tab though.
- DataStore_Pets: removed all mount-related functions and data tables.
- DataStore_Mails: fixed a bug where the addon kept complaining about old mails about to expire. This one is long overdue, thanks to Wispor and Elfana for helping me on this one !
- Fixed "Player not found" message. (Bug 779 / Thanks Phinar !)
- DataStore_Achievements: fixed an error caused by achievements with invalid id (as returned by the game's API). (Bug 792 / Thanks SpareSimian)
- DataStore_Agenda: fixed a Lua error at logon. (Bug 792 also / Thanks SpareSimian)

6.0.002 (24/12/2014)

Seven Year Anniversary Edition.

Today is the seventh birthday of Altoholic, and I wanted to take a moment to thank the community for its patience and support.
2013 was a difficult year on a personal level, and 2014 was extremely busy at work.
As you have all seen, the amount and the pace of releases was not the best in these last 2 years, nevertheless, I remain committed to keep the addon alive, even if it will sometimes be on a "best effort" basis.

I had originally planned to make a release a bit earlier, but life came in the way, and truth be told, it's not a bad thing that the release happens today, as the last time I actually made a release close to the addon's birthday was for the 2-year anniversary.

To celebrate this wonderful day, I am releasing the first garrison-related features, it's not much, but it's a step in the right direction. I hope you'll enjoy it.

I will be peacefully resting at home for the next 2-3 weeks with some spare time on my hands though, and I intend to work on garrison missions + resources, and also on several fixes that are long overdue.

Enough said.. let me finish by wishing you all the best for 2015, for you and your families, and of course for all your alts :)

.. on to the changelog !

- New DataStore module : DataStore_Garrisons !
Note: You have to visit the missions table to scan followers, it doesn't work otherwise.
- Grids tab: added a pane for Garrison followers.
- Grids tab: added a pane for Garrison buildings.
- DataStore_Containers: now scanning the reagent bank at logon.
- Account Summary : updated the "currency" pane to remove valor and justice tokens, and replace them with garrison resources, apexis crystals, and seals of tempered fate.
- Account Summary : added a pane for Garrison followers.
- Fixed a Lua error when talking to an enchanting follower in the garrison.
- Fixed professions not being scanned entirely since 6.0 (Thanks Myrrodin & CKaotic), I did revert the part about followers though, to use IsNPCCrafting() instead.
- A lot of minor fixes.

Notes:
- Garrison missions/resource tracking are coming, no need to ask, it's high on the priority list :)
- I have a few weeks off, so I'll have time to work on the add-on, there will be releases in the coming 2-3 weeks, with several bug fixes (hell, the list has grown quite long..)

So i've been using Altoholic for a few years now, and have never once had a problem until 6.1 was released. Now the addon only displays on one toon, and the item counts are no where near right. Mostly it just counts what that toon has at the time. The rest are way low or high depending on if I have collected more or used any of the items that altoholic keeps track of. So I was wondering if anyone else has had this issue, if its just me, or if its something thats being worked on? because I've uninstalled and reinstalled this addon, uninstalled and reinstalled my other addons, and even uninstalled and reinstalled curse just to make sure. Just havnt dumped and reinstalled wow because god thats annoying. lol. Otherwise Altoholic makes tracking materials for all of my various profesions very easy, and is one of few addons i actually have tried, liked, kept, and even recommend.

Yeah, it seems it doesn't track profession materials that are in the bank or reagent bank. I also use tradeskillmaster, so I've learned to use its counts instead.

So i've been using Altoholic for a few years now, and have never once had a problem until 6.1 was released. Now the addon only displays on one toon, and the item counts are no where near right. Mostly it just counts what that toon has at the time. The rest are way low or high depending on if I have collected more or used any of the items that altoholic keeps track of. So I was wondering if anyone else has had this issue, if its just me, or if its something thats being worked on? because I've uninstalled and reinstalled this addon, uninstalled and reinstalled my other addons, and even uninstalled and reinstalled curse just to make sure. Just havnt dumped and reinstalled wow because god thats annoying. lol. Otherwise Altoholic makes tracking materials for all of my various profesions very easy, and is one of few addons i actually have tried, liked, kept, and even recommend.

With Draenor, I've been amassing a collection of gear from salvage boxes on my toons, mostly stashed in alts guildvaults and banks. I vendor some immediately (mostly the bad wotlk/cata/pandarian which has almost no xmog or DE value, since not much is selling these days)

Last night, a couple of toons bumped to 80, and I was looking for specific types of equipment.

So I went to the search, and put in levels 79-80, and plate armor. This did not work as expected. Same thing happened for levels 79-80 and leather armor. What would be really spiffy would be show me toon level 79-80 armor that's *BOE* from my realm, from any bank, bag or vault.

I've never tried searching like this before. The search interface is very remenisent of the auctioneer compact interface, and I've always been able to find gear or items in the auctioneer search that I'm looking for.

Am I missing something? I'll post a screenshot later today showing what results I did get.

Hey guys, I'm working on the addon, and fixing some stuff.. I hope I can make a release later today.

In the meantime .. my friends and I have a few Heroes of the Storm Beta keys to give away.. not many, but if you are playing in the european region, then they might be yours:

Here are the rules:

- Send me a mail (if you have been using the addon for a while, you should know where to find it) NOTE: it must be a mail, NOT A PRIVATE MESSAGE !

- The subject of the mail must be "Heroes of the Storm Beta Key"

- One key per mail, don't beg for more.

- There are only a few keys that my friends have been generous enough to give away, this give away is not backed by anyone else, so don't have unreasonable expectations.

- First in, first served..

- EUROPE only !!!!!

- If by any chance you are stupid enough to resell the key and get caught, you will endorse all responsibility for it, I will keep track of which key I have given to whom, and I will disclose that information should there be any issue in the future.

I have use Altoholic for many years and recommend it to my friends but it is currently frustrating the hell out of me. Since the recent patch updates the mouse over information displayed is not relevant to the actual item in the search retrieved details window.
It seems that whatever I search for first after logging into a toon is what gets displayed in the mouse over window. If I select the search tab and say click on Weapon/2 handed sword <Enter> the details displayed are then what is display for all subsequent mouse over operations of items displayed in future searches.
Do I have a problem or is it a general problem.

This seems to happen when DataStore attempts to update guild info when a table hasn't been created yet. A temporary fix would be to insert the highlighted code at line 177 so it looks like the following.

Code:

local guildKey = GetKey(currentGuildName)
if not Guilds[guildKey] then Guilds[guildKey] = {} end
Guilds[guildKey].faction = UnitFactionGroup("player")

On another note, when viewing multiple realms on the Account Summary tab, the faction breakdown when hovering over the realm total character levels refers to the realm you're logged into rather than the selected realm. This is corrected by making the following changes to lines 303 and 304 of Altoholic_Summary\AltoholicSummary.lua. This causes GetFactionTotals() to grab the realm and account info from the last character returned from that specific realm (or the realm heading) as the summary line doesn't return such info from Altoholic.Characters:GetInfo(line).

Thanks very much for finding out these great fixes and sharing them SDPhantom. I just wanted to clarify or at least make sure I wasn't mistaken, but the last proposed change to the Altoholic_Summary\AltoholicSummary.lua was actually to the AccountSummary.lua file in that in that folder.

Hi - first of all, love this add-on, the amount of time it's saved me going through the bags and banks of 30+ chars is massive.

Since 6.1 account sharing has not worked and I see from the previous posts that this is a known issue? This is a big issue for me as I have alts spread across three WoW accounts (same battle.net account). Is there a plan to get this going again?

I'm not sure what happened but the item count does not seem to be working anymore for me. It won't track items in guild banks at all it seems. Kind of bizarre because I definitely remember very recently it working fine. I isolated the addon with a fresh UI and the issue persists. Am I missing something here?

Had the same issue, try downloading all the DataStore addons from curse, it worked for me

I'm not sure what happened but the item count does not seem to be working anymore for me. It won't track items in guild banks at all it seems. Kind of bizarre because I definitely remember very recently it working fine. I isolated the addon with a fresh UI and the issue persists. Am I missing something here?

Support AddOn Development!

You have just downloaded by the author . If you like this AddOn why not consider supporting the author? This author has set up a donation account. Donations ensure that authors can continue to develop useful tools for everyone.