Custom Bag Categories

[JeanDeBoos]

Bag Custom Categories Guide

Overview

The custom category system allows you to organize your bag items with personalized categories. You can create two types of categories:

1. Manual Categories - Manually assign items to categories
2. Rule-Based Categories - Automatically categorize items based on rules

Manual Categories

Manual categories let you hand-pick which items belong in each category.

Creating a Manual Category

1. Open your Bag
2. Click on the Custom tab (last tab)
3. Click "Add Category"
4. Enter a category name
5. Select "Manual" type
6. Click the green checkmark

Assigning Items to Manual Categories

• Desktop: Right-click any item and select the category to assign it to
• Mobile: Long-press any item and select the category to assign it to

Example Use Cases

• Create a "Battle Items" category for your favorite battle items
• Create a "Trade Items" category for items you plan to trade
• Create a "Quest Items" category for items needed for specific quests
• Create a "Event" category for items like Shiny Tracker Safe Balls, Event Currency, ...

Rule-Based Categories

Rule-based categories automatically organize items based on patterns you define. Items are automatically assigned when they match your rules.

Creating a Rule-Based Category

1. Open your Bag
2. Click on the Custom tab
3. Click "Add Category"
4. Enter a category name
5. Select "Rules Based" type
6. Set the Priority (higher numbers take precedence)
7. Add one or more rules
8. Click the green checkmark

Rule Types

#### 1. Starts With
Matches items whose names begin with the specified text.

Examples:

• Rule: Starts With "Poké" → Matches: Poké Ball, Pokédoll, Poké Flute, ...
• Rule: Starts With "HM" → Matches: HM01, HM02, HM03, ...

#### 2. Ends With
Matches items whose names end with the specified text.

Examples:

• Rule: Ends With "Ball" → Matches: Poké Ball, Great Ball, Master Ball, but also Iron Ball
• Rule: Ends With "Berry" → Matches: Oran Berry, Sitrus Berry, Lum Berry

#### 3. Contains
Matches items whose names contain the specified text anywhere.

Examples:

• Rule: Contains "Potion" → Matches: Potion, Super Potion, Hyper Potion, Full Restore
• Rule: Contains "Stone" → Matches: Fire Stone, Water Stone, Thunder Stone, Hard Stone

#### 4. Exact Match
Matches items whose names exactly match the specified text.

Examples:

• Rule: Exact Match "Rare Candy" → Matches: Only "Rare Candy"
• Rule: Exact Match "Master Ball" → Matches: Only "Master Ball"

#### 5. Regex (Advanced)
Matches items using regular expressions for complex patterns.

Examples:

• Rule: Regex "^TM[0-9]{2}$" → Matches: TM01 through TM99 (but not TM100+)
• Rule: Regex "(Fire|Water |Grass )Stone"→ Matches: Fire Stone, Water Stone, Grass Stone
• Rule: Regex "Ball$|Disc$" → Matches: Any item ending with "Ball" or "Disc"

Case Sensitivity

Each rule can be case-sensitive or case-insensitive:

• Ignore Case (default): "potion" matches "Potion", "POTION", "potion"
• Case Sensitive: "Potion" only matches "Potion" (not "potion" or "POTION")

Multiple Rules (AND Logic)

When a category has multiple rules, ALL rules must match for an item to be assigned.

Example:

• Rule 1: Ends With "Mount"
• Rule 2:Contains "Mega"
• Result: Only matches Mounts of Mega pokemon.

Priority System

Items can only be in 1 category in your bag. When an item matches multiple rule-based categories, the priority determines which category gets the item.

How Priority Works

• Higher priority values take precedence
• Default priority is 0
• Priority range: 0 to 999
• Manual categories always override rule-based categories

Priority Examples

Scenario 1: Overlapping Ball Categories

Category: "Special Balls" (Priority: 20)
Rule: Starts With "Master" OR Starts With "Cherish"

Category: "All Pokéballs" (Priority: 10)
Rule: Ends With "Ball"

Result: Master Ball → Goes to "Special Balls" (priority 20 > 10)
Result: Poké Ball → Goes to "All Pokéballs" (only matches this one)

Scenario 2: TM Organisation

Category: "Powerful TMs" (Priority: 30)
Rule 1: Starts With "Gen9"
Rule 2: Regex (Beam|Blast|beam|blast) [means contains either beam or blast (case insensitive)]

