Get an Epic Experience with Premium


Bags & Inventory Login to Add Favorites
  • World of Warcraft
  • 893 Monthly Downloads
  • Supports: 6.2.2
  • 416,101 Total Downloads
  • Updated 10/02/2015
  • Created 08/30/2005
  • 9,731 Favorites
  • Project Site
  • Comments
  • Release Type: Release
  • License: All Rights Reserved
  • Newest File: 2.98

About ItemRack

This is a mod to make swapping equipment easier through popout slot menus, equip slot buttons, gear sets and automated swaps.

ItemRackFu plugin by Gnarfoz:

ButtonFacade plugin by Romracer:

Quick Start Guide

Minimap button:

  • Right-click the minimap button to open options or create sets
  • Left-click the minimap button to choose a set
  • Shift-click the minimap button to unequip the last set equipped
  • Alt-click the minimap button to toggle events on/off

Dockable buttons:

  • Alt+click slots on the character sheet to create/remove buttons
  • Alt+click yourself in the character sheet to create/remove a set button
  • Alt+click the created buttons to toggle their auto-queue status
  • Shift+drag buttons to break them apart if they're docked to each other
  • Drag the menu's border around to dock it to a different side of buttons
  • Right-click the menu's border to rotate the menu
  • Size, alpha, spacing, etc are in options

Creating/equipping sets:

  • You create sets in the Sets tab after right-clicking the minimap button
  • Select slots for the set, choose a name and icon and click Save
  • Once a set is saved, there are several ways to equip it:
    1. Left-click the minimap button and choose the set
    2. Mouseover a set button you've created (Alt+click yourself in character sheet)
    3. Use a key binding you define in the set ("Bind Key" button)
    4. In macros with /itemrack equip setname
    5. In events or scripts that use EquipSet("setname")

Popout menus:

  • Click an item or set in a menu to equip it
  • Shift+click a set in a menu to unequip it
  • Alt+click an item in a menu to hide/unhide it
  • Hold Alt as you mouseover a slot to show all hidden items

While at a bank:

  • Items/sets in the bank have a blue border.
  • Selecting an item or set that's in the bank will pull it from the bank to your bags.
  • Selecting an item or set that's not in the bank will attempt to put it all into the bank.

Slash Commands

/itemrack : list the most common slash commands
/itemrack opt : summon the options GUI
/itemrack equip setname : equips a set
/itemrack reset : resets buttons
/itemrack reset everything : wipes all settings, sets and events
/itemrack lock/unlock : locks and unlocks the buttons
/itemrack toggle set name[, second set name] : equips/unequips "set name" (or swaps between two sets if a second set given)

Macro Functions

EquipSet("setname") equips "setname"
UnequipSet("setname") unequips "setname"
ToggleSet("setname") toggles (equips then unequips) "setname"
IsSetEquipped("setname") returns true if "setname" is equipped

In the unlikely event that another mod (or default UI in the future) uses these function names, you can use their long version ItemRack.EquipSet(), ItemRack.UnequipSet(), etc. This mod only commandeers the shortened names if they appear to be unused.


2.2 (re)introduces events. These are scripts to automatically equip and unequip gear as things happen in game.

To use an event:
1. In the 'Sets' tab, create or make sure you have a set you'd like to equip when the event happens.
2. In the 'Events' tab, click the red ? icon beside the event you want to use.
3. Choose the set for this event.
4. Ensure the event has a check beside it.

As events are enabled, a separate process watches for those events and equips (and unequips if chosen) as they happen.

If you want to create or edit an event, there are four types of events:

  • Buff: These events equip gear as you gain buffs. ie, Evocation, Drinking and being on a mount.
  • Stance: These events equip gear when you change stances or forms. ie, Battle Stance, Moonkin Form, Shadowform
  • Zone: These events equip gear when you're in one of a list of zones. ie, the PVP event includes all arena and BG maps.
  • Script: For those with lua knowledge, you can create your own event based on a game event. A couple examples are in the default events.

