# SapphireShout

SapphireShout is a World of Warcraft Classic Warrior addon built around Solarian's Sapphire and Battle Shout. It keeps PvE and PvP restore trinkets separate, handles the Sapphire swap outside combat, restores your selected slot-14 trinket after a successful shout, and announces the detected shout type in SAY chat.

## How it works

Outside combat, the macro uses a clear two-step flow:

1. The first press equips Solarian's Sapphire and prepares the enhanced Battle Shout. If Sapphire is already equipped, it remains equipped.

2. The second press casts Battle Shout. Once the cast succeeds, SapphireShout restores the configured trinket and queues the announcement.

During combat, the addon never swaps equipment. The same macro simply casts a normal Battle Shout with one press.

PvE and PvP use separate macros because field PvP cannot be identified reliably in every situation:

- `SapphireShout` for PvE

- `SapphirePvP` for field or instance PvP

Both modes have independent restore settings, but you may select the same trinket for both.

## Shout detection

Announcements are sent only after a successful Battle Shout and are classified as:

```text

Normal Battle Shout

Enhanced Battle Shout (Sapphire)

Enhanced Battle Shout (Wrath 3pc)

Enhanced Battle Shout (Sapphire + Wrath 3pc)

```

The Wrath classification checks for at least three equipped pieces from the Battlegear of Wrath set. No attack-power values are hardcoded or estimated.

## Language support

Language detection is automatic by default:

- Korean on a `koKR` client

- English on every other client locale

You can override the language instantly from the `/ss` settings panel or with `/ss language auto|en|ko`. Settings, warnings, status text, and SAY announcements are localized. Item and spell names continue to follow the WoW client language.

## Setup

1. Install and enable SapphireShout.

2. Install `MessageQueue` if you want actual SAY announcements.

3. Type `/ss` and select the PvE and PvP restore trinkets.

4. Open `/macro` and drag the automatically created `SapphireShout` and `SapphirePvP` macros to your action bars.

The settings panel shows whether configuration is complete, whether MessageQueue is available, and whether both macros are ready.

## Commands

- `/ss` — open settings

- `/ss macro` — recreate or update both macros

- `/ss restore` — restore the saved trinket immediately

- `/ss status` — show configuration, language, MessageQueue, and shout status

- `/ss language auto|en|ko` — select the display language

- `/ss debug` — toggle debug output

## Requirements

- World of Warcraft Classic, Interface 20504-20506

- Warrior

- Solarian's Sapphire, item:30446, for Sapphire-enhanced Battle Shout

- `MessageQueue` for actual SAY output

SapphireShout remains loaded without MessageQueue, but announcements are shown only as local warnings.

# SapphireShout

SapphireShout은 솔라리안의 사파이어와 전투의 외침 사용을 돕는 World of Warcraft Classic 전사용 애드온입니다. PvE와 PvP 복원 장신구를 따로 관리하고, 비전투 중 사파이어 교체부터 전침 성공 후 14번 장신구 복원까지 처리하며, 적용된 전침 종류를 일반채팅으로 알려줍니다.

## 동작 방식

비전투에서는 명확한 2단계 방식으로 동작합니다.

1. 첫 번째 클릭은 솔라리안의 사파이어를 착용하고 강화 전침을 준비합니다. 이미 사파이어를 착용 중이라면 그대로 유지합니다.

2. 두 번째 클릭은 전투의 외침을 시전합니다. 시전 성공이 확인되면 설정한 장신구를 복원하고 일반채팅 메시지를 큐에 넣습니다.

전투 중에는 장비를 교체하지 않습니다. 같은 매크로를 한 번 누르면 일반 전침만 사용합니다.

필드 PvP 상황을 항상 정확하게 자동 판별할 수 없으므로 PvE와 PvP 매크로를 분리했습니다.

- PvE: `SapphireShout`

- 필드 또는 인스턴스 PvP: `SapphirePvP`

두 모드의 복원 장신구 설정은 서로 독립적이며, 필요하면 같은 장신구를 양쪽에 지정할 수도 있습니다.

## 전침 분류

일반채팅 메시지는 전투의 외침 시전 성공 후에만 전송되며 다음과 같이 구분됩니다.

```text

일반 전침

강화 전침 (사파)

강화 전침 (격노3셋)

강화 전침 (사파+격노3셋)

```

격노 판정은 격노 방어구 세트 중 3개 이상을 실제로 착용했는지 확인합니다. 공격력 증가량을 하드코딩하거나 추정하지 않습니다.

## 언어 지원

기본 설정은 자동 감지입니다.

- `koKR` 클라이언트: 한국어

- 그 외 클라이언트: 영어

`/ss` 설정 화면 또는 `/ss language auto|en|ko` 명령어로 즉시 변경할 수 있습니다. 설정 화면, 경고, 상태 문구, 일반채팅 출력이 함께 변경되며 아이템명과 기술명은 WoW 클라이언트 언어를 따릅니다.

## 설정 방법

1. SapphireShout을 설치하고 활성화합니다.

2. 실제 일반채팅 출력을 사용하려면 `MessageQueue`를 설치합니다.

3. `/ss`를 입력하고 PvE/PvP 복원 장신구를 선택합니다.

4. `/macro`를 열고 자동 생성된 `SapphireShout`, `SapphirePvP` 매크로를 단축바로 끌어다 놓습니다.

설정 화면에서 장신구 설정 완료 여부, MessageQueue 설치 여부, 매크로 준비 상태를 확인할 수 있습니다.

## 명령어

- `/ss` — 설정 열기

- `/ss macro` — 두 매크로 다시 생성 또는 갱신

- `/ss restore` — 저장된 장신구 즉시 복원

- `/ss status` — 설정, 언어, MessageQueue, 전침 상태 확인

- `/ss language auto|en|ko` — 표시 언어 선택

- `/ss debug` — 디버그 출력 전환

## 요구 사항

- World of Warcraft Classic, Interface 20504-20506

- 전사

- 사파이어 강화 전침을 위한 솔라리안의 사파이어(item:30446)

- 실제 일반채팅 출력을 위한 `MessageQueue`

MessageQueue가 없어도 SapphireShout은 로드되지만 일반채팅 대신 로컬 경고만 표시합니다.