SapphireShout

# 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.