SnapSnack

The ultimate consumable management addon for WoW TBC Classic

SnapSnack gives you quick, organized access to all your consumables through customizable icon grids. Click to use potions, food, elixirs, and more - all from a clean, configurable interface.

✨ Features

📦 Multiple Customizable Grids

Create up to 10 independent grids to organize your consumables
Position each grid anywhere on your screen
Lock grids in place to prevent accidental movement
Give each grid a custom name for easy identification

🖱️ One-Click Item Usage

Click any consumable icon to instantly use it
Works with potions, food, elixirs, flasks, bandages, scrolls, and more
Visual feedback when clicking buttons

⌨️ Keybind Support

Bind keyboard shortcuts to any consumable slot
Quick access to your most important consumables in combat
Easy keybind mode - just press /ss bind, click a slot, press your key

🧠 Smart Buff Detection

Outside cities: Items with active buffs automatically hide from the grid
Inside cities: Buffed items appear desaturated (grayed out)
Never waste consumables by accidentally re-buffing!
City detection includes sanctuaries (Shattrath) and rest areas

🎨 Full Visual Customization

Icon Size: 16-64 pixels
Columns: 1-12 icons per row
Padding: Adjustable spacing between icons
Background: Toggle grid background on/off
Tooltips: Show/hide item tooltips on hover

📊 Inventory Tracking

See item counts directly on each icon
Bank tracking: Tooltip shows how many are in your bank
Alt tracking: See counts from your other characters
Cooldown sweeps displayed on icons

⚔️ Combat Awareness

Optional "hide in combat" setting per grid
Keep your screen clean during fights
Grids reappear automatically when combat ends

📖 How To Use

Getting Started

Install the addon and /reload
Type /ss to open the configuration panel
Click "Add Grid" to create your first consumable grid
Search for items in the dropdown and add them to your grid

Slash Commands

Command	Description
`/ss`	Open configuration panel
`/ss bind`	Toggle keybind mode
`/ss scan`	Rescan bags for new consumables
`/ss lock`	Lock all grids
`/ss unlock`	Unlock all grids
`/ss reset`	Reset all settings to default

Alternative commands: /snack, /snapsnack, /ct

Moving Grids

Look for the small lock icon on the corner of each grid
Drag the lock icon to move the grid
Right-click the lock to toggle lock/unlock
When locked, the icon turns dark and the grid can't be moved

Setting Up Keybinds

Type /ss bind to enter keybind mode (grids turn blue)
Click the consumable slot you want to bind
Press the key you want to assign
Press ESC to clear a binding, or click another slot
Type /ss bind again or press ESC to exit keybind mode

Adding Consumables

Open config with /ss
Select a grid from the left navigation panel
Click in an empty item dropdown slot
Start typing the item name to search
Click the item from the dropdown list
The item appears in your grid immediately

💡 Tips & Tricks

Quick buff check: Glance at your grid - if an elixir/flask is hidden, the buff is active!
Organize by purpose: Create separate grids for "Raid Buffs", "PvP Consumables", "Food & Water", etc.
Healer setup: Put mana pots and bandages in a small grid near your raid frames
Tank setup: Health pots, armor consumables, and healthstones in easy reach
Alt tracking: The addon remembers consumable counts across all your characters

🔧 Configuration Options

Per-Grid Settings

Enable/Disable - Toggle the entire grid
Grid Name - Custom label (shows in tooltip when hovering the grid)
Columns - Icons per row (1-12)
Icon Size - Pixel size of icons (16-64)
Padding - Space between icons (0-10)
Show Background - Toggle the dark background frame
Show Tooltips - Toggle item tooltips on hover
Hide in Combat - Automatically hide during combat
Lock Position - Prevent accidental movement
Drag Handle Corner - Which corner has the move/lock handle

Item Management

Add items via searchable dropdown
Remove items with the X button
Reorder by removing and re-adding (drag reorder coming soon!)

📋 Supported Item Types

SnapSnack automatically detects and supports:

✅ Potions (Health, Mana, Combat potions)
✅ Elixirs (Battle and Guardian)
✅ Flasks
✅ Food & Drink
✅ Bandages
✅ Scrolls
✅ Weapon Buffs (Oils, Sharpening Stones, Weightstones)
✅ Engineering consumables
✅ Healthstones
✅ Drums
✅ Other consumable items

❓ FAQ

Q: Why do some items disappear from my grid? A: Items with active buffs hide automatically when you're outside a city. This is intended behavior to reduce clutter. Go to a city/inn to see them (grayed out).

Q: Can I use items during combat? A: Yes! The buttons work during combat. However, the "Hide in Combat" option will hide the entire grid if enabled.

Q: How do I see items from my bank/alts? A: Hover over any item - the tooltip shows bank count and counts from other characters who have used SnapSnack.

Q: My keybinds aren't working? A: Make sure you exited keybind mode (press ESC or type /ss bind again). Also check for conflicts with other addon keybinds.

Q: How do I reset everything? A: Type /ss reset - this will reload your UI with default settings.

🐛 Known Issues

Items must be in your bags at least once to appear in the search dropdown
First login may require /ss scan to populate all items

📝 Changelog

v1.0

Initial release
Multiple grid support (up to 10)
Keybind support
Buff detection with city awareness
Bank and alt character tracking
Full visual customization
Combat hide option

💬 Feedback & Support

Found a bug? Have a feature request? Leave a comment on the CurseForge page!

SnapSnack - Because every adventurer deserves a quick snack! 🍪⚡