# GuildVault

**A shared guild bank catalog and request system for WoW Classic — Season of Discovery & Classic Era.**

Ever wanted to know what's *actually* in your guild bank without waiting for an officer to log in and check? GuildVault lets designated bankers automatically catalog their bank contents and share them with the whole guild. Members can browse the combined inventory, search for items, and request what they need — all in-game, no spreadsheets or Discord messages required.

---

✨ Features

📦 Shared Bank Catalog
- Bankers automatically scan their bank and bags and broadcast the contents to the guild.
- Every member sees a **combined, searchable inventory** across all bankers.
- Item counts, quality coloring, and live tooltips — shift-click to link items in chat.

📝 Request System
- Request items directly from the catalog with a simple quantity slider.
- Bankers get a **Pending Requests** panel to **Approve** or **Reject** (with an optional reason).
- Track your own requests in **My Requests** — cancel, mark collected, or clear old ones.
- Requested quantities are reserved so the catalog always shows what's *truly* available.

🔄 Smart Syncing
- Automatic background sync keeps every member in agreement on inventory and request status.
- Network-friendly: updates are spaced out and chunked to avoid spam.
- Works quietly in the background with a configurable auto-refresh.

🛡️ Guild-Aware
- Data is scoped to your current guild — switch or leave a guild and old items clear automatically.
- No stale inventory from a guild you're no longer in.

🖥️ Clean Classic UI
- Minimap button for quick access.
- Persistent window positions and sizes.
- Search bar for instant filtering.

---

🚀 Getting Started

1. **Install** GuildVault (and keep the included libraries).
2. Open the window with the **minimap button** or by typing `/gb`.
3. **Bankers:** stand at your guild/personal bank and type `/gb banker` to enable banker mode. Your bank will scan automatically when opened.
4. **Members:** just browse and request — no setup needed!

---

⌨️ Slash Commands

| Command | Description |
|--------|-------------|
| `/gb` | Open or close the main window |
| `/gb banker` | Toggle banker mode (bankers only) |
| `/gb scan` | Manually scan your bank |
| `/gb sync` | Request a fresh sync from bankers |
| `/gb reqs` | Open the pending requests panel |
| `/gb rqd` | Open your personal requests |
| `/gb auto` | Toggle automatic refresh |
| `/gb help` | Show all commands |

---

✅ Compatibility

- **Season of Discovery**
- **Classic Era**

---

💬 Feedback & Bug Reports

Found a bug or have a feature idea? Please leave a comment or open an issue. GuildVault is actively maintained — your feedback shapes what comes next!

---

*Requires all guild members who want to share inventory to be online with the addon installed. Bankers must enable banker mode with `/gb banker` for their bank to be cataloged.*