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.

About patch 6.0.2

Blizzard has introduced a lot of new inventory features with the patch 6.0.2. I (Adirelle, AdiBags’ author) have absolutely no control over the way these built-in features work. It is all or nothing: either AdiBags uses a feature as is, either I have to code it myself. I had some of these features built into AdiBags in the past, but this was clumsy, using the API in a way that it was not meant to, and ultimately buggy for some users. So I decided to remove my code in favor of the built-in ones, even if it meant a minor degration of the original feature. If Blizzard improves some of these features in the future, AdiBags will automatically benefit from these improvements.

So, in short:

  • AdiBags now uses the built-in “new itemAPI, though it only detects looted/crafted/reward items. I added another module to highlight you what moves in bags to compensate for the loss of full item detection.
  • AdiBags now uses the built-in “sort bags“ feature. It may cause a spike of lag but works very quickly and does the job right.
  • AdiBags fully supports the reagent bank, including the built-in “deposit all reagents” feature. I know it moves enchanters’ velum to the reagent tab, but hopefully Blizzard will fix this.


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),
    • 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 sorting: left-click on the [S] button; right-click toggles auto-sorting, which sorts the bag on close.
  • 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

  • New items detection does not work like it did before 1.8: Ihis is normal. I switched to the NewItems API that Blizzard has added in patch 6.0. This API does not work for bank nor items coming from the bank or the mailbox, but it does not having the timing issue my code had.
  • Opening the bank or closing my bag cause lag spike: this is an know issue with Blizzard bag sorting. For now, it is called every time you close your bag with auto-sorting enabled. I am working on a solution to sort bags only if their content actually changed.
  • 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 Kinless Kinless May 22, 2010 at 13:31 UTC - 0 likes

    B: v1.0-beta-2-1 working again.  Thanks!  Well, the bags are.

    However, going into Interface, and using AdiBags Configure I get the error below.  (The bags keep on working though.)

    Date: 2010-05-22 09:34:40
    ID: 1
    Error occured in: Global
    Count: 1
    Message: ...nfig-3.0\AceConfigDialog-3.0\AceConfigDialog-3.0.lua line 1750:
       AceConfigRegistry-3.0:ValidateOptionsTable(): expected a string or funcref, got 'true'
       (tail call): ?
       (tail call): ?
       [C]: ?
       ...-3.0\AceConfigRegistry-3.0\AceConfigRegistry-3.0.lua:258 ValidateOptionsTable()
       ...-3.0\AceConfigRegistry-3.0\AceConfigRegistry-3.0.lua:308 app()
       ...nfig-3.0\AceConfigDialog-3.0\AceConfigDialog-3.0.lua:1750 Open()
       (tail call): ?
       [C]: ?
       [string "safecall Dispatcher[1]"]:9:
          [string "safecall Dispatcher[1]"]:5
       (tail call): ?

    Last edited May 22, 2010 by Kinless
  • Avatar of Kinless Kinless May 21, 2010 at 22:25 UTC - 0 likes

    Most recent patch, beta 2-19, and I'm getting same error which leaves me bagless until I log out and disable AdiBags.


    Date: 2010-05-21 18:22:35
    ID: 1
    Error occured in: Global
    Count: 1
    Message: attempt to concatenate a boolean value
       (tail call): ?
       [C]: ?
       [C]: strjoin()
       AdiBags\widgets\ContainerFrame.lua:359 GetSection()
       AdiBags\widgets\ContainerFrame.lua:387 DispatchItem()
       AdiBags\widgets\ContainerFrame.lua:433 UpdateButtons()
       AdiBags\widgets\ContainerFrame.lua:218 UpdateAllContent()
       AdiBags\widgets\ContainerFrame.lua:153 RegisterUpdateEvents()
       [C]: Show()
       AdiBags\AdiBags.lua:329 Open()
       (tail call): ?
       [string "OPENALLBAGS"]:1:
          [string "OPENALLBAGS"]:1
      Swatter, v3.1.14 (<%codename%>)
      AddonLoader, v2.0
      AdiBags, vv1.0-beta-2
      Altoholic, v3.3.002
      Atlas, v1.16.0
      AtlasBattlegrounds, v1.15.2
      AtlasDungeonLocs, v1.15.2
      AtlasOutdoorRaids, v1.15.2
      AtlasTransportation, v1.15.2
      AtlasLoot, vv5.10.01
      AtlasLootFu, vv5.10.01
      AtlasQuest, v4.4.1
      Babylonian, v5.1.DEV.130
      BlizzMove, vv0.7
      BrokenLFD, v@project-version@
      BrokerEquipment, v30300.9-Release
      BrokerSmartBuff, v3.2a
      BrokerWintergrasper, v1.3.3
      ButtonFacade, v3.3.300
      ButtonFacadeDarion, v3.0.3.2
      Buttonrange, v
      caelNamePlates, v
      cargoHonor, v2.4
      ccSpeed, v0.4
      CharacterEquip, v
      ChocolateBar, vv2.0.1
      Configator, v5.1.DEV.190
      ConfirmLootRoll, v
      DataStore, v3.3.001
      DataStoreAchievements, v3.3.001
      DataStoreAuctions, v3.3.001
      DataStoreCharacters, v3.3.001
      DataStoreContainers, v3.3.001
      DataStoreCrafts, v3.3.001
      DataStoreCurrencies, v3.3.001
      DataStoreInventory, v3.3.001
      DataStoreMails, v3.3.001
      DataStorePets, v3.3.001
      DataStoreQuests, v3.3.001
      DataStoreReputations, v3.3.001
      DataStoreSkills, v3.3.001
      DataStoreSpells, v3.3.001
      DataStoreStats, v3.3.001
      DataStoreTalents, v3.3.001
      Decursive, v2.5.0_ReleaseCandidate-1
      Dominos, v1.16.3
      DominosCast, v
      DominosRoll, v
      DominosTotems, v
      DominosXP, v
      EasySerum, v1.06
      Examiner, v09.12.16
      Fizzle, vv1.5.1
      FizzleInventory, v1.8
      Gatherer, v3.1.14
      GatherMate, vr691
      GemWatch, v0.82
      gError, v1.1
      HandyNotes, v1.1.5
      HandyNotesFlightMasters, v1.0.4
      HealBot, v3.3.3.4
      HelmNCloak, v30300-1
      IceHUD, v1.6.2 (Revision: 509)
      IgnoreMore, v1.1.0
      InlineAura, vr104
      IronChef, v
      JoustDoIt, v3.3.3.6
      LibHealComm40, v
      Lootcounter, v
      LushAdvancedLoot, v
      Mapster, v1.3.8
      MikScrollingBattleText, v5.4.78
      MrTrader, v0.5
      Multishot, vr44
      NatchAtlasQuestHelper, vv0.1
      OmniCC, v2.5.9
      PalaInstantCast, v0.3.30300
      Portfolio, v1.22
      Prat30, v3.3.11
      Prat30Libraries, v
      Quelevel, v3.3.0.9
      QuestMods, v
      QuestPointer, vv5-2-ged4fc14
      QueTip, v2.61
      SatrinaBuffFrame, v3.1
      Scrap, v
      SexyMap, v
      shPerformance, v4.0
      SickOfClickingDailies, vv6.3.8-beta
      SilverDragon, vv2.3.4-3-gb563639
      Skinner, vb3.11723.8
      SmartBuff, v3.3dDev1
      StatBlockDPS, v2.2.2
      StatScore, v3.3.0.20
      SwindlerPreventer, v3.3
      TipTac, v10.05.01
      TipTacItemRef, v10.02.27
      TipTacTalents, v10.02.27
      TomTom, v237
      TravelAgent, v3.3.3-1.0.4
      UnitFrameTweaks, v1.2
      WhoFramedWatcherWabbit, v1.5
      BlizRuntimeLib_enUS v3.3.3.30300 <us>

    Last edited May 22, 2010 by Kinless
  • Avatar of Kinless Kinless May 20, 2010 at 02:01 UTC - 0 likes

    Latest update breaks my bags...

    Date: 2010-05-19 21:58:30 ID: 1 Error occured in: Global Count: 1 Message: attempt to concatenate a boolean value Debug: (tail call): ? [C]: ? [C]: strjoin() AdiBags\widgets\ContainerFrame.lua:359: GetSection() AdiBags\widgets\ContainerFrame.lua:387: DispatchItem() AdiBags\widgets\ContainerFrame.lua:433: UpdateButtons() AdiBags\widgets\ContainerFrame.lua:218: UpdateAllContent() AdiBags\widgets\ContainerFrame.lua:153: RegisterUpdateEvents() AdiBags\widgets\ContainerFrame.lua:200: AdiBags\widgets\ContainerFrame.lua:195 [C]: Show() AdiBags\AdiBags.lua:329: Open() AdiBags\AdiBags.lua:425: AdiBags\AdiBags.lua:419 (tail call): ? [string "OPENALLBAGS"]:1: [string "OPENALLBAGS"]:1

  • Avatar of orthwein orthwein May 19, 2010 at 13:27 UTC - 0 likes

    Beta2 onwards shows empty bags for me, along with this error when I try to open the config:

    AceConfigDialog-3.0-47:1750: AceConfigRegistry-3.0:ValidateOptionsTable(): expected a string or funcref, got 'true'
    AceConfigRegistry-3.0-12:50: in function <...-3.0\AceConfigRegistry-3.0\AceConfigRegistry-3.0.lua:45>
    AceConfigRegistry-3.0-12:186: in function <...-3.0\AceConfigRegistry-3.0\AceConfigRegistry-3.0.lua:181>
    AceConfigRegistry-3.0-12:220: in function <...-3.0\AceConfigRegistry-3.0\AceConfigRegistry-3.0.lua:195>
    AceConfigRegistry-3.0-12:230: in function <...-3.0\AceConfigRegistry-3.0\AceConfigRegistry-3.0.lua:195>
    AceConfigRegistry-3.0-12:230: in function <...-3.0\AceConfigRegistry-3.0\AceConfigRegistry-3.0.lua:195>
    AceConfigRegistry-3.0-12:258: in function `ValidateOptionsTable'
    AceConfigRegistry-3.0-12:308: in function `app'
    AceConfigDialog-3.0-47:1750: in function `Open'
    AdiBags-v1.0-beta-2-2-gcecaca5\Options.lua:484: in function `OpenOptions'
    AdiBags-v1.0-beta-2-2-gcecaca5\modules\DataSource.lua:22: in function `OnClick'
    ChocolateBar-r107\Chocolate.lua:233: in function <ChocolateBar\Chocolate.lua:230>
    msg = ": expected a string or funcref, got 'true'"
    errlvl = 6
    t = <table> {
     1 = "AdiBags"
     2 = "args"
     3 = "filters"
     4 = "args"
     5 = "JunkBasic"
     6 = "name"
    select = <function> defined =[C]:-1
    tinsert = <function> defined =[C]:-1
    error = <function> defined =[C]:-1
    MAJOR = "AceConfigRegistry-3.0"
    tconcat = <function> defined =[C]:-1
    Last edited May 19, 2010 by orthwein
  • Avatar of Adirelle Adirelle May 18, 2010 at 05:19 UTC - 0 likes

    @gamemaster128: no kidding ? :)

  • Avatar of PoMR PoMR May 17, 2010 at 16:36 UTC - 0 likes

    Glad to have helped with the bug report. =)

    Was it also causing the multiple stacks thing?

    Can't wait to get home and check it out!

  • Avatar of Talyrius Talyrius May 17, 2010 at 15:33 UTC - 0 likes

    Perhaps there should be a minimum width for the bag frame?

  • Avatar of Adirelle Adirelle May 17, 2010 at 13:48 UTC - 0 likes

    Every item in the "new" section at login was indeed a bug (alpha!) that I hopefully fixed.

  • Avatar of PoMR PoMR May 17, 2010 at 11:28 UTC - 0 likes

    The most recent build (r20100516210139) is sorting oddly.

    Every time I login it treats my bags as if everything in them is new. Also, if you have multiple stacks of an item and get a new one of the same kind all the stacks move to the top as new.

    If these behaviors are by design then I would very strongly urge you to go back to the old method of checking for items, this is not at all a good way to do the sorting in my honest opinion and would be enough to make me go back to Bagnon, especially since in your forum thread you said that you weren't going to allow remote viewing of the bank.

    I really love this addon, I just won't be using it if the sorting things I mentioned are working as intended. =)

    Last edited May 17, 2010 by PoMR
  • Avatar of Kinless Kinless May 16, 2010 at 14:29 UTC - 0 likes

    The add-on meets every need I have now. (I even got to delete broker_money with the latest update.)

    For caring for my alts I already use Altoholic, so if anyone is needing a "alt's bank account view," or the tooltip view of who has how many of something, Altoholic will address that, and much more.

    But for the business of seeing what's in my bags, this add-on works great. Simple and clean.



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