Skip to main content

​
What are Categories?

Categories are organizational groups that separate your consumables into logical sections. Each category appears as a header in the main RCC window, with all its items displayed below.

​
Default Categories

RCC ships with these categories:

Flasks / Oil / Food

Long-duration consumables like flasks, weapon oils, and raid food.

Main Elixirs

Battle and guardian elixirs for stat boosts.

Potions

Healing and mana potions for emergency use.

Buffs

Class buffs like Arcane Intellect and Mark of the Wild.

​
Category Fields

​
id
string
required
Unique internal identifier for the category.
  • Auto-generated when creating new categories
  • Format: cat_[cleanname]_[timestamp]
  • Cannot be edited manually
  • Items reference this ID
Example: category1 or cat_mainelixirs_1234567890
​
name
string
required
Display title shown in the category header.
  • Appears in uppercase in the main UI
  • Used in configuration menu
  • Can contain spaces and special characters
  • Required to save category
Example: Main Elixirs
​
dashes
number
default:"20"
Number of dashes shown in the UI header line.
  • Visual styling only
  • Affects header width
  • Defaults to 20 if not specified
Example: 24 → -- MAIN ELIXIRS ------------------------

​
Category Structure

{
  id = "category1",
  name = "Flasks / Oil / Food",
  dashes = 20
}

​
Default Categories

Here are the categories that ship with RCC:
RaidConsumableChecker_Constants.lua
RCC_Constants.DEFAULT_CATEGORIES = {
  {
    id = "category1",
    name = "Flasks / Oil / Food",
    dashes = 20
  },
  {
    id = "category2",
    name = "Main Elixirs",
    dashes = 24
  },
  {
    id = "category3",
    name = "Potions",
    dashes = 26
  },
  {
    id = "category4",
    name = "Buffs",
    dashes = 27
  }
}

​
Adding Categories

1

Click 'New Category'

Opens a blank category form with default values.
2

Enter Category Name

Provide a descriptive name like “Pre-Raid Buffs” or “Emergency Items”.
3

Adjust Dashes (Optional)

Set the number of dashes for visual styling (default: 20).
4

Click Save

Category is created and appears at the bottom of the list.
5

Add Items to Category

Create new items and they’ll default to this category.
When you select a category in the list, new items will automatically be assigned to that category.

​
Editing Categories

1

Click Category Header

Click a category header (e.g., ”— FLASKS / OIL / FOOD —”) in the left panel.
2

Modify Fields

Change the name or dashes value.
3

Save Changes

Save button enables when changes are detected.

​
Deleting Categories

You can only delete empty categories. Categories with items cannot be deleted.
1

Select Category

Click the category header to select it.
2

Click Delete

Click the “Delete” button.
3

Confirm Deletion

A popup asks for confirmation.
4

Category Removed

Category disappears from the list.
If category has items: 
Cannot delete category 'Flasks / Oil / Food'. 
It is being used by items.
To delete a category with items:
  1. Move or delete all items in that category first
  2. Then delete the empty category

​
Reordering Categories

Use the Up and Down buttons to change category order:
1

Select Category

Click a category header to select it.
2

Move Up or Down

Use the Up/Down buttons on the right.
3

Items Move Together

All items in the category move as a block.
4

UI Updates

Main window reflects the new order immediately.
Important: Moving a category moves all its items as a single block. This ensures items stay grouped with their category.

​
Category Assignment

Items are assigned to categories via the category field:
Item with Category
{
  itemName = "Flask of Supreme Power",
  category = "category1",  -- References category by ID
  -- ... other fields
}

​
How Assignment Works

When you click “New Item”:
  1. If an item is selected → New item goes to same category
  2. If a category is selected → New item goes to that category
  3. Otherwise → New item goes to the last category in the list

​
Visual Display

Categories appear in the main window as styled headers: 
-- FLASKS / OIL / FOOD --------------------
[Flask Icon] [Oil Icon] [Food Icon]

-- MAIN ELIXIRS --------------------------
[Elixir Icon] [Elixir Icon]

-- POTIONS ------------------------------
[Potion Icon] [Potion Icon] [Potion Icon]

​
Header Styling

Headers use special styling:
  • Color: Gold (configurable in Constants)
  • Format: -- [NAME] [dashes]
  • Height: 25px (configurable)
  • Spacing: 30px between categories (configurable)

​
Category Best Practices

Group items by when you use them:
  • Pre-Raid Buffs: Long-duration buffs applied before entering
  • Combat Consumables: Items used during boss fights
  • Emergency Items: Healing/mana potions for emergencies
  • Enchants: Weapon oils, sharpening stones
Too many categories can clutter the UI:✅ 3-5 categories: Easy to scan
❌ 10+ categories: Hard to navigate
Choose clear, concise names:✅ “Main Elixirs”, “Healing Potions”
❌ “Stuff”, “Items”, “Other”
Use the dashes field to make headers look uniform:
{ name = "Flasks", dashes = 30 }     -- Shorter name
{ name = "Potions", dashes = 29 }    -- Medium name
{ name = "Elixirs", dashes = 29 }    -- Medium name

​
Category Examples

-- Organize by class role
{
  { id = "cat_dps", name = "DPS Consumables", dashes = 22 },
  { id = "cat_healer", name = "Healer Consumables", dashes = 20 },
  { id = "cat_tank", name = "Tank Consumables", dashes = 22 },
  { id = "cat_utility", name = "Utility", dashes = 28 }
}

​
Troubleshooting

Error: “Cannot delete category. It is being used by items.”Solution:
  1. Select each item in that category
  2. Move them to a different category using Up/Down buttons
  3. Once category is empty, delete it
Cause: Game crashed or Alt+F4 before savingSolution:
  • Always exit WoW properly to save settings
  • Use /reload to force save if needed
  • Check SavedVariables/RaidConsumableChecker.lua
Cause: Item’s category field doesn’t match any category IDSolution:
  1. Select the item
  2. Check which category header it appears under
  3. If orphaned, edit item and assign to valid category
Cause: Dashes are visual only, affected by font/window sizeSolution:
  • Experiment with different dash counts
  • Typical range: 20-30 dashes
  • Longer names need fewer dashes

​
Next Steps

Item Configuration

Learn how to configure items within categories

Configuration Examples

See real category and item examples

Build docs developers (and LLMs) love

Get started for freeTalk to us