Category: "Fire TMs" (Priority: 20)
Rule 1: Starts With "Gen9"
Rule 2: Regex (Fire|fire|Flame|flame|Heat|heat)

Category: "All TMs" (Priority: 10)
Rule: Starts With "Gen9"

Result: "TM35 Fire Blast" → Goes to "Powerful TMs" (priority 30)
Result: "TM38 Fire Punch" → Goes to "Fire TMs" (priority 20)
Result: "TM17 Protect" → Goes to "All TMs" (priority 10)

Practical Examples

Example 1: Organizing Battle Items
Create these categories with rules:

"Healing Items" (Priority: 15)

• Rule: Regex (Potion|potion|Restore|restore)

"Status Healers" (Priority: 20)

• Rule: Regex (Antidote|Awakening|Paralyze Heal)

"Battle Boosters" (Priority: 25)

• Rule: Starts With "X " (note the space)

Example 2: Organizing Pokéballs
Create these categories:

"Premium Balls" (Priority: 30)

• Rule 1: Ends With "Ball"
• Rule 2: Regex "(Master|Cherish|Premier)"

"Special Balls" (Priority: 20)

• Rule: Regex "(Timer|Quick|Dusk|Heal|Luxury) Ball"

"Basic Balls" (Priority: 10)

• Rule: Regex "(Poké|Great|Ultra) Ball"

Example 3: Berry Organization
Create these categories:

"Battle Berries" (Priority: 25)

• Rule: Ends With "Berry"
• Rule: Regex "(Sitrus|Lum|Chesto|Pecha)"[/td]

"EV Berries" (Priority: 20)

• Rule: Ends With "Berry"
• Rule: Regex "(Pomeg|Kelpsy|Qualot|Hondew|Grepa|Tamato)"

"All Berries" (Priority: 10)

• Rule: Ends With "Berry"

Tips and Best Practices

1. Start Simple: Begin with basic rules and add complexity as needed
2. Use Priority Wisely: More specific categories should have higher priority
3. Test Rules: Use the "Preview" button to see which items match before saving
4. Combine Manual and Rules: Use manual categories for special items, rules for patterns
5. Regular Expressions: Learn basic regex for powerful pattern matching

Managing Categories

Editing Categories

1. Select a category from the dropdown
2. Click "Edit Category"
3. Modify the name, rules, or priority
4. Click the green checkmark to save

Deleting Categories

1. Select a category from the dropdown
2. Click "Delete Category"
3. Confirm the deletion

Re-Assigning Items

• Items in deleted categories become uncategorized
• Items can be moved between manual categories
• Rule-based category items are automatically managed

Mobile vs Desktop Controls

Action	Desktop	Mobile
Assign to category	Right-click item	Long-press item
Navigate categories	Click tabs	Tap tabs
Edit categories	Click buttons	Tap buttons

Troubleshooting

Q: My item isn't being categorized by rules

• Check if the item is in a manual category (manual overrides rules)
• Verify your rule syntax and case sensitivity
• Use Preview to test your rules

Q: Items are in the wrong category

• Check category priorities
• More specific rules should have higher priority
• Remember that ALL rules in a category must match

Q: Can I export/import categories?

• Categories are saved locally per device
• Currently no export/import feature (may be added in future)

Advanced Examples

Complex Regex Patterns

Match specific TM numbers:

• regex ^TM(0[1-9]|1[0-9]|2[0-5])$

=>Matches TM01 through TM25

Match items with specific suffixes:

• regex .*(Ball|Disc|Stone|Berry)$

=> Matches any item ending with Ball, Disc, Stone, or Berry

Match items with version names:

• regex (Red|Blue|Yellow|Gold|Silver|Crystal)

=> Matches items containing any game version name


Category Hierarchy Example

Create a hierarchy using priorities:

1. "Legendary Items" (Priority: 100)

- Rule: Exact Match "Master Ball" OR Exact Match "Sacred Ash"

1. "Rare Items" (Priority: 50)

- Rule: Contains "Rare" OR Contains "PP Max"

1. "Valuable Items" (Priority: 25)

- Rule: Contains "Nugget" OR Contains "Pearl"

1. "Common Items" (Priority: 10)

- Rule: Contains "Potion" OR Contains "Ball"

This creates a clear hierarchy where the most important items are categorized first.