Skip to main content

Overview

All customizable constants are defined in RaidConsumableChecker_Constants.lua. These values control UI appearance, timers, colors, fonts, and default behavior.
Modifying constants requires editing the Lua file directly. Always back up the original file before making changes.

Addon Info

ADDON_NAME
string
default:"RaidConsumableChecker"
Internal addon name used for event registration.
ADDON_VERSION
string
default:"2.1.0"
Current version number displayed on load.

Saved Variables

RaidConsumableCheckerDB
table
Global saved variables table persisted across game sessions.Structure:
RaidConsumableCheckerDB = {
  position = {
    point = "CENTER",
    x = 0,
    y = 0
  },
  ConsumableData = {
    Items = { ... },
    Categories = { ... }
  }
}
Location: WTF/Account/[AccountName]/SavedVariables/RaidConsumableChecker.luaFields:
  • position - Window position (point, x offset, y offset)
  • ConsumableData.Items - Array of configured consumable items
  • ConsumableData.Categories - Array of configured categories
The saved variables are automatically created on first load. Manual editing is not recommended - use the in-game configuration UI instead.

UI Dimensions

Window Size

WINDOW_WIDTH
number
default:"850"
Default window width in pixels (auto-calculated based on items).
WINDOW_HEIGHT
number
default:"300"
Default window height in pixels (auto-calculated based on categories).
WINDOW_MIN_WIDTH
number
default:"400"
Minimum window width to prevent UI from becoming too small.
WINDOW_PADDING
number
default:"15"
Outer padding around window content in pixels.

Title Bar

TITLE_HEIGHT
number
default:"30"
Height of the title bar in pixels.

Content Margins

CONTENT_MARGIN_LEFT
number
default:"15"
Left margin for content area in pixels.
CONTENT_MARGIN_RIGHT
number
default:"-5"
Right margin for content area in pixels.
CONTENT_MARGIN_BOTTOM
number
default:"15"
Bottom margin for content area in pixels.

Icon and Item Display

ICON_SIZE
number
default:"45"
Size of item icons in pixels (width and height).
ICON_SPACING_X
number
default:"25"
Horizontal spacing between item icons in pixels.

Category Display

CATEGORY_HEADER_HEIGHT
number
default:"25"
Height of category header text in pixels.
CATEGORY_SPACING
number
default:"30"
Vertical space between categories in pixels.

Frame Borders

BORDER_THICKNESS
number
default:"4"
Thickness of item icon borders in pixels.

Colors

All colors use 8-character hex format: AARRGGBB where AA = alpha, RR = red, GG = green, BB = blue.

Frame Background

BACKGROUND_COLOR
hex
default:"CC000000"
Main window background color (Black with 80% alpha).

Title Bar

TITLE_BG_COLOR
hex
default:"E61A1A1A"
Title bar background color (Dark gray with 90% alpha).
TITLE_TEXT_COLOR
hex
default:"FFFFD100"
Title bar text color (Gold, fully opaque).

Item Status Borders

BORDER_COLOR_BUFF_ACTIVE
hex
default:"FF00FF00"
Border when buff is active with >5 min remaining (Green).
BORDER_COLOR_BUFF_WARNING
hex
default:"FFFF8800"
Border when buff is active with <5 min remaining (Orange).
BORDER_COLOR_BUFF_INACTIVE
hex
default:"FFFF0000"
Border when buff is not active (Red).
BORDER_COLOR_NO_BUFF
hex
default:"FF000000"
Border for items without buff tracking, like potions (Black).

Text Colors

TEXT_COLOR_NORMAL
hex
default:"FFFFFFFF"
Normal text color (White).
TEXT_COLOR_SUFFICIENT
hex
default:"FF00FF00"
Text color when you have enough items (Green).
TEXT_COLOR_INSUFFICIENT
hex
default:"FFFF0000"
Text color when you need more items (Red).
TEXT_COLOR_CATEGORY
hex
default:"FFFFD100"
Category header text color (Gold).
TEXT_COLOR_ADDON_NAME
hex
default:"FF3FC7EB"
Addon name color in chat messages (Light blue).
TEXT_COLOR_GOLD
hex
default:"FFFFDB00"
Highlight color for commands in chat (Gold).
TEXT_COLOR_HIGHLIGHT
hex
default:"FFFFFFFF"
Highlight color for item/category names in chat (White).
TEXT_COLOR_DESCRIPTION
hex
default:"FFCCCCCC"
Item description text color in tooltips (Gray).

Fonts

Font Files

FONT_TITLE
string
default:"Fonts\\\\FRIZQT__.TTF"
Font file for title text.
FONT_NORMAL
string
default:"Fonts\\\\FRIZQT__.TTF"
Font file for normal text.

Font Sizes

FONT_SIZE_TITLE
number
default:"14"
Font size for window title.
FONT_SIZE_CATEGORY
number
default:"13"
Font size for category headers.
FONT_SIZE_ITEM_NAME
number
default:"11"
Font size for item names under icons.
FONT_SIZE_COUNTER
number
default:"14"
Font size for item count numbers.
FONT_SIZE_BUFF_TIME
number
default:"14"
Font size for buff time remaining display.

Timers and Performance

