Bagforge

A lightweight, modern bag replacement forged for Midnight — categorized panels, smart search, and a full bank suite without the bloat.

Overview

Bagforge replaces Blizzard's default backpack and bank windows with a clean, cargBags-style layout: a main Bag panel plus optional category panels stacked above it (Recent Items, Equipment, Reagents, Quest Items, Junk, and more). Everything is event-driven, pooled, and tuned for performance, with Midnight (12.0) Secret-value guards throughout so combat and instance restrictions are handled safely.

• One window, many panels — specialty filters get their own bordered sections; the main bag panel owns search, sort, money, and controls.
• Fully toggleable — turn category filters off and run a single flat bag, or enable only the buckets you care about.
• Character + Warband bank — categorized bank views with deposit, sort, tab bar, and reagent-deposit toggle.
• Power-user organization — custom categories, saved search queries, stack merge, slot locks, and a visual category manager.
• Extensible — a plugin API lets other addons register categories, sort modes, and corner widgets (Pawn upgrade arrows ship built-in).
• Native settings — Blizzard's modern Settings API (Esc → Options → AddOns → Bagforge), with live-apply toggles wherever possible.

Requires: World of Warcraft retail Midnight (Interface 120000+).

Installation

Via an addon manager (recommended)

• CurseForge — search for Bagforge and install.

Manual

1. Download the latest release from the Releases page.
2. Extract the Bagforge folder into World of Warcraft\_retail_\Interface\AddOns.
3. Restart the game (or /reload if already in-game).

Bagforge replaces the default combined-bags UI while enabled. Disable the addon (or its bag suppression) if you need Blizzard's stock bags back.

Getting Started

In-window shortcuts

Configuration

Open the panel with /bf config (or Esc → Options → AddOns → Bagforge).

Settings groups

Most toggles apply live without /reload.

Features

Backpack window

• Categorized layout — optional specialty panels (Recent, Equipment, Reagents, Quest, Junk, Collections, Housing Decor, and more) stack above the main Bag panel; each panel is a bordered grid with a header.
• Main Bag panel — holds the search bar, sort/assign/junk/delete controls, gold display, tracked currencies, and the item grid.
• Free-slot box — trails the last item like cargBags: shows empty slot count and accepts click/drop to fill the next empty slot.
• Authenticator slots — when your account is not Battle.net Authenticator–secured, shows Blizzard's four padlocked backpack slots and green + button (same templates and popup as default combined bags).
• Bag bar — optional flyout for equipped bag slots (Bag 1–4, reagent bag).
• Blizzard suppression — hides the default combined-bags frame while Bagforge is active.
• Movable — drag the window; position is saved per character. Right-click close resets position.

Bank

• Character bank — categorized panels, deposit-all, sort, money footer, purchased-tab support.
• Warband bank — separate categorized window for account storage.
• Bank tabs — optional tab bar toggle.
• Deposit reagents — syncs with Blizzard's bankAutoDepositReagents CVar for deposit-all behaviour.
• Shared layout engine — same masonry column wrapping and category panels as the backpack.

Item filters (built-in categories)

Toggle each bucket independently under Filters → Enable Item Filters:

• Recent Items, Junk, Equipment Sets, Warbound Until Equipped, Legendary, Azerite Armor, Equipment, Collections, Housing Decor, Reagents, Consumables, Quest Items, Anima, Primordial Stones, Legacy, Lower Level (with item-level threshold).

Turn the master switch off to keep everything in one flat bag panel.

Custom organization

• Custom categories — pin any item to a named panel (/bf cat add, assign mode, or drag-drop onto a category panel).
• Saved search categories — rule-based panels using a compact query language (type:glyph, gear ilvl>=600, tt:use:, quality flags, name tokens, OR with |, NOT with !).
• Category Manager — rename, recolour headers, reorder, enable/disable, import/export JSON, and delete custom/search categories.
• Stack merge — collapse identical stacks into one button with combined count.
• Item sort — quality, name, item level, expansion, plus plugin-registered sort modes.
• Slot locks — exclude slots from sort, deposit, and vendor sweeps.
• Search box — filter the open view; optionally hide (or dim) non-matching items.

Item display

• Item level — quality-coloured ilvl on equippable gear.
• Bind status — BoE, BoU, BoA, WuE labels on unbound items.
• Unusable tint — red icons for wrong class or too-low level.
• Junk marker — coin overlay on grey and custom-junk items.
• Custom-category star — marks manually assigned items.
• Configurable corners — choose where ilvl, bind text, and markers appear.
• Pawn integration — optional green upgrade arrow when Pawn is installed.

Extras

• Auto vendor — optional auto-sell grey junk and/or custom-junk items at merchants; auto-repair with optional guild-fund preference.
• Delete cheapest — one-click destroy of the lowest vendor-value item (with confirmation and class-type protections).
• Quick delete mode — destroy sub-rare items without typing DELETE (armed from the toolbar).
• Flash find — Alt-click highlights every matching stack across open bags and bank.

Plugin API

Other addons can extend Bagforge without merging code:

1. Ship a separate addon with ## Dependencies: Bagforge in its .toc.
2. Call Bagforge.API:RegisterCategory, RegisterSortMode, and/or RegisterCornerWidget after load.
3. Plugin settings appear under Plugins; each source can be toggled off.

See Core/API.lua for the full contract (API.version = 2, pcall-guarded callbacks, debounced rescans).

Midnight (12.0) compatibility

Bagforge targets Midnight retail (Interface: 120000+). Secret Values are respected:

• No arithmetic or comparisons on combat/instance-secret data without issecretvalue guards.
• Tooltips use throttled rebuilds and Blizzard mixin paths where available.
• Quest objective counts, money, GUIDs, and similar APIs are handled with safe fallbacks.

Test thoroughly in combat, dungeons, and Mythic+ before relying on search queries that read tooltip text (tt: tokens cache for 60 seconds per slot).

Contributing

Contributions, bug reports, and ideas are welcome! Open an issue or a pull request. When filing a bug, include your client build, other bag addons (if any), and steps to reproduce after a /reload.

Building a plugin? Read Core/API.lua and register through Bagforge.API after ADDON_LOADED.

Credits

Bagforge stands on patterns and ideas from the wider addon community:

• cargBags — panel layout, free-slot trailing, category stacking model.
• Siweia (NDui) — category filters, custom junk, assign/delete modes, item-level overlays.
• BetterBags — saved search category grammar and plugin category registration.
• p3lim, yleaf, and the NexEnhance codebase — engine/module architecture, settings integration, and Midnight migration patterns.
• Pawn (Vger) — optional upgrade-arrow integration.

Thank you all.

Support

Appreciate the work that goes into Bagforge? Consider showing your support:

• PayPal — paypal.me/KkthnxTV
• Patreon — patreon.com/Kkthnx
• Battle.net / Balance — Kkthnx#1105 or JRussell20@gmail.com
• In-game gold — Kkthnx on Area 52 (US)

License

Released under the MIT License. See LICENSE for details.

Developed and maintained by Josh "Kkthnx" Russell. Forged for Midnight.