GudaBags

GudaBags is a lightweight, all-in-one bag replacement for World of Warcraft. It combines all your bags into one clean window with smart categories, one-click sorting, search and filters, item protection, cross-character tracking, and full support for Classic Era, TBC, MoP Classic, and Retail

---

Key Features

Three View Modes

• Category View — Items are automatically sorted into smart groups like Equipment, Consumables, Trade Goods, Quest Items, and more. Click any category to collapse or expand it.
• Single View — A classic flat grid. All your items in one clean window, just like the default bags but better.
• Split View — Your bags shown as separate side-by-side columns. You can set how many columns to display and choose which bags get full-width rows (backpack, reagent bag, or keyring).

Switch between views anytime from the settings. Bag and bank views are configured independently.

Smart Sorting

One click to organize everything:

• Groups items by type, subtype, quality, and name
• Automatically restacks partial stacks to free up space
• Smooth, lag-free sorting — no freezing, no UI lockup
• Optional right-to-left and reverse stack sorting
• On Retail: choose between Blizzard's native sort or GudaBags' custom sort engine

Category System

22 built-in categories with full customization:

• Recent Items, Quest, Junk, BoE, Warbound, Weapons, Armor, Consumables, Trade Goods, and more
• Recent Items — A special category that highlights items you picked up recently. You can set how long items stay there (1–60 minutes)
• Category Groups — Categories are organized into groups (Main, Other, Class) with collapsible headers
• Merge Groups — Combine all categories in a group into one section for a cleaner layout
• Custom Categories — Create your own using 16 rule types: item type, name pattern, quality, tooltip text, and more
• Drag-and-drop — Reorder categories and move them between groups
• Match modes: "Any rule matches" (OR) or "All rules match" (AND)
• Group Identical Items — Stack identical items visually in category view for a tidier look

Search & Filtering

• Search Bar — Start typing to instantly find items by name. Only matching items are shown.
• Filter Chips — Quick filter buttons right below the search bar. Filter by quality (Uncommon, Rare, Epic…), item type (Weapon, Armor, Consumable…), or special tags like BoE and Recently Picked Up. Click a chip to toggle it on or off.

---

Quick Access Bars

Two floating bars that stay visible outside the bag window:

Quest Item Bar

All your usable quest items in one place — no more digging through bags mid-quest.

• Click to use items directly
• Hover to reveal additional quest items
• Auto-hides in battlegrounds (you can turn this off)
• Adjustable icon size and column count

Tracked Item Bar

Pin any item you want to keep an eye on. Great for farming herbs, ores, cloth, or reputation items.

• Ctrl+Alt+Click any item to start or stop tracking it
• Shows the combined count from all your bags
• Your tracked items are saved between sessions

---

Bank Support

Full bank management with the same clean interface:

• All three view modes available — category, single, or split
• Offline bank viewing for any saved character
• Retail: Character bank tabs + Warband bank tabs with deposit and withdraw
• Classic: Traditional bank bag slots with purchase support

---

Mailbox Viewer

View mailbox contents in the same clean GudaBags style:

• Offline mail viewing — See your mail items after leaving the mailbox
• Cross-character mail — View any saved character's mailbox
• AH purchase prediction — Items you buy from the auction house appear in your mail view before the mail arrives
• Alt mail prediction — Mail sent to your alts shows up in their mailbox view right away
• Money totals across all mail

---

Guild Bank

Full guild bank replacement with tab navigation, search, and offline data saving. Available on TBC Classic and later.

---

Cross-Character Tracking

• Tooltip item counts — Hover over any item to see how many you have across all characters on the realm, broken down by bags, bank, mail, and equipped
• Warband Bank counts — On Retail, tooltip counts also include your Warband Bank (shown as a separate line)
• Offline character viewing — Browse other characters' bags, bank, and mail without logging in
• Total gold display — See your combined gold across all characters in the footer
• Currency display — Relevant currencies for your expansion are shown in the footer

---

Item Protection

• Item Locking — Lock any item to prevent it from being sold, deleted, or disenchanted by accident. Locked items show a lock icon and are protected when you visit a merchant.
• Equipment Set Protection — Items that belong to an equipment set are automatically protected from being sold. You can turn this on or off in settings.

---

Automation

• Auto Open/Close Bags — Bags open automatically when you visit a merchant, mailbox, auction house, bank, or trade window, and close when you leave. Both can be toggled separately.
• Auto Sell Junk — Gray items are sold automatically when you visit a merchant. Locked and equipment set items are always protected.
• Auto Repair — Your gear is repaired automatically when you visit a merchant that can repair. Disabled by default — enable it in settings.

---

Customization

Open settings with /gb config or click the gear icon.

Appearance

• Two themes: Guda (dark, minimal) and Blizzard (native WoW look)
• Icon size (22–64px), font size, spacing
• Background opacity (0–100%)
• Window locking to prevent accidental moves

Item Display

• Quality color borders (separate toggles for equipment and other items)
• Unusable item marking
• Junk graying (with an option to include white equippable items)
• Equipment set indicators
• Item level on icons (Retail)

Layout

• Configurable columns: 5–22 for bags, 5–36 for bank, 10–36 for guild bank
• Show or hide the search bar, filter chips, footer, and category item counts
• Group identical items in category view
• Equipment sets shown as named categories

Profiles

• Save your current settings as a named profile
• Load, delete, or reset profiles at any time
• Import and export profiles to share with friends or transfer between characters

 

---

Multi-Expansion Support

GudaBags automatically detects your WoW version and enables the right features:

Expansion	Special Features
Classic Era	Keyring, quiver & ammo bags, soul bags
TBC Classic	Keyring, quiver & ammo bags, guild bank
MoP Classic	Gem bags, inscription bags, guild bank, currency display
Retail (TWW)	Reagent bag, character & warband bank tabs, item level display, currency display, native sorting

---

Equipment Set Integration

Works with multiple equipment set addons:

• Blizzard Equipment Manager (Retail/Wrath+)
• ItemRack (Classic/TBC)
• Outfitter

Equipment set items are visually marked, and each set can appear as its own category in category view.

---

Slash Commands

Command	Description
/gb or /guda	Toggle bags
/gb sort	Sort your bags
/gb bank	Toggle bank (when at banker)
/gb config	Open settings
/gb chars	List saved characters
/gb count <itemID>	Count an item across all characters
/gb save	Force-save bags to database
/gb status	Show detected expansion and enabled features
/gb help	Show all commands

---

Localization

GudaBags supports 11 languages: English, French, German, Russian, Portuguese, Spanish (Spain & Mexico), Chinese (Traditional & Simplified), Korean, and Italian.

---

Installation

From CurseForge

1. Use the CurseForge app to install automatically
2. Or download and extract to: World of Warcraft/_anniversary_/Interface/AddOns/

Manual Install

1. Download the latest release
2. Extract the GudaBags folder to your AddOns directory
3. Restart WoW or type /reload

---

Feedback

Found a bug or have a feature request? Open an issue on Github!