BUFF_SCAN_INTERVAL
number
default:"2.0"
Seconds between buff scans (only when window is open).
BUFF_UPDATE_DELAY_AFTER_USE
number
default:"0.2"
Seconds to wait after using item before updating buffs.
BUFF_WARNING_THRESHOLD
number
default:"300"
Buff warning threshold in seconds - shows orange border (5 minutes).

Text Strings

Window Title

TEXT_WINDOW_TITLE
string
default:"Raid Consumable Checker"
Main window title text.

Counter Format

TEXT_COUNTER_FORMAT
string
default:"%d/%d"
Format for item counter display: current/required (e.g., “5/10”).

Slash Commands

SLASH_COMMANDS.PRIMARY
string
default:"/rcc"
Primary slash command.
SLASH_COMMANDS.SECONDARY
string
default:"/raidcheck"
Alternative slash command.
SLASH_COMMANDS.TERTIARY
string
default:"/consumables"
Third alternative slash command.

Tooltips

TEXT_TOOLTIP_WEAPON_ENCHANT
string
default:"Weapon enchant"
Tooltip text for weapon enchant status.
TEXT_TOOLTIP_CLICK_TO_USE
string
default:"Click to use"
Tooltip hint for clickable items.

Confirmation Dialog

TEXT_CONFIRM_MESSAGE
string
Confirmation message when buff already active.
TEXT_CONFIRM_ACCEPT
string
default:"Yes"
Accept button text for confirmation dialog.
TEXT_CONFIRM_CANCEL
string
default:"No"
Cancel button text for confirmation dialog.

Textures and Paths

TEXTURE_ICON_BASE_PATH
string
default:"Interface\\\\Icons\\\\"
Base path for all item icons.
TEXTURE_DEFAULT_ICON
string
default:"Interface\\\\Icons\\\\INV_Misc_QuestionMark"
Fallback icon when item icon path is invalid or missing.
TEXTURE_BORDER
string
default:"Interface\\\\Buttons\\\\WHITE8X8"
Texture used for borders and backgrounds.

Behavior

SHOW_ITEM_NAMES
boolean
default:"true"
Show item names below icons.

Special Buff Names

SPECIAL_BUFF_EQUIPPED_WEAPON
string
default:"EQUIPPED_WEAPON"
Special identifier for weapon enchants like Wizard Oil.

Default Saved Variables

Window Position

DEFAULT_POSITION.point
string
default:"CENTER"
Anchor point for window position.
DEFAULT_POSITION.x
number
default:"0"
X offset from anchor point.
DEFAULT_POSITION.y
number
default:"0"
Y offset from anchor point.

Default Categories

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}
}
id
string
Unique category identifier
name
string
Display name for the category
dashes
number
Number of dashes to display on each side of the category name

Default Items

The DEFAULT_ITEMS array contains the initial item configuration for new installations. See the full list in RaidConsumableChecker_Constants.lua:138-213.

Example Default Item Structure

{
    itemName = "Flask of Supreme Power",
    itemID = 13512,
    iconPath = "INV_Potion_41",
    requiredCount = 1,
    buffName = "Supreme Power",
    description = "Increases damage done by magical spells and effects by up to 150 for 2 hrs.",
    category = "category1",
    entryType = "consumable"
}

Customization Examples

Change Buff Scan Rate

To scan buffs every 1 second instead of 2:
RCC_Constants.BUFF_SCAN_INTERVAL = 1.0

Adjust Warning Threshold

To show orange warning at 10 minutes (600 seconds):
RCC_Constants.BUFF_WARNING_THRESHOLD = 600

Modify Border Colors

To use blue for active buffs:
RCC_Constants.BORDER_COLOR_BUFF_ACTIVE = "FF0000FF"  -- Blue

Change Icon Size

To make icons larger (60x60):
RCC_Constants.ICON_SIZE = 60
After modifying constants, reload the UI with /reload or restart the game for changes to take effect.

Color Format Reference

Hex Color Format: AARRGGBB

ComponentPositionRangeDescription
Alpha1-200-FFTransparency (00=invisible, FF=opaque)
Red3-400-FFRed component
Green5-600-FFGreen component
Blue7-800-FFBlue component

Common Colors

"FFFFFFFF"  -- White (opaque)
"FF000000"  -- Black (opaque)
"FFFF0000"  -- Red (opaque)
"FF00FF00"  -- Green (opaque)
"FF0000FF"  -- Blue (opaque)
"FFFFFF00"  -- Yellow (opaque)
"FFFF8800"  -- Orange (opaque)
"80FFFFFF"  -- White (50% transparent)
"00FFFFFF"  -- White (fully transparent)

Performance Tuning

These constants allow you to balance visual responsiveness with CPU usage.
High Performance:
RCC_Constants.BUFF_SCAN_INTERVAL = 1.0  -- More responsive
Low Performance:
RCC_Constants.BUFF_SCAN_INTERVAL = 5.0  -- Lower CPU usage
Instant Item Use Feedback:
RCC_Constants.BUFF_UPDATE_DELAY_AFTER_USE = 0.1  -- Faster update
Setting BUFF_SCAN_INTERVAL below 1.0 second may cause performance issues on older systems.

Build docs developers (and LLMs) love