![Patreon](https://img.shields.io/badge/Patreon-Become a Patron-F96854?style=for-the-badge&logo=patreon&logoColor=white)

BetterBags - Gear Categories

A BetterBags plugin that simplifies gear organisation so you can find items faster in your bags.

BetterBags - Gear Categories adds track-based and crafted gear categorisation for the Midnight expansion, giving you more control over how your gear is grouped inside BetterBags.

Instead of forcing a single setup, the addon lets you choose which categories you want active, customise their names and colours, adjust priority, and pin and order them where you want them.

Main Menu

Popup

Features

Adds BetterBags gear categories for Midnight
Supports the following categories:
- Crafted
- S1 Crafted
- Season 1
- Adventurer
- Veteran
- Champion
- Hero
- Myth
Enable or disable each category individually
Pin categories in BetterBags’ pinned section
Set custom category names
Set custom text colours for category labels
Set custom BetterBags priority values per category
Set custom pinned order values for pinned categories
Includes one-click actions to:
- Apply pending changes
- Apply priority changes
- Apply pinned order changes
- Reset name
- Reset colour
Shows per-category status text such as:
- Active
- Inactive
- Loading
- Unapplied changes
Includes bind filters for:
- Include BoE (can be BoW)
- Include BoW
Includes main settings for:
- Enforce order at creation/update
- Enforce order permanently

By default, BoE and Warbound-style items are excluded unless enabled.

Main Window

Ordering and Priority

This addon supports two different systems:

Priority

Priority controls which category wins an item when more than one category matches it.

It does not control where the category shows in BetterBags.

All categories default to priority 5.

Pinned Order

Pinned order controls where the category appears in BetterBags’ pinned section.

This only works for pinned categories. If a category is not pinned, BetterBags uses its normal sort behavior and the addon cannot force that section’s visible position.

Each category has a pinned-order input in its config panel, plus an apply button. That input is disabled when the category is not pinned.

Lower number = higher in the pinned list.

Default order:

Myth = 1
Hero = 2
Champion = 3
Veteran = 4
Adventurer = 5
Season 1 = 6
S1 Crafted = 7
Crafted = 8

Ordering Modes

The main config window includes two ordering options:

Enforce order at creation/update
Applies the configured pinned order when this addon creates or updates its categories.
Enforce order permanently
Reapplies the configured pinned order while the addon is running, so later category changes stay in the intended order.

Hero Config

How It Works

The addon uses BetterBags search categories backed by bonusid queries to identify supported gear tracks and crafted gear.

It provides separate track categories for:

Adventurer
Veteran
Champion
Hero
Myth

It also provides crafted categories for:

Midnight Crafted
Midnight S1: Crafted

The combined Season 1 category is built dynamically from whichever track categories are currently active, so it reflects your enabled sub-tracks.

For pinned categories, the addon stores and reapplies explicit pinned sort positions using BetterBags’ pinned-section sort data.

BetterBags Integration

Gear Categories integrates directly into BetterBags and adds its own plugin entry:

Gear Categories
Open Gear Categories button to open the full config window

Category changes automatically refresh BetterBags so your bag view updates immediately.

Veteran Config

In Action

Full Bag View

Bag View All

Gear Bag View

Bag View Gear

Current Scope

This addon is currently focused on Midnight and Season 1 gear categorisation.

It is not intended to be a fully generic multi-expansion bag framework at this time.

The long-term scope remains focused on:

Gear categorisation within BetterBags

Support for future seasons is planned, and new additions may be included over time based on user requests.

Technical Notes

Settings are saved in BBGT_DB
Categories are created and removed automatically when toggled
Active categories are restored after login
The addon retries setup until BetterBags’ category API is ready
Pinning is applied to both backpack and bank custom section sort data
Per-category pinned order values are stored in the database
Ordering can be enforced at creation/update or continuously
Legacy saved data is migrated into the current expansion/season structure

Inspiration

This addon idea was inspired by BetterBags_GearTracks by ZeptoGnome.

Best For

This plugin is intended for players who want cleaner seasonal and crafted gear sorting in BetterBags without overcomplicating their bag setup.