# GuildVault – Simulated Guild Bank for WoW Classic Era

A pure-Lua addon that turns your Level 5 or lower guild characters into a shared, viewable “guild bank”.
No external sync programs required. Everything travels over the built-in guild addon message channel.

## Features

- **Level 5 or lower characters** automatically scan their bags and personal bank and broadcast the inventory.
- **Higher-level characters** are view-only. They help the guild by requesting data and rebroadcasting cached bank information so offline bank alts stay “synced”.
- Large scrollable virtual bag opened by **left-clicking the minimap button**.
- Sort by **Rarity** (highest quality first) or **Name** (alphabetical).
- Live **search** filter.
- Each item shows its **total stock** (sum across every bank character).
- **Click an item** to open a popup listing every bank character that holds it and the exact quantity.
- Data older than **30 days** is expired silently and automatically.
- Slash commands: `/gv`, `/guildvault`, `/gvault`
- `/gv` – toggle the vault window
- `/gv scan` – force a new scan and broadcast (Level 5 or lower only)
- `/gv sync` – force a data request from the guild
- `/gv status` – diagnostic info
- `/gv clear` – clear local cache

## Installation

1. Copy the `GuildVault` folder into
`World of Warcraft\_classic_era_\Interface\AddOns\`
2. Restart the client or `/reload`.
3. The minimap button appears automatically.

## How to Use (Bank Characters)

1. Create or log a **Level 5 or lower** character that is in the guild.
2. Put the items you want tracked into its bags.
3. Open the bank at least once (bank contents are then remembered).
4. The addon automatically tracks inventory.
5. Log out or switch characters. The data lives in the guild’s collective memory for up to 30 days and is syncronised by any online higher-level members using the addon.

## How to Use

1. Login to any character in the same guild.
2. Left-click the minimap bag icon (or type `/gv`).
3. Browse the aggregated vault, sort, search, and click items to see who holds what.

## Technical Notes

- Communication uses `C_ChatInfo.SendAddonMessage` with the prefix `GuildVault` on the `GUILD` channel.
- Messages are automatically chunked and throttled.
- Higher-level characters answer `REQ` messages by rebroadcasting the bank data they have, so even offline bank characters stay visible.
- SavedVariables are account-wide (`GuildVaultDB`).
- Designed for Classic Era. Pure Lua – no libraries required.

## Limitations (by design)

- This is a **simulation / information system**. It does not move items between characters. Actual deposits and withdrawals are done by logging the Level 5 or lower character and using mail, trade, or the bank.

## Credits

**Fluffy on Deviate Delight (US), Classic Era**

Guild Vault