EchoTools

# EchoTools

**LFG Alert · Skill Sound · Class Resource · Cast Bar · BRes/Lust Tracker**

An all-in-one WoW quality-of-life addon with an ElvUI-inspired dark theme. Compatible with TWW (11.0) and Midnight (12.1.0).

**파티 지원 알림 · 스킬 사운드 · 클래스 리소스 · 캐스트 바 · 전투부활/블러드 추적**

와우 편의성 기능을 하나로 모은 애드온입니다.

---

## Features / 기능

### LFG Alert / 파티 지원 알림

- Alert sound, screen notification, and chat message when new applicants arrive

- Auto-open applicant list panel

- **Leader Only** or **Always Alert** mode

- **Min iLvl / Score Filter**: only alert for applicants above threshold

- **Applicant History**: `/et history` shows recent applicants

- Customizable alert sound: built-in presets, custom .ogg file, or any WoW Sound ID

- Party frame item level display via inspect

### Skill Sound / 스킬 사운드

- Play custom sounds on spell cast start or success

- **Spell Capture Mode**: cast any spell to auto-detect Spell ID

- **Action Bar Scanner**: pick spells from your current action bars with spell icons

- **Manual ID Input**: enter Spell ID directly with real-time name lookup

- **Jump Sound**: dedicated sound on spacebar jump

- Duplicate warning before overwriting existing mappings

- Per-character settings, with Import/Export between characters

### BRes / Lust Tracker / 전투부활 · 블러드 추적

- Two icon slots on one draggable anchor: **battle-res charges** and the **lust lockout**

- **Battle res**: shows the group's shared battle-res charges and recharge timer inside raids and M+ — no roster scan needed

- **Lust**: counts down the Sated/Exhaustion lockout so you always know when the next Bloodlust is available

- **Lust Sound**: plays your own `.ogg` / `.mp3` the moment Bloodlust / Heroism / Time Warp / Drums land on you

- Built for 12.1's secret-aura restrictions: when the exact time can't be read, an estimated timer (marked `~`) takes over and snaps to the real value as soon as one is readable

- Lust timer survives `/reload` — reloading mid-pull won't reset it

- Options: per-content visibility (raid / dungeon / open world / combat-only), horizontal or vertical layout, icon size, scale, timer text, captions

### Class Resource / 클래스 리소스

- **Warlock (for now)**: pip-based Soul Shard display for all three specs

- Suppresses Blizzard's default Warlock power frame for a cleaner HUD

- Per-spec visibility and positioning

### Cast Bar / 캐스트 바

- Custom player cast bar with configurable size, position, and style

- `/et cast` commands for live tuning

### UI & Compatibility

- ElvUI-inspired dark flat design

- Draggable minimap button (LibDBIcon compatible + custom fallback)

- Addon Compartment (11.0+ minimap menu) and Blizzard Settings integration (ESC → Settings → AddOns)

- Localization: English, Korean (한국어)

- API compatibility layer for TWW + Midnight 12.1 (no deprecated API crashes)

- 12.1 secret-value safe: the only aura ever read is the Sated/Exhaustion debuff, always behind a protected call — a secret value can never leak out as a false reading

- Korean reload aliases: `/기`, `/리` (alongside `/rl`)

---

## Installation / 설치

1. Download and extract to your WoW AddOns folder:

   `World of Warcraft/_retail_/Interface/AddOns/EchoTools/`

2. Place custom sound files (`.ogg` / `.mp3`) in:

   `World of Warcraft/_retail_/Interface/AddOns/Sounds/`

   This folder is **not** managed by addon managers — your sound files are safe from updates.

3. Reload UI (`/reload`) or restart WoW.

---

## Commands / 명령어

| Command | Description |

|---------|-------------|

| `/et` | Open settings panel / 설정 패널 열기 |

| `/et lfg` | Toggle LFG Alert / 파티 알림 토글 |

| `/et ss` | Toggle Skill Sound / 스킬 사운드 토글 |

| `/et bres ...` | BRes/Lust tracker sub-commands / 전투부활·블러드 추적 설정 |

| `/et lust` | Lust sound diagnostic + file test / 블러드 사운드 진단 |

| `/et cr ...` | Class Resource sub-commands / 클래스 리소스 설정 |

| `/et cast ...` | Cast Bar sub-commands / 캐스트 바 설정 |

| `/et status` | Show current settings / 현재 설정 확인 |

| `/et test` | Test LFG notification / 알림 테스트 |

| `/et history` | Show recent applicants / 최근 지원자 보기 |

| `/et minimap` | Toggle minimap button / 미니맵 버튼 토글 |

| `/et help` | Show all commands / 전체 명령어 |

---

## Sound Files / 사운드 파일

Place `.ogg` (or `.mp3`) files in `Interface/AddOns/Sounds/`:

- `Sounds/alert.ogg` → enter "alert.ogg" in settings

- `Sounds/skills/fireball.ogg` → enter "skills\fireball.ogg"

The `Sounds/` folder is not an addon — addon managers will not touch it, keeping your files safe from updates.