BagRuleSorter

EN — Full project description

**Your equipment. Your rules.**

Bag Rule Sorter (BRS) helps you organize equipment within your character bags,
character bank and Warband bank using your own rules. Choose which bag or bank
tab should hold equipment based on category, binding, upgrade track or item level.

### Features

- Automatic localization for all 12 WoW client locales, including English and Spanish regional variants.

- Equipment categories, including ranged weapons.
- Global rules based on binding, upgrade track and item level.
- Clear priority: binding → upgrade track → item level → category.
- Category filters for global rules: send only Champion leather to a particular
  tab, for example, rather than all Champion equipment.
- Separate rules for bags, character bank and Warband bank.
- Per-character bag/bank rules and account-wide Warband-bank rules.
- Optional sorting of newly acquired equipment and optional sorting after
  depositing into the currently open bank area.
- Optional binding and upgrade-track markers on recognized equipment slots.
- Supported sort-button integration with separate clicks for rule sorting,
  gap cleanup and full Blizzard sorting.
- Standard styling or automatic visual adaptation, with specific ElvUI support.
- Minimap button and optional LibDataBroker entry for compatible displays.

Open settings with `/brs`. Start by assigning one category to a destination and
test using BRS's own sort button, then add global rules. Categories selected at
a global rule's destination act as filters there; without a category selection,
the rule applies to all recognized equipment categories.

BRS sorts within the selected context. It does not transfer items between bags,
the character bank and the Warband bank.

**Current release: v0.8.0 Beta.** Testers using the default UI, ElvUI and other
bag/broker combinations are welcome. This beta does not promise error-free
operation. Start with unimportant items. The download includes a bilingual
introduction and practical test cases.

Copyright (c) 2026 wisco01. All Rights Reserved. The bundled custom license in
LICENSE.txt applies.

## EN — Beta notice / Call for testers

**Public beta – volunteer testers wanted!**
v0.8.0 Beta needs feedback on sorting rules, bank/Warband-bank behavior,
UI integration and slot markers. One particularly useful Titan Panel test:
enable BRS and toggle “Show on far right” on and off.
Please start with unimportant items. Even one reproducible test report helps;
successful tests are welcome too. See BETA_TESTING.txt for instructions.

## EN — Installation

Exit the game and extract the `BagRuleSorter` folder from the ZIP into
`World of Warcraft/_retail_/Interface/AddOns/`. The resulting path must be
`.../AddOns/BagRuleSorter/BagRuleSorter.toc`. For updates, remove the old addon
files first and back up existing settings if needed. Enable BRS in the addon
list and open it in-game with `/brs`. Intended for Retail; the bundled TOC uses
interface 120100.

## EN — Known limitations

- Beta: sorting and addon integration need further testing in actual use.
- Equipment-focused; not a general sorter for every item type.
- No transfers between bags, character bank and Warband bank.
- The default backpack (Bag 0) cannot be assigned as a rule destination.
- Only equipped bags and purchased bank tabs are available as destinations.
- The included item-level ranges are fixed.
- Markers and integrated sort buttons depend on UI detection; universal
  third-party bag-addon support is not claimed.
- Intended for Retail; Classic support is not claimed.
- Grid/position rules and a cleanup/deletion system are not included.
- Shift + right-click on an integrated sort button invokes full Blizzard
  sorting and may change BRS-sorted positions.

## EN — Feedback / Bug reports

Use the official feedback options on this CurseForge project page. Include your
BRS version, WoW version/build, client language and UI/bag/broker addon versions.
Describe the rules, affected context, exact steps and expected/actual result.
For sorting issues, include the item link, original position, destination and
free destination slots. Where possible, add a screenshot, the complete Lua
error and relevant `/brs debug` output. Stop after unexpected moves and capture
the state. Remove personal information before sharing. A report template is
included in BETA_TESTING.txt.

## EN — Short changelog: v0.8.0 Beta

- First public beta in the v0.8 series.
- 12 locale files with automatic selection based on the WoW client language.
- Localized UI text, tooltips and diagnostic messages.
- Fixed tooltip upgrade-track recognition: item names are excluded; English Myth
  and right-column upgrade lines are recognized.
- Added localized binding/track recognition, text wrapping and font fallbacks.
- Updated German/English README and BETA_TESTING.txt; license unchanged.

## DE — Ausführliche Projektbeschreibung

**Deine Ausrüstung. Deine Regeln.**

Bag Rule Sorter (BRS) hilft dir, Ausrüstung innerhalb deiner Charaktertaschen,
der normalen Bank und der Kriegsmeutenbank nach eigenen Regeln einzuordnen.
Lege fest, welche Ausrüstung in welche Tasche oder welches Bankfach gehört –
nach Kategorie, Bindung, Aufwertungspfad oder Gegenstandsstufe.

### Funktionen

- Automatische Lokalisierung für alle 12 WoW-Clientkennungen einschließlich englischer und spanischer Regionalvarianten.

- Ausrüstungskategorien einschließlich Distanzwaffen.
- Globale Regeln nach Bindung, Aufwertungspfad und Gegenstandsstufe.
- Klare Priorität: Bindung → Aufwertungspfad → Gegenstandsstufe → Kategorie.
- Kategorie-Filter für globale Regeln: beispielsweise nur Champion-Leder in
  einem bestimmten Fach statt aller Champion-Ausrüstung.
