Sample display

AdiBags displays the content of your bags in one view, distributed into several sections using smart filters.

It is heavily inspired by Nargiddley’s Baggins.

Configuration is available through Blizzard addon panel, /adibags chat command or right-clicking on the LDB plugin.

Important note about localized filters: some filters rely on translations from LibBabble-Inventory-3.0 so if some of them behave strangely in your locale, please take a look at the library translation status.


Important notice: since v1.6.12-beta-1, AdiBags embeds BugGrabber, an error catching addon. Please check the error is really about AdiBags before reporting them here. I suggest installing BugSack to catch the errors.

Please report any bug or error using the wowace bug tracker (your Curse account works there). The comments section below is not meant to report and track bugs. I won’t reply to bug reports in the comment section anymore.

Some words about submitting bug reports:

  • I do not care about “it doesn’t work, fix it!” messages. I need to know how it failed and a way to reproduce the bug so I can test it and make sure I fix it.
  • Bug reports are not in the “fire and forget” kind of things. I may have to ask you some details.
  • Please check all existing tickets and the “known issues” section below before submitting new ones. Duplicate reports will be rejected on sight.

Bug tracker
WoWace forum thread


Most of these features may be configured. Check out the configuration panel ! (using the /adibags chat command or clicking on the bag icon, you have any LDB display)

  • Smart filters are used to distribute items into several sections, including:
    • Item sets of the Blizzard’s gear manager (one section per set),
    • Junk items (whitelist and blacklist available),
    • Quest items,
    • Equipment (items your character can wear),
    • Sections based on item category: trade goods, consumables, recipes, ...
    • Manual filtering (drag and drop items on section header, or add new section from the configuration panel),
    • Ammunition and warlocks’ soul shards,
    • Free space.
  • Smart item sorting inside each section.
  • Smart section layout ; change the setting “Automatic layout update” to control the frequency of updates.
  • Track new items ; use the [N] button resets the “new” flag.
  • Display slot type.
  • Bag tidy ; click on the [T] button.
  • Hide some sections, using the [V] button.
  • Name-based search.
  • Equipped bags (click on the bag icon in the top left corner),
  • Display character money in the backpack.
  • Display character tokens in the backpack.
  • LDB data source, displaying free space.
  • Two bag placement modes (choose one in the configuration panel):
    • Anchored: the bags expand from an anchor towards the center of the screen. The anchor can be unlocked and moved.
    • Manual: move the bags by dragging their title.

Separate modules

I have written two separate modules for AdiBags:

Tips & tricks

  • you can create your own sections using the “manual filter” in filter configuration. You can then drag and drop items on section titles to reassign them ; this works for any section.
  • if you want to highlight new items without putting them into a specific section, edit the “new items” filter priority to put it at the end of the filter list.

Known issues

  • All items are always news / new items are not detected / item sets are not working: AdiBags is (ab)using the game API to emulate some features that is was not meant to do. It relies on some timings that depend on your computer speed, your realm server and/or your network connection (because the game is inherently asynchronous). In some cases, it just does not work and there is almost nothing I can do because I cannot reproduce the bug to diagnose it and to try to fix it. So basically, if the new item or item set filters are not working for you, there is little chance I can fix it.
  • Protected action/addon blocked error: they sometimes happen with AdiBags. Even though my effort, I can not reproduce these. Blizzard taint reports are very buggy, often blaming the wrong addon. As such they are pretty much useless.
  • Please note that prospecting, disenchanting or milling can create new items (e.g. that were not in your inventory yet). This can cause the whole bag to be updated. In this case, the items that were under your mouse cursor may move around. There is no easy solution for this so be cautious.

Things that likely will not be implemented

Anything else than the existing “all-in-one” views

AdiBags has been built around, and optimized for, the idea of the “all-in-one” view. Doing anything would require to redesign big parts of the addons, especially the layout code that is quite complex at the first place.

Anything that requires to scan item tooltips

Tooltip scanning is quite CPU-consuming and above all requires asynchronous programming, since item tooltips would not always be available at the time AdiBags should use them. This would raise the complexity of bag filtering be an order of magnitude and turn AdiBags into a CPU hog.

