Description
EN
# My BiS List
**My BiS List** is a lightweight, native Blizzard-style addon for tracking your Best-in-Slot gear directly from the in-game **Adventure Guide (Encounter Journal)** — with full support for all Dungeon, Raid, and Mythic+ difficulties, live stat scaling in tooltips, bag/character markers, and instant loot notifications.
---
## Key Features
### Adventure Guide Integration
* Adds an outlined favorite **star button** to every loot item in the Adventure Guide (you can also use **Alt + Left-Click** on any item row).
* **Right-Click** an active star in the Adventure Guide to quickly switch the saved difficulty variant to your current filter.
* Opening the Adventure Guide from the addon softly highlights the **Dungeons** and **Raids** tabs so you can jump straight into picking loot.
### Unified Items & Dynamic Difficulty / Mythic+ Scaling
* Each BiS item is stored **once** without clutter or duplicates, automatically unlocking all available variants for its instance type:
* **Dungeons:** Normal, Heroic, Mythic, and all **Mythic+ key tiers** (+2–+3 up to +10+) with accurate item levels and color-coded upgrade tracks (*Adventurer, Veteran, Champion, Hero*).
* **Raids:** Raid Finder, Normal, Heroic, and Mythic (*Veteran, Champion, Hero, Myth*).
* Click any item row (or the dropdown arrow) in the `/bis` window to switch its target difficulty or key level.
* **Live Tooltip Preview:** Hovering over an item in `/bis` or any option in the difficulty dropdown dynamically scales its **Item Level**, **Upgrade Track**, and **Stats** in real time.
### Loot Alerts (Solo & Group / Raid)
* Plays an alert sound and displays a screen & chat banner whenever you loot a BiS item.
* **Group & Raid Drop Tracking:** Notifies you when **another player** in your party or raid loots an item from your BiS list, including a **clickable player name** in chat so you can whisper them immediately.
* Individual sound toggles allow you to mute personal drops and/or other players' drops separately.
### Bag, Equipment & Tooltip Markers
* Displays a crisp favorite star on BiS items inside your **bags** and **character equipment slots**.
* Shows `[In Bags]` and `[Equipped]` status badges directly inside the `/bis` window.
* Enhances item tooltips across the game with your BiS **Source** (Dungeon/Raid), **Boss**, and selected **Difficulty**.
### Clean & Scalable Interface
* Styled after Blizzard's native UI with a **proportional scale grip** in the bottom-right corner (drag to scale between 65% and 165%, Right-Click to reset to 100%).
* **Minimap Button:** Clean status tooltip showing sound and lock states, drag to reposition, lock/unlock via **Shift + Right-Click**, or hide completely in settings.
* **Quick Settings Menu (Gear Icon):** Toggle sounds, hide or lock the minimap button — closes automatically on `ESC` or clicking outside.
* **Built-in Version Check:** Automatically notifies you via a compact popup if a newer version is available on CurseForge.
* **Seasonal Touch:** Subtle falling snowflakes in the BiS window from December 1 to January 15.
---
## Localization
Fully localized with native support for **4 languages**:
* **English** (`enUS`) — *My BiS List*
* **Russian** (`ruRU`) — *Мой BiS-лист*
* **German** (`deDE`) — *Meine BiS-Liste*
* **French** (`frFR`) — *Ma Liste BiS*
---
## Controls & Slash Commands
**Minimap Button:**
* **Left-Click:** Open / close the BiS List window.
* **Right-Click:** Open the Adventure Guide.
* **Shift + Right-Click:** Lock / unlock minimap button position.
**Inside the BiS Window (`/bis`):**
* **Left-Click on row / arrow:** Choose difficulty or Mythic+ key level.
* **Shift + Click:** Link item in chat.
* **Ctrl + Click:** Preview item in the Dressing Room.
**Chat Commands:**
* `/bis` — Open or close the BiS List window.
* `/bis test` — Test personal BiS loot alert & sound.
* `/bis testother` — Test party/raid member BiS loot alert & sound.
* `/bis snow` — Toggle winter snow effect manually.
* `/bis url` — Open the CurseForge link popup.
RU
---
# Мой BiS-лист (RU)
**Мой BiS-лист** — удобный аддон в стиле стандартного интерфейса Blizzard для отслеживания нужной экипировки (BiS) прямо из **Путеводителя по приключениям** с поддержкой всех сложностей подземелий, рейдов и ключей **Эпохальный+**, динамическим пересчётом характеристик в подсказках, отметками в сумках и оповещениями о добыче.
## Основные возможности
* **Интеграция с Путеводителем по приключениям:**
* На каждой строке добычи появляется кнопка со **звёздочкой** (также работает **Alt + ЛКМ**).
* **ПКМ** по активной звёздочке быстро переключает сохранённый вариант на текущую выбранную сложность.
* При открытии Путеводителя из аддона вкладки «Подземелья» и «Рейды» подсвечиваются золотым контуром.
* **Единый список и переключение сложностей / ключей М+:**
* Каждый предмет добавляется в список **один раз** без дубликатов и содержит все варианты выпадения (от *Обычного* до *Ключа +10 и выше* для подземелий, и от *Поиска рейда* до *Эпохального* для рейдов) с цветовой индикацией рангов улучшения (*Искатель приключений, Ветеран, Защитник, Герой, Легенда*).
* Клик по строке или стрелке в окне `/bis` открывает меню выбора сложности с **живым предпросмотром характеристик** — уровень предмета, ранг и статы в тултипе пересчитываются автоматически.
* **Оповещения о выпадении (себе и союзникам):**
* Звуковой сигнал, баннер по центру экрана и сообщение в чат, когда BiS-предмет выпадает **вам**.
* Уведомление, когда нужный вам предмет выпадает **другому игроку** в группе или рейде, с **кликабельным ником** в чате для быстрого шёпота.
* **Индикация в сумках, экипировке и тултипах:**
* Звёздочка поверх BiS-предметов в **сумках** и окне **персонажа**, а также статусы `[В сумке]` и `[Надето]` в самом списке.
* В подсказке любого BiS-предмета отображаются **Источник**, **Босс** и **Сложность**.
* **Настройки и масштабирование:**
* Пропорциональное масштабирование окна за правый нижний угол (от 65% до 165%, **ПКМ** — сброс на 100%).
* Меню настроек под **шестерёнкой**: раздельное отключение звука для себя и для других игроков, скрытие и закрепление кнопки у миникарты (закрывается по `ESC` или клику мимо).
* Автоматическая проверка обновлений среди согильдийцев и участников группы.
* Праздничный снегопад в окне списка с 1 декабря по 15 января.
## Команды и управление
* **Кнопка у миникарты:** **ЛКМ** — открыть BiS-лист, **ПКМ** — открыть Путеводитель, **Shift + ПКМ** — закрепить / открепить позицию.
* **В окне `/bis`:** **ЛКМ** — выбор сложности, **Shift + клик** — ссылка в чат, **Ctrl + клик** — Примерочная.
* **Чат-команды:** `/bis` (окно), `/bis test` (тест личного дропа), `/bis testother` (тест дропа союзнику), `/bis snow` (тест снежинок), `/bis url` (ссылка на CurseForge).
