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.

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.

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.

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.

In Action

Full Bag View

Gear Bag View

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.