Vati
188 lines
6.1 KiB
Markdown
188 lines
6.1 KiB
Markdown
# Guda
|
||
|
||
A comprehensive **bag and bank management addon** for **World of Warcraft 1.12.1**, fully compatible with **Turtle WoW**.
|
||
|
||
Guda provides a modern, unified bag/bank experience with multi-character support, sorting, item tracking, and quality-of-life tools.
|
||
|
||
---
|
||
|
||
## 📦 Features
|
||
|
||
### 🎒 Bag Management
|
||
|
||
- **Unified Bag View** – All bags displayed in one window
|
||
- **Category View** – Group items by category for easier organization
|
||
- **Smart Sorting** – Sort by quality, name, or item type
|
||
- **Search Box** – Quickly find items
|
||
- **Quality Borders** – Items are visually color-coded based on rarity
|
||
|
||
### 🏦 Bank Management
|
||
|
||
- **Remote Bank Viewing** – View cached bank contents from anywhere
|
||
- **One-Click Sorting** – Organize your bank easily
|
||
- **Category View** – Group bank items by category
|
||
- **Persistent Storage** – Bank data saved between sessions
|
||
|
||
### 📊 Tracked Item Bar
|
||
|
||
- **Item Tracking** – Alt + Left-Click on any bag item to track it
|
||
- **Stack Display** – Shows tracked items as a single stack with total count
|
||
- **Farm Counter** – Displays how many items you currently have in your bags
|
||
- **Grinding Helper** – Perfect for tracking materials while farming
|
||
- **Draggable** – Shift + Left-Click to drag the bar anywhere on screen
|
||
|
||
### 📜 Quest Item Bar
|
||
|
||
- **Quest Item Display** – Shows usable quest items in up to 2 dedicated bars
|
||
- **Quick Swap** – Hover over a quest item bar slot to see available quest items
|
||
- **One-Click Replace** – Click on a popup item to swap it into the bar slot
|
||
- **Keybindable** – Set custom keybindings for quick quest item use
|
||
- **Draggable** – Shift + Left-Click to drag the bar anywhere on screen
|
||
|
||
### 👥 Multi-Character Support
|
||
|
||
- **Cross-Character Viewing** – View bags & banks of any character
|
||
- **Money Tracking** – See total gold across all characters
|
||
- **Character Selector** – Switch characters quickly
|
||
- **Faction Filtering** – Shows only characters from the same faction
|
||
- **Global Item Counting** – Item totals across all characters, including:
|
||
- Bags
|
||
- Banks
|
||
- Equipped items
|
||
- Tooltip breakdown per character
|
||
|
||
### 💰 Money Display
|
||
|
||
- **Current Character Money**
|
||
- **Total Money Across All Characters**
|
||
- **Per-Character Overview** in the selector
|
||
|
||
---
|
||
|
||
## 📝 Slash Commands
|
||
|
||
| Command | Description |
|
||
|---------|-------------|
|
||
| `/guda` or `/gn` | Toggle bags |
|
||
| `/guda bank` | Toggle bank view |
|
||
| `/guda sort` | Sort your bags |
|
||
| `/guda sortbank` | Sort your bank (must be at bank) |
|
||
| `/guda debug` | Toggle debug mode |
|
||
| `/guda cleanup` | Remove characters not seen in 90 days |
|
||
| `/guda help` | Show help |
|
||
|
||
---
|
||
|
||
## 🚀 How to Use
|
||
|
||
### Basic Usage
|
||
|
||
1. Press **B** or type `/guda` to open your bags
|
||
2. Click **Characters** to switch characters
|
||
3. Click **Bank** to view your cached bank
|
||
4. Click **Sort** to organize your bags
|
||
|
||
### Sorting
|
||
|
||
- **Sort Bags**: Press **Sort** or use `/guda sort`
|
||
- **Sort Bank**: Use **Sort Bank** or `/guda sortbank`
|
||
- Sorting modes:
|
||
- **Quality** (Epic → Rare → Uncommon → Common)
|
||
- **Name** (A → Z)
|
||
- **Type** (Item class & subclass)
|
||
|
||
### Category View
|
||
|
||
- Toggle category view in bags or bank to group items by type
|
||
- Easily find items organized by their category
|
||
|
||
### Tracked Item Bar
|
||
|
||
1. Open your bags
|
||
2. Hold **Alt** and **Left-Click** on any item to start tracking it
|
||
3. The item appears in the Tracked Item Bar with total count
|
||
4. Use **Shift + Left-Click** on the bar to drag it to your preferred location
|
||
|
||
|
||
|
||
### Quest Item Bar
|
||
|
||
1. Quest items automatically appear in the Quest Item Bar
|
||
2. Set keybindings via **Esc → Key Bindings → Guda** for quick use
|
||
3. Hover over a bar slot to see other available quest items
|
||
4. Click a popup item to swap it into that slot
|
||
5. Use **Shift + Left-Click** on the bar to drag it to your preferred location
|
||
|
||
|
||
---
|
||
|
||
## 🧠 Internal Systems
|
||
|
||
### 🔍 Bag Scanner
|
||
|
||
- Scans all bags at login
|
||
- Updates when looting, moving, or modifying items
|
||
- Stores item details (count, quality, name, link, etc.)
|
||
|
||
### 🏦 Bank Scanner
|
||
|
||
- Scans on bank open
|
||
- Saves snapshot for offline viewing
|
||
- Updates live while the bank is open
|
||
|
||
### 💰 Money Tracker
|
||
|
||
- Tracks money changes in real time
|
||
- Displays per-character, current character, and total money
|
||
|
||
### 🗄️ Data Storage
|
||
|
||
| Variable | Description |
|
||
|----------|-------------|
|
||
| `Guda_DB` | Global data: bag & bank contents, character money, timestamps, tracked items |
|
||
| `Guda_CharDB` | Per-character UI settings: bar positions, tracked item selections |
|
||
|
||
---
|
||
|
||
|
||
## ⚠️ Known Limitations
|
||
|
||
| Area | Limitation |
|
||
|------|------------|
|
||
| Sorting | Advanced sorting requires handling bag restrictions (soul bags, profession bags). Locked and soulbound items need special handling. |
|
||
| Bank Access | Must open the bank at least once to cache contents |
|
||
| Faction Restriction | Only shows characters from the same faction |
|
||
|
||
---
|
||
|
||
## 🖼️ Screenshots
|
||
|
||
| Guda Settings | Bag Single View | Bag Category View | Bank View |
|
||
|---------------|------------------------------------------|------------------------------------|----------------------------------------------|
|
||
|  |  |  |  |
|
||
|
||
---
|
||
|
||
## 🐞 Common Issues
|
||
|
||
### Cannot open bags using B
|
||
|
||
Set the keybinding: **Esc → Key Bindings → Guda → Toggle Bags**
|
||
|
||
|
||
|
||
### Issues after updating the addon
|
||
|
||
Delete outdated saved variables:
|
||
|
||
```
|
||
WTF/Account/<ACCOUNT_NAME>/SavedVariables/Guda.lua
|
||
WTF/Account/<ACCOUNT_NAME>/SavedVariables/Guda.lua.bak
|
||
```
|
||
|
||
---
|
||
|
||
## 📢 Support
|
||
|
||
For bugs or feature requests, please open an issue. Your feedback helps improve the addon!
|