Dusk/Guda-ClassicAPI
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

readme.md update

Browse Source
This commit is contained in:
Salikh Gurgenidze
2025-12-23 23:33:11 +04:00
parent fd08e77be3
commit 20503a4d2e
1 changed files with 99 additions and 89 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+99 -89
View File
@@ -10,51 +10,66 @@ Guda provides a modern, unified bag/bank experience with multi-character support
### 🎒 Bag Management
* **Unified Bag View** – All bags displayed in one window
* **Smart Sorting** – Sort by quality, name, or item type
* **Search Box** – Quickly find items
* **Quality Borders** – Items are visually color-coded based on rarity
- **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
* **Persistent Storage** – Bank data saved between sessions
- **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
- **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
- **Current Character Money**
- **Total Money Across All Characters**
- **Per-Character Overview** in the selector
---
## 📝 Slash Commands
```
/guda or /gn
/guda - 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 this help
```
| 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 |
---
@@ -69,98 +84,94 @@ Guda provides a modern, unified bag/bank experience with multi-character support
### Sorting
* **Sort Bags**: Press **Sort** or use `/guda sort`
* **Sort Bank**: Use **Sort Bank** or `/guda sortbank`
* Sorting modes:
- **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)
* **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
![Tracked Item Bar](https://i.imgur.com/tISDLwo.png)
### 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
![Quest Item Bar](https://i.imgur.com/orMsS06.png)
---
## 🧠 Internal Systems
### 🔍 Bag Scanner
* Scans all bags at login
* Updates when looting, moving, or modifying items
* Stores item details (count, quality, name, link, etc.)
- 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
- 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
- Tracks money changes in real time
- Displays per-character, current character, and total money
### 🗄️ Data Storage
* **Guda_DB** – Global data:
* Bag & bank contents
* Character money
* Last update timestamps
* **Guda_CharDB** – Per-character UI settings
| 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 |
---
## ⚙️ Configuration
Configuration is currently automatic. Future updates may include:
* Custom sort methods
* Adjustable layout (buttons per row, item size)
* Item filters
* Color customization
---
## ⚠️ Known Limitations
* **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
| 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 |
---
## 🖼️ Images
## 🖼️ Screenshots
### Guda Settings
![Guda Settings](https://i.imgur.com/Tfzl6ru.png)
### Bag View
![Bag View](https://i.imgur.com/cqISq71.png)
### Bank View
![Bank View](https://i.imgur.com/rV1f8Lu.png)
| Guda Settings | Bag Single View | Bag Category View | Bank View |
|---------------|------------------------------------------|------------------------------------|----------------------------------------------|
| ![Settings](https://i.imgur.com/h6XrtxM.png) | ![Bags](https://i.imgur.com/00iOF0I.png) | ![Category](https://i.imgur.com/khywIwv.png) | ![Bank](https://i.imgur.com/rV1f8Lu.png) |
---
## 🐞 Common Issues
### 1. Cannot open bags using **B**
### Cannot open bags using B
Set the keybinding:
**Esc → Key Bindings → Guda → Toggle Bags**
Set the keybinding: **Esc → Key Bindings → Guda → Toggle Bags**
![Keybindings Fix](https://i.imgur.com/IJv36Lg.png)
### 2. Issues after updating the addon
### Issues after updating the addon
Delete outdated saved variables:
@@ -173,5 +184,4 @@ WTF/Account/<ACCOUNT_NAME>/SavedVariables/Guda.lua.bak
## 📢 Support
For bugs or feature requests, please open an issue.
Your feedback helps improve the addon!
For bugs or feature requests, please open an issue. Your feedback helps improve the addon!