# SimplePartyScanner

SimplePartyScanner is a lightweight World of Warcraft Retail addon that prints useful party information directly to chat.

## Features

- `/scanner` or `/sps` inspects your current party or raid and prints each group member using your selected display mode.
- Supports configurable scan output for item level and Mythic+ rating.
- Uses Blizzard's native Mythic+ rating API first.
- Falls back to RaiderIO automatically when Blizzard does not expose the score for an inspected player.
- Announces Mythic+ and raid Group Finder listings when you join them.
- Shows 5-player group repair status in chat when a ready check starts (only players with available repair data are printed).
- Repair percentages can be clicked in chat to notify the group.
- Supports automatic English and Spanish localization based on the client locale.

## What The Addon Does

SimplePartyScanner has three main functions:

1. Group scan with `/scanner` or `/sps`

- Inspects the players currently in your party or raid.
- Prints each player's average equipped item level when `ilevel` is enabled.
- Prints each player's Mythic+ rating when `rating` is enabled.
- Uses RaiderIO as a fallback source if Blizzard's API does not return Mythic+ rating data.
- Prints a final summary based on enabled fields.

2. Group Finder join announcement

- Detects when you join a Mythic+ or raid group through Group Finder.
- Prints the listed difficulty in chat.
- Prints the dungeon or raid name.
- Prints the title of the listing you joined.

3. Ready check repair report for 5-player groups

- When a ready check starts in a 5-player group, the addon shares durability data through addon messages.
- The chat output only shows players with available repair percentage data.
- Clicking a repair percentage sends a group chat warning for that player.
- This feature works best when the whole group has the addon installed.

## Commands

- `/scanner`
- `/sps` (same as `/scanner`)
- `/sps all` (show rating + ilevel)
- `/sps rating` (show only Mythic+ rating)
- `/sps ilevel` (show only item level)
- `/sps rating,ilevel` (same as `all`)
- `/scanner help` or `/sps help`

## Chat Output

The scan prints one line per player with:

- Character name
- Average item level (if enabled)
- Mythic+ rating (if enabled)

At the end of the scan, the addon prints a short summary with:

- Group member count
- Average item level (if enabled)
- Average Mythic+ rating of players with available score data (if enabled)

When you join a Group Finder listing for Mythic+ or raids, the addon prints:

- Difficulty
- Dungeon or raid name
- Listing title

## RaiderIO Integration

RaiderIO is optional.

If RaiderIO is installed and loaded, SimplePartyScanner uses it as a fallback source for Mythic+ rating when Blizzard's API returns no score for the inspected unit. RaiderIO score colors are also used when available.