Skip to main content

Item Types

RCC supports two types of entries:
Physical items you carry in your bags (flasks, potions, food, oils).Features:
  • Inventory count tracking
  • Click-to-use functionality
  • Buff status monitoring (optional)
  • Required count alerts
Use for: Flask of Supreme Power, Major Healing Potion, Wizard Oil, etc.
Toggle between types using the checkboxes at the top of the item configuration form.

Configuration Fields

Essential Fields

itemName
string
required
Exact name of the item as it appears in your bags.
  • Case-sensitive: Major Healing Potionmajor healing potion
  • Required for inventory tracking and click-to-use
  • Disabled when Type is set to “Buff”
Example: Flask of Supreme Power
buffName
string | string[]
required
Name(s) of the buff to track in your buff bar.
  • Case-sensitive: Supreme Powersupreme power
  • Supports multiple buffs: Arcane Intellect, Arcane Brilliance
  • Special keyword: EQUIPPED_WEAPON for weapon enchants
  • Border color changes based on buff status
Example: Supreme PowerMultiple Buffs: Arcane Intellect, Arcane Brilliance
iconPath
string
required
Icon name for the visual display.
  • Just the icon name: INV_Potion_41 (not full path)
  • Preview updates in real-time as you type
  • Fallback to question mark if invalid
Example: INV_Potion_41
Find icon names on Wowhead Classic

Optional Fields

displayName
string
Custom label shown under the icon.
  • Overrides itemName and buffName for display
  • Useful for shortening long names
  • Leave empty to use itemName or buffName
Example: Mage Int (instead of “Arcane Intellect”)
requiredCount
number
default:"1"
Target quantity to carry.
  • Shows green when you have enough
  • Shows red when you need more
  • Set to 0 to hide counter
  • Disabled for Buff type
Example: 10 (for potions)
itemID
number
WoW item ID (reference only).
  • Not used for any logic
  • Helpful for documentation
  • Disabled for Buff type
Example: 13512 (Flask of Supreme Power)
description
string
Extra text shown in tooltips.
  • Appears when hovering over the icon
  • Supports multi-line text
  • Auto-expands as you type
Example: Increases damage done by magical spells and effects by up to 150 for 2 hrs.
category
string
required
Which category group this item belongs to.
  • Automatically set based on selection
  • Can be changed by moving item to different category
  • Must match a valid category ID
Example: category1

Field Behavior by Type

{
  entryType = "consumable",
  itemName = "Flask of Supreme Power",  -- ✅ Enabled
  requiredCount = 1,                     -- ✅ Enabled
  itemID = 13512,                        -- ✅ Enabled
  buffName = "Supreme Power",            -- ✅ Optional
  displayName = "",                      -- ✅ Optional
  iconPath = "INV_Potion_41",           -- ✅ Required
  description = "..."                    -- ✅ Optional
}

Special Features

EQUIPPED_WEAPON Keyword

For tracking weapon enchants like Wizard Oil, Sharpening Stones, and Rogue Poisons:
1

Set buffName to EQUIPPED_WEAPON

Use the special keyword instead of a buff name:
buffName = "EQUIPPED_WEAPON"
2

Configure the item normally

Set itemName, requiredCount, and iconPath as usual:
itemName = "Wizard Oil"
requiredCount = 4
iconPath = "INV_Potion_104"
3

Border reflects enchant status

  • 🟢 Green: Weapon is enchanted with >5 min remaining
  • 🟠 Orange: Weapon enchant <5 min remaining
  • 🔴 Red: No weapon enchant detected
EQUIPPED_WEAPON only tracks your main hand weapon enchant.

Multiple Buff Variants

Some buffs have single-target and group versions (e.g., Arcane Intellect vs Arcane Brilliance):
buffName = "Arcane Intellect"
Behavior:
  • Border turns green if any variant is active
  • First buff name used for display label
  • All variants shown in tooltip

Display Name Priority

The addon chooses which label to show under the icon: Priority:
  1. displayName (if provided)
  2. itemName (if provided)
  3. buffName (first variant if multiple)
  4. “Unknown” (fallback)

Adding Items via UI

1

Click 'New Item'

Opens a blank form with default values.
2

Choose Type

Select “Consumable” or “Buff” at the top.
3

Fill Required Fields

At minimum:
  • Item Name OR Buff Name (at least one)
  • Icon Name (recommended)
4

Preview Icon

Icon preview appears on the right as you type.
5

Click Save

Save button enables when all required fields are valid.
Use Tab to quickly move between fields while filling the form.

Editing Items

1

Select from List

Click an item in the left panel to load it.
2

Modify Fields

Change any field values as needed.
3

Validation

Save button enables only if changes are valid.
4

Save or Discard

  • Save: Apply changes
  • Discard: Revert to original values

Common Mistakes

Case SensitivityAll names are case-sensitive:supreme power → Won’t match buff
Supreme Power → Correct
major healing potion → Won’t find item
Major Healing Potion → Correct
Icon Path FormatUse shorthand, not full paths:Interface\\Icons\\INV_Potion_41 → Too verbose
INV_Potion_41 → Correct
INV Potion 41 → Spaces not allowed
INV_Potion_41 → Correct
Instant Effect ItemsDon’t add buffName to healing/mana potions:❌ Adding a buffName to Major Healing Potion → Border stays red
✅ Leave buffName empty → Border shows black (no buff to track)
Auto-Conversion to BuffIf you save a Consumable with:
  • Empty itemName
  • requiredCount = 0
  • Valid buffName
The addon automatically converts it to Buff type to keep the UI clean.

Reordering Items

Use the Up and Down buttons to change display order:
  • Within Category: Move item up/down in the same category
  • Between Categories: Move past category header to switch categories
  • Real-time Update: Main window reflects changes immediately
Reordering a category (see Categories) moves all its items as a block.

Next Steps

Categories

Learn how to organize items into categories

Examples

See real configuration examples

Build docs developers (and LLMs) love