OpenIt

OpenIt is a lightweight World of Warcraft (Retail) addon that scans your bags and displays a floating, interactive button whenever you have containers, satchels, lockboxes, geodes, or consumable item packages that can be opened or used.

---

Features

• Automatic Bag Scanning: Detects openable items, caches, lockboxes, geodes, and usable packages in your inventory automatically via a curated database and native engine flags.
• Smart Filtering & Performance: $O(1)$ fast pre-filtering skips trade goods, armor, crafting reagents, and gems before building lookups, keeping bag updates completely lag-free. Automatically excludes equippable gear with "Use" effects, hearthstones, and teleportation toys.
• Minimum Quality Control: Configurable item quality threshold (Junk to Epic) so you can choose exactly what tier of items triggers the button.
• Snooze Functionality: Temporarily hide an item for 3 hours with a single click. Expired snoozes are automatically purged on login to keep your saved data clean.
• Custom Blacklist: Permanently blacklist annoying items straight from the floating button or manage them in the options menu (sorted alphabetically A-Z).
• Extensible Item Databases: Pre-configured item lists organized cleanly in subdirectories for easy updates.

---

Controls

Action	Control	Description
Open / Use	Left-Click	Opens or uses the displayed item directly from your bags (triggers on release to prevent accidental uses while dragging).
Snooze	Right-Click	Hides the current item for 3 hours.
Blacklist	Shift + Right-Click	Adds the item to your blacklist and immediately shows the next available item.
Move	Click + Drag	Drags the button to any position on your screen (when unlocked).

---

Options & Commands

Access the options panel via the standard WoW AddOn Settings menu or by using the slash command:

/openit     - Opens the OpenIt settings panel
/openit reset - Resets the button position to default (halfway left of screen center)

Settings Include:

• Lock Position: Lock the button in place to prevent accidental dragging.
• Button Size: Scale the button smoothly from 24px to 96px.
• Opacity: Adjust button transparency from 10% to 100%.
• Minimum Item Quality: Set the minimum threshold (Junk, Common, Uncommon, Rare, Epic) required for an item to trigger the button.
• Blacklist Manager: Scrollable list displaying blacklisted item names sorted alphabetically (A-Z) with quality colors and Item IDs. Click the red X next to any item to remove it from your blacklist.

---

Data Structure & Customization

OpenIt uses dedicated data files inside the Data/ subdirectory to manage item lists:

• Data/Items.lua: Contains known item IDs that should always trigger the button.
• Data/Blacklist.lua: Contains hardcoded, permanently ignored item IDs (Hearthstones, toys, utility items).

---

Installation

1. Download from CurseForge: https://www.curseforge.com/wow/addons/openit
2. Place the OpenIt folder into your WoW interface directory: World of Warcraft\_retail_\Interface\AddOns\
3. Restart WoW.

---

Author

Created by dualityps (GitHub).