When dealing with events, it's good to keep some things in mind:

  • You'll get the most predictable behavior by having sets that don't overlap. If you're a warrior with a Tanking, DPS and PVP set, consider not including weapons in those sets. If you decide to make an event to swap in a 2H when you go into Berserker Stance and a 1h+shield when you go into Defensive Stance, you won't step on the toes of events that swap in PVP gear in a BG/arena or a tuxedo in a city.
  • A gold gear icon on the minimap button (and on the sets button if you've created one) means that events are enabled. If you decide you want to temporarily shut down all events, Alt+click the minimap button or the sets button. (You can disable events in options also)
  • For non-English users, you might want to edit the events that have English text within them. I try to keep it locale-independant when possible (ie, warrior and most druid stances use the numbers instead of names), but you'll never enter "Stormwind City" on a deDE client for the city event.
  • Script Events do not have a "set" defined to them like other events do. They need to EquipSet("setname") explicitly. Its set button will always be the macro keys icon.
  • Advanced users of 1.9x may notice the lack of a delay option in scripted events. I've decided to pull this down into the scripting system to streamline the event process. For now, you can use ItemRack.CreateTimer and ItemRack.StartTimer defined in ItemRack.lua.

__ New in 2.98 - By Kharthus __

* Fixed items with different enchants

__ New in 2.97 - By Kharthus __

* TOC update for 6.2 patch

__ New in 2.96 - By Kharthus __

* Fixed green icons in Sets screen

__ New in 2.95 - By Kharthus __

* TOC update for 6.1 patch

__ New in 2.94 - By Kharthus __

* Properly remove disabled events

__ New in 2.93 - By Kharthus __

* Added support for bonus stats in WoD (Thanks Gello)

__ New in 2.92 - By Kharthus __

* Fixed black and white buttons and gear icons

__ New in 2.91 - By Kharthus __

* Code cleanup for 6.0.2

__ New in 2.90 - By Kharthus __

* Fixed helm/cloak hiding

__ New in 2.89 - By Kharthus __

* TOC update for 6.0.2 patch

__ New in 2.88 - By Kharthus __

* TOC update for 5.4 patch

__ New in 2.87 - By Kharthus __

* New option for Hide the ItemRack buttons during pet battles

__ New in 2.86 - By Kharthus __

* Hide the ItemRack buttons during pet battles

__ New in 2.85 - By Kharthus __

* TOC update for 5.2 patch

__ New in 2.84 - By Kharthus __

* Fixed Monk off-hands

__ New in 2.83 - By Kharthus __

* TOC update for 5.1 patch

__ New in 2.82 - By Kharthus __

* Fixed dual spec events

__ New in 2.81 - By Kharthus __

* Attempt to fix GlyphUI problem

__ New in 2.8 - By Kharthus __

* Updates for MoP

- Change log up to this version removed from hosting site and archived in Change Log.txt

Addon Packs Containing This...


First Previous Page 6 of 98 Next Last
  • #1393

    Two things. I was getting the lag when I first updated. Make sure you clear your saved variables for item rack that fixed it for me. However since the patch the dual spec event hasn't been working for me. I have to manually switch gear.

  • #1397

    Found the issue with the dual spec event and it's been fixed.

  • #1394

    Events might be broken. There were some issues even in 4.3 and I haven't looked recently. I'll see if I can do anything. Some of the stuff is just beyond repair since ItemRack's code is so old.

  • #1390

    When right clicking on a glyph on the glyph page to assign it to a slot.

    Date: 2012-08-31 18:25:04
    ID: 3
    Error occured in: AddOn: ItemRack
    Count: 3
    Message: Error: AddOn ItemRack attempted to call a forbidden function (CastGlyph()) from a tainted execution path.
    [C]: CastGlyph()
    ...terface\AddOns\Blizzard_GlyphUI\Blizzard_GlyphUI.lua:527: GlyphFrameSpell_OnClick()
    [string "*:OnClick"]:1:
    [string "*:OnClick"]:1


  • #1392

    Working on that right now.

  • #1389

    Since Patch 5.0.4 when I use an other set to equip, it really slows down the game. Does everyone have the same problem?

  • #1391

    I'm not having any issues on my computer.

  • #1398

    With the newest version, it works fine. :)

  • #1388

    I am getting quite a few errors when loading into the game.   I get one of this one:

    Error occured in: AddOn: ItemRack
    Count: 2
    Message: Note: AddOn ItemRack attempted to call a protected function (SaveBindings()) during combat lockdown.
    [C]: SaveBindings()
    ItemRack\ItemRack.lua:1815: SetSetBindings()
    ItemRack\ItemRack.lua:373: InitCore()
    ItemRack\ItemRack.lua:183: func()
    ItemRack\ItemRack.lua:784: OnUpdate()
    [string "*:OnUpdate"]:1:
    [string "*:OnUpdate"]:1

    And then 21 of the following error:

    Error occured in: AddOn: ItemRack
    Count: 3
    Message: Note: AddOn ItemRack attempted to call a protected function (ItemRackButton20:SetAttribute()) during combat lockdown.
    [C]: SetAttribute()
    ItemRack\ItemRackButtons.lua:37: InitButtons()
    ItemRack\ItemRack.lua:184: func()
    ItemRack\ItemRack.lua:784: OnUpdate()
    [string "*:OnUpdate"]:1:
    [string "*:OnUpdate"]:1

  • #1387

    Favourite addon for years, i like it more than other equipment manager addons, because you can see the set item icons and even every set item stats & enchants and gems (on mouse-over just like in character screen) of any item in any set, even if the set items are in a bank, i have not seen other equipment manager addons with such feature, so was forced to browse bank inventory (cashed) items

    or to carry ALL item sets in my inventory bags

    JUST to compare the set item stats, that i left in a bank with boss loots to decide on the roll.

    Last edited by Saah88 on 12/26/2011 7:56:23 PM
  • #1386

    It's fixed!  Woot!

    I want to thank Gello (author) for making such a terrific addon.
    Itemrack is the quintessential gear manager as far as I'm concerned.

    I also want to thank Kharthus (new project manager) for all the fixes and for
    keeping this wonderful addon up todate.  Dealing with Blizzards coding whims
    can't be easy.

    Once again... many, many thanks.  =)


  • #1385
    I have a problem with events. I've set 2 events: 1st - on shiftin in bear form by choosing event type "stance"; and 2nd - script on shifting in another than bear form (caster,cant..). End a problem is when i shifting from bear form to another in combat i always shift in caster form! No mather what form i choose, it's always is caster.
  • #1384
    ALT Clicking my character in the character equipment screen no longer creates a "Sets" button. Is there a way to fix this or a command I can use to force it to appear?
  • #1382
    Anyone know how to make sets that have empty spots? I want to change my fishing hat and my fishing pole but not the other gear not matter if i am wearing my boom set or my tank set
  • #1381
    Note: If this has already been added to Item rack or is available else where, let me know because I can not upgrade my version of ItemRack w/o re-modding.

    Many months ago I looked for a mod that would colorize my item sets so I could easily move them in/out of the bank. Anyone who has changed their item set while the bank is open knows my pain. The closest thing I found was a mod called oGlow. This mod would colorize items based on their quality (epic (purple), superior (blue)...). So, I spliced ItemRack and oGlow together and now the items in my inventory are colorized based on their ItemRack set. If an item is in multiple item sets, it only uses 1 of the colors. See pic below.

    I am posting this here as a idea for the mod author.

    My 'hacked' versions of oGlow and ItemRack (1.992) are available for the author should he want them.
  • To post a comment, please login or register a new account.
Login to Curse

Don't have an account? Create One.

Get an epic experience with Curse Premium
  • Faster addon downloads
  • Premium-Only Beta Giveaways
  • Ad-Free Curse experience
  • Premium Curse Client
  • and many More Features
  • Learn More »

PAX South Alienware Giveaway