Some examples what requires to scan the item tooltips:

  • detecting the kind and state of binding: unbound, soulbound, bind-on-pickup, bind-on-equip…
  • detecting already known spells/pets/recipes or faction/race/level/skill/class restrictions ; basically any “red text” in the tooltip.

Guild bank

AdiBags presents you a nice view of your bags but actually they are in a complete mess. With AdiBags, there is no need and no way to tidy up the items in the actual bags. Guilds usually try to keep their bank tidy. What would happen if some people in a guild used AdiBags for the guild bank ? Well, they would mess up the guild bank content and people NOT using AdiBags would have to deal with that mess. I can hear the screams from there. So that is why I will not implement guild bank.

Alt bags and bank

AdiBags is not an alt bags/bank viewer. If you want to keep track of what your alt owns, I suggest using an addon like BagSync.

Full bag skinning

Basic skinning is available using LibSharedMedia-1.0: you can choose the bag font, background and border, as well as the color.

Comprehensive in-game filter/section editor

According to my experience with Baggins, comprehensive editor is awful to write as an author and awful to use as an user. Hence I focus on creating filters that have a smart built-in behavior and only a few options. I try to avoid the 20% of features that would require 80% of development effort.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Adirelle Adirelle Dec 01, 2012 at 08:48 UTC - 0 likes

    Concerning the new bag types, I have yet to find some information about them. I don't have any of them and the wiki pages about GetItemFamilly (which returns informations both about bag types and the items that goes in them) are outdated. Could anyone test this please ?

    /dump GetItemFamily("<insert a special bag link with shift+click there>")
    Last edited Dec 01, 2012 by Adirelle
  • Avatar of Cal Cal Dec 01, 2012 at 02:12 UTC - 0 likes

    @Tinkeritis: Go

    This would be a nice feature, as this is my only complaint so far. Absolutely hate it.

  • Avatar of Tinkeritis Tinkeritis Nov 23, 2012 at 14:49 UTC - 0 likes

    Hello, Does anyone know how to disable the 'Open Config Menu when right clicking within adibags field'??? I tried deleting the file AdiBags_Config but then i was unable to open the config window at all. Any help would be greatly appreciated.

  • Avatar of Alyred Alyred Nov 05, 2012 at 08:51 UTC - 0 likes

    Same here! Thanks for all your work, Adirelle!

  • Avatar of Vranx Vranx Nov 04, 2012 at 14:11 UTC - 0 likes

    Just wanted to say thanks. I have used AdiBags for a long time. I appreciate the time you have put into it.

  • Avatar of Alyred Alyred Nov 03, 2012 at 06:35 UTC - 0 likes

    Hmmm... in the current alpha (v1.5.6-28-g780af6d) how does one configure the manual filters? Seems the config button is gone and the category isn't listed...

  • Avatar of Alyred Alyred Oct 25, 2012 at 00:55 UTC - 0 likes

    Hi Adirelle!

    Looks like in 5.1 they're adding a new bag type for cooking. Any way we could get you to add in support for this bag and for the fishing bag they introduced sometime in Cataclysm?

    Adibags isn't quite sure how to display or deal with those fishing bags.

    Thanks again for all your work!

  • Avatar of Petraca Petraca Oct 01, 2012 at 15:43 UTC - 0 likes

    Right now i look for a replacement for baggins and while trying out "adibags" i found three points that drive me crazy

    • can we have a switch to show new items also their category? Sometimes i have 20 new items in the bag, know that i just got a quest item and start looking in the quest category.
    • I would like to turn "merge stacks" on and off from the bag ui
    • I understand why you skip scanning the item tooltip. Could I have at least a string search for the tooltip?
  • Avatar of tenshiyuki tenshiyuki Apr 08, 2012 at 14:07 UTC - 0 likes

    separate config for bag-bank will be great. new items in bag its usefull, but new items in bank its not funny

  • Avatar of enkil80 enkil80 Mar 27, 2012 at 20:17 UTC - 0 likes

    same as twopro I've been having a lot of problems and I cant find any solution, I cant use healthstones or items at midfight and I cant disable or reloaui in there, is there any way to prevent or fix this?


Date created
May 07, 2010
Last update
Aug 09, 2014
Development stage
  • enUS
  • frFR
All Rights Reserved
Curse link
Recent files