AmberBank Help
==============
Version 1.0.56 - Created by PlayingHooky @ Stormrage 2026-08-20

https://www.curseforge.com/wow/addons/amber-bank

AmberBank is a cached bank and inventory browser for World of Warcraft.

It stores previously scanned Personal Bank, Warband Bank, Guild Bank, and character Bag information so that cached inventory can still be viewed and searched when the original character or bank is not currently open.


SLASH COMMANDS
==============

/ab
Open or close AmberBank.

/ab personal
Open AmberBank directly to the Personal Bank view.

/ab warband
Open AmberBank directly to the Warband Bank view.

/ab guild
Open AmberBank directly to the Guild Bank view.

/ab s <item>
Search for an exact item across eligible characters.

/ab ss <text>
Search for items containing the supplied text.

/ab cfg
Open the AmberBank Configuration Panel.

/ab scan
Refresh currently accessible storage data.


EXACT COMMAND LINE SEARCH
=========================

Use:

/ab s item name

Examples:

/ab s Potent Healing Potion

/ab s "Potent Healing Potion"

You can also shift-click an item directly into the command line after:

/ab s

When an item hyperlink is supplied, AmberBank can use the actual item identity rather than relying only on the visible item name.

Example:

AmberBank - Search Results
Qty  Character
98   CharacterA  (0 Bank, 98 Bags) - [Potent Healing Potion]
14   CharacterB  (10 Bank, 4 Bags) - [Potent Healing Potion]


SUBSTRING COMMAND LINE SEARCH
=============================

Use:

/ab ss search text

Example:

/ab ss heal

Substring search returns matching cached items individually.

Example:

AmberBank - Search Results
Qty  Character
98   CharacterA  (0 Bank, 98 Bags) - [Potent Healing Potion]
3    CharacterA  (0 Bank, 3 Bags) - [Lesser Healing Potion]
2    CharacterA  (0 Bank, 2 Bags) - [Healing Potion]
200  CharacterB  (0 Bank, 200 Bags) - [Potent Healing Potion]

Substring search is useful when you remember only part of an item's name.


COMMAND LINE SEARCH RESULT LIMIT
================================

Command-line search output is limited to 50 displayed result rows to prevent excessive chat output.

When more than 50 matches are found, AmberBank displays:

AmberBank - Search Results
Too many results. Search string may be too short. [Capped at 50]

If nothing matches, AmberBank displays:

AmberBank - Nothing found


COMMAND LINE SEARCH RESULT LIMIT ALTERNATIVE
============================================

Use the main AmberBank Search System for broader searches.

It displays numeric indicators for each storage system and container, highlights matching items across visible pages, and handles substring searches more naturally.

The search string also persists while switching between characters, making repeated or similar searches easier to perform.


ACCOUNT-WIDE CHARACTER INVENTORY
================================

AmberBank maintains separate cached Bag and Personal Bank data for each character.

Characters can be individually included or excluded from account-wide views. This helps prevent unused alts, old characters, or bank characters from cluttering account-wide search results.

When AmberBank encounters a new character, it can display a one-time prompt asking whether that character should be included in account-wide inventory views.

The prompt appears only once per character unless the AmberBank saved database is reset.

The prompt can also be disabled globally from AmberBank Settings.

Available character controls include:

- Include the current character in account-wide views
- OPT-IN All
- OPT-OUT All
- Never prompt toons
- Require per-character permission
- Enable Per-Character Tooltips
- Character Class Colors


PER-CHARACTER TOOLTIP COUNTS
============================

When account-wide character information is enabled, AmberBank can add a character breakdown to item tooltips.

Example:

Characters:
98  Character1  (0 Bank, 98 Bags)
34  Character2  (0 Bank, 34 Bags)
10  Character3  (0 Bank, 10 Bags)

AmberBank can also display overall cached item totals for:

- Bags
- Personal Bank
- Warband Bank
- Guild Bank
- Total Items

Shared Warband and Guild Bank quantities are kept separate from individual character-owned Bag and Personal Bank totals.


DISPLAY AND INVENTORY FEATURES
==============================

AmberBank includes additional display and inventory information beyond basic cached browsing.

Features include:

- Separate Personal, Warband, and Guild Bank views
- Cached Personal Bank browsing for eligible offline characters
- Cached character Bag inventory tracking
- Cached gold display for the selected storage type
- Search-result quantity indicators on AmberBank storage tabs
- Quest item slot indicators
- Profession crafting-quality indicators
- Configurable crafting-quality indicator size
- Character class colors in account-wide character results
- Item charge information retained when Blizzard exposes it
- Optional minimap launcher with saved positioning
- Small AmberBank launcher integrated with Blizzard's Bank interface
- Optional Escape-key close behavior


CRAFTING QUALITY DISPLAY
========================

AmberBank can display crafting quality or rank indicators directly on supported crafted items.

The indicator size can be adjusted from AmberBank Settings.

An optional setting named:

AmberBank Quality Atlas Displayed

can show additional crafting-quality identification information in supported item tooltips.

This option is intended primarily for diagnostics and detailed inspection.


MINIMAP BUTTON
==============

AmberBank includes an optional minimap launcher.

Left Click:
Open or close AmberBank.

Right Click:
Open AmberBank Settings.

Drag:
Move the AmberBank button around the minimap.

The minimap position is saved between sessions.


CACHED DATA
===========

AmberBank is cache-based.

Personal Bank, Warband Bank, Guild Bank, and Bag information is updated when the corresponding storage is available to the addon.

For characters or storage that are not currently accessible, AmberBank displays the most recently cached information.

Offline information therefore represents the last data AmberBank was able to scan and may not reflect changes made since that scan.


ITEM CHARGES
============

Some item instance information is only exposed by Blizzard under specific conditions.

AmberBank preserves charge information when Blizzard exposes it.

For supported items where Blizzard does not expose a current charge value until the item has been physically inspected, AmberBank may display a known fallback assumption until a real value becomes available.

Real cached charge information always takes precedence when available.


DIAGNOSTICS
===========

AmberBank includes diagnostic controls for troubleshooting.

Dump Diagnostics
Enables additional AmberBank diagnostic output.

Quiet informational messages
Reduces non-essential AmberBank informational messages.

AmberBank Quality Atlas Displayed
Shows additional crafting-quality identification information in supported item tooltips.


RESET DATABASE
==============

AmberBank includes a Reset DB option.

Reset DB completely clears AmberBank's saved database, cached inventory information, and stored AmberBank settings.

Use this option only when you intentionally want AmberBank to rebuild its stored inventory information from scratch.


ACTIVE DEVELOPMENT
==================

AmberBank is actively developed and feedback is welcome.

If you encounter a bug, have a feature request, or have an idea that could improve AmberBank, please leave a comment on the AmberBank CurseForge project page.

You may also contact the author through the CurseForge messaging system from the author profile.

When reporting an issue, please include as much useful detail as possible, including:

- What you were doing
- What you expected to happen
- What actually happened
- Any Lua error message that was generated


AmberBank
Created by Playinghooky @ Stormrage
