Description
BlockyBag
A clean, feature-rich all-in-one bag and bank replacement for TBC Classic (Interface 20504).
BlockyBag replaces Blizzard's default bag and bank frames with a single unified window for each — no more juggling five separate bag containers. Everything lives in one draggable, resizable frame that stays out of your way when you don't need it and shows you exactly what you need when you do.
Features
One bag, all your slots All five of your character's bags are combined into a single scrollable frame. The Blizzard default bag windows are suppressed entirely — BlockyBag intercepts every bag-open path (bag bar buttons, B key, macros, addon calls) and shows its own frame instead.
Matching bank frame BlockyBank mirrors the player bag experience at the bank. Your 28 built-in bank slots and up to 7 purchased bank bags are all displayed together in the same style. The bank frame opens automatically when you visit a banker and closes when you walk away.
Custom item categories Create named, color-coded sections (e.g. "Consumables," "Gear," "Materials") and pin items to them with a right-click. Pinned items are always sorted into their section, and sections are displayed as side-by-side panels inside the frame. Categories are saved per character and shared between your bag and bank frames so the same category can appear in both.
Automatic quest item sorting If you create a category named "Quest Items," BlockyBag automatically detects quest items using both tooltip scanning and the item type/subtype API and pins them into that section without any manual effort. A polished popup alert also appears on screen the moment a quest-starter item lands in your bags — even while the bag frame is closed.
Junk section Grey (Poor quality) items are automatically grouped into a dedicated Junk section at the bottom of the frame. Right-click any junk item to permanently move it back to the General section if you want to keep it.
New loot glow Slots that receive a genuinely new item (looted, traded, received from mail) pulse with a golden glow for a few seconds. Moving items between slots never triggers a false glow — BlockyBag uses a multiset snapshot comparison to tell the difference.
Live item search A search bar filters the visible slots in real time. You can search by item name, quality color (e.g. "blue," "epic"), item type, item subtype, equipment slot (e.g. "helm," "trinket," "offhand"), or bind type (e.g. "bop," "boe," "quest"). Both the bag and bank frames have independent search bars.
Quality-colored slot borders Every occupied slot displays a colored border matching its item quality tier — grey for Poor, white for Common, green for Uncommon, blue for Rare, purple for Epic, orange for Legendary, and so on. Empty slots have a subtle dim border so the grid stays readable.
Cooldown countdown Items on cooldown show a live countdown timer directly on the slot icon, driven by a single shared ticker so performance stays clean regardless of how many slots are on screen.
Gold display Your current gold, silver, and copper is displayed in the bag frame header in the standard WoW color scheme (gold / silver / copper). It updates in real time as you earn or spend money.
Bag tab row A row of tabs at the top of the bag frame shows the icon of each equipped bag (including your backpack). Clicking a tab scrolls the frame to that bag's slots. Tab icons update dynamically as you equip new bags.
Free slot counter The header shows how many free slots you currently have across all bags, updated on every bag change event.
Stack split dialog Right-click any stacked item and choose "Split Stack" to open a clean slider dialog for splitting the stack to an exact amount.
Draggable and resizable The bag and bank frames can be freely repositioned on screen by dragging the title bar. Column count, slot size, slot padding, section column count, and panel gap are all adjustable via sliders in a settings panel (accessible via /bb settings).
Vendor integration When a merchant window is open, items that have no sell value are visually flagged so you know what you can and cannot sell before you start clicking.
Key ring support The key ring section can be toggled on or off from within the bag frame.
Slash Commands
| Command | Action |
|---|---|
/bb |
Toggle the bag frame |
/bb settings |
Open the settings panel |
/bb search <text> |
Search your bags |
/bb help |
Print all available commands |
/bkdebug |
Toggle the bank debug overlay (developer tool) |
The B key is also bound by default to toggle the bag frame using an override binding that never modifies your saved keybind profile.
Mouse Controls
| Action | Result |
|---|---|
| Left-click | Use or pick up item |
| Right-click | Open context menu (pin to category, split stack, etc.) |
| Shift+Left-click | Link item in chat |
| Shift+Right-click | Split stack |
| Alt+Right-click | Remove item from its current category |
| Drag | Move item between slots |
Compatibility
- Game version: TBC Classic (Interface 20504)
- API: Fully compatible with both the legacy
GetContainerItemInfoglobals and the modernC_ContainerAPI. Bank bag -1 (built-in bank slots) uses the correct raw API path to avoid a known TBC 2.5.x issue whereC_Containerdoes not support bag -1. - Item count tracking: Cross-character item tracking is not built in — BlockyBag is designed to work alongside an external addon such as BagSync for that functionality.
- SavedVariables: Settings and category pins are saved per character (
BlockyBagDB). Cross-character sync data uses a separate saved variable (BlockySyncDB).
Notes
BlockyBag completely suppresses the default Blizzard bag and bank container frames using secure hooks and OnShow intercepts. No Blizzard container frame or key ring frame is ever shown while BlockyBag is loaded. The BankFrame is moved off-screen (not hidden) when the bank is open to keep the server's item data pipeline alive — a necessary workaround for TBC Classic's architecture.