- Getrennte Regeln für Taschen, normale Bank und Kriegsmeutenbank.
- Taschen- und normale Bankregeln pro Charakter; Warbank-Regeln accountweit.
- Optionale automatische Einsortierung neu erhaltener Ausrüstung und optionales
  Nachsortieren nach Einlagern im geöffneten Bankbereich.
- Optionale Bindungs- und Aufwertungspfad-Marker auf erkannten Ausrüstungsslots.
- Integration unterstützter Sortierbuttons mit Regelsortierung, Lückenbereinigung
  und vollständiger Blizzard-Sortierung als getrennten Klickaktionen.
- Standardoberfläche oder automatische optische Anpassung, insbesondere an ElvUI.
- Minimap-Button und optionaler LibDataBroker-Eintrag für kompatible Anzeigen.

Mit `/brs` öffnest du die Einstellungen. Weise zunächst eine Kategorie einem
Ziel zu und teste über den eigenen BRS-Sortierbutton. Ergänze danach globale
Regeln. Kategorien im Ziel einer globalen Regel dienen dort als Filter; ohne
Kategorieauswahl gilt die Regel für alle erkannten Ausrüstungskategorien.

BRS sortiert innerhalb des gewählten Bereichs. Es überträgt keine Gegenstände
zwischen Taschen, normaler Bank und Kriegsmeutenbank.

**Aktueller Stand: v0.8.0 Beta.** Gesucht werden Tester für die Standard-UI,
ElvUI und weitere Taschen-/Broker-Kombinationen. Die Beta ist noch keine
Zusage für fehlerfreien Betrieb. Bitte beginne mit unwichtigen Gegenständen.
Eine zweisprachige Einführung und konkrete Tests liegen dem Download bei.

Copyright (c) 2026 wisco01. All Rights Reserved. Es gilt die beiliegende
Custom License in LICENSE.txt.

## DE — Beta-Hinweis / Testaufruf

**Öffentliche Beta – freiwillige Tester gesucht!**
v0.8.0 Beta benötigt Rückmeldungen zu Sortierregeln, Bank-/Warbank-Verhalten,
UI-Integration und Slotmarkern. Besonders hilfreich ist der Titan-Panel-Test:
BRS einblenden und „Ganz rechts anzeigen“ ein- und wieder ausschalten.
Bitte zunächst mit unwichtigen Gegenständen testen. Schon ein einzelner
nachvollziehbarer Testbericht hilft; auch erfolgreiche Tests sind willkommen.
Die Anleitung findest du in BETA_TESTING.txt.

## DE — Installationshinweis

Spiel beenden und den Ordner `BagRuleSorter` aus der ZIP nach
`World of Warcraft/_retail_/Interface/AddOns/` entpacken. Danach muss die Datei
unter `.../AddOns/BagRuleSorter/BagRuleSorter.toc` liegen. Bei Updates alte
Addon-Dateien vorher entfernen und vorhandene Einstellungen bei Bedarf sichern.
BRS in der Addon-Auswahl aktivieren und im Spiel mit `/brs` öffnen.
Vorgesehen für Retail; die enthaltene TOC verwendet Interface 120100.

## DE — Bekannte Einschränkungen

- Beta: Sortierung und Addon-Integration benötigen weitere Praxistests.
- Fokus auf Ausrüstung; kein allgemeiner Sortierer für sämtliche Gegenstände.
- Keine Transfers zwischen Taschen, normaler Bank und Kriegsmeutenbank.
- Der Standardrucksack (Bag 0) ist kein zuweisbares Regelziel.
- Nur ausgerüstete Taschen und gekaufte Bankfächer stehen als Ziele bereit.
- Vorhandene Itemlevel-Bereiche sind fest vorgegeben.
- Marker und integrierte Sortierbuttons hängen von der erkannten UI ab;
  universelle Unterstützung fremder Taschenaddons ist nicht zugesagt.
- Für Retail vorgesehen; Classic-Unterstützung wird nicht zugesagt.
- Raster-/Positionsregeln und ein Cleanup-/Löschsystem sind nicht enthalten.
- Shift + Rechtsklick am integrierten Sortierbutton startet die vollständige
  Blizzard-Sortierung und kann BRS-Positionen verändern.

## DE — Feedback / Bugreports

Bitte nutze die offiziellen Feedbackmöglichkeiten dieser CurseForge-Projektseite.
Nenne BRS-Version, WoW-Version/Build, Client-Sprache und die Versionen deiner
UI-/Taschen-/Broker-Addons. Beschreibe Regeln, betroffenen Bereich, genaue
Schritte sowie erwartetes und tatsächliches Ergebnis. Bei Sortierfehlern helfen
Itemlink, Ausgangsposition, Ziel und freie Zielplätze. Ergänze nach Möglichkeit
einen Screenshot, die vollständige Lua-Fehlermeldung und relevante Ausgaben von
`/brs debug`. Nach unerwarteten Verschiebungen bitte stoppen und den Zustand
sichern. Persönliche Angaben vor dem Teilen entfernen. Eine Berichtsvorlage
steht in BETA_TESTING.txt.