Categories - veechs/Bagshui GitHub Wiki

Bagshui Layout HierarchyA Category in Bagshui is the basic organizational building block.

ℹ️ Important notes

Built-in Categories are read-only

Although you cannot edit included Categories, you can create custom ones to essentially override the built-ins.
The default Sequence for custom Categories is lower than that of any included one, so the custom Category gets first dibs on item matching.

Categories vs. Groups

Even though many included Categories and Groups have the same names, there's nothing intrinsically linking them.

Item assignment

There are two methods of assigning items to Categories.

Rules

Dynamic and flexible item matching.

Assignments

A simple, static list of items based only on ID.

Limitations

Items with random suffixes ("of the Bear", etc.) all share the same ID. If you need to differentiate these, use the ItemString() or Name() rule functions.

Adding to a Category's Item Assignment list

Do any of the following:

  • Drag items from your inventory to the Category Editor.
  • Click the [+] button next to the Directly Assigned: field and paste one or more identifiers.
  • From the Item menu (accessed via Alt+right-click, or just normal right-click in Edit Mode), use the Category Assignment submenu.
  • While in Edit Mode, Alt+click (or Alt+drag) an item, then select a Group. A menu will open with Category assignment options.

Evaluation order

Each Category has a Sequence number between 0 and 100, where 0 is evaluated first and 100 last. An item will be assigned to the first Category within the active Structure that matches it.

Class Categories

Contain distinct Rules and Item Assignment item lists for each class. To see how this can be useful, refer to the built-in Class Items or Class Reagents Categories.

Management

Open the Category Manager from the main menu of any Bagshui inventory window or via the /bagshui categories command.

⚠️ **GitHub.com Fallback** ⚠️