# FriendAlerts
<img alt="GitHub Issues or Pull Requests" src="https://img.shields.io/github/issues/nickstuer/friendalerts">

[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/nickstuer/FriendAlerts)](https://github.com/nickstuer/FriendAlerts/commits/master) [![Last commit](https://img.shields.io/github/last-commit/nickstuer/FriendAlerts)](https://github.com/nickstuer/FriendAlerts) [![CurseForge](https://img.shields.io/curseforge/dt/1248750?label=CurseForge&color=F16436)](https://www.curseforge.com/wow/addons/friendalerts)

A World of Warcraft addon for Battle.net style alerts when friends/guildies change gamess, changes zones, or levels their World of Warcraft character.

## Table of Contents

- [Features](https://github.com/nickstuer/friendalerts?tab=readme-ov-file#-features)
- [Install](https://github.com/nickstuer/friendalerts?tab=readme-ov-file#-install)
- [Usage](https://github.com/nickstuer/friendalerts?tab=readme-ov-file#-usage)
- [Development](https://github.com/nickstuer/friendalerts?tab=readme-ov-file#-development)
- [Contributing](https://github.com/nickstuer/friendalerts?tab=readme-ov-file#-contributing)

## 📌 Examples
![Example Alert](images/example.png)

![Example Alert2](images/example2.png)

## 📖 Features

### Launching New Games
Displays a Battle.net style message in the chat window to indicate that a friend has launched a new game.

### Changes WoW Characters
Displays a Battle.net style message in the chat window to indicate that a friend has logged into a different WoW character.

### Ding WoW Level
Displays a Battle.net style message in the chat window to indicate that a friend or guild member has dinged a new level.

### Entering New Zones
Displays a message in the chat when a Battle.net friend or guild member enters a new zone in World of Warcraft.

### Easy Configuration
Quickly configure the alerts to avoid chat spam. Select between Battle.net Favorite, Battle.net Friend, Character Friends, Guild Members.

### Supported Game Notifications
| Game                                  | Status                              |
| :----------------------------------:  | :--------------------------------:  |
| World Of Warcraft (Retail)            | Supported                           |
| World Of Warcraft (Classic)           | Supported                           |
| World of Warcraft (Classic Era)       | Supported                           |
| Diablo III                            | Supported                           |
| Diablo IV                             | Supported                           |
| Hearthstone                           | Supported                           |
| Heroes of the Storm                   | Supported                           |
| Overwatch                             | Supported                           |

## 🛠 Install
```
1. Download from [CurseForge](https://www.curseforge.com/wow/addons/friendalerts) or use the CurseForge/WoWUp-CF app
2. Extract to your 'World of Warcraft/Interface/AddOns' folder
3. Ensure the addon is enabled on the character selection screen
```

## 🎮Usage
- The addon works automatically once installed and will display alerts in the default chat frame
- No additional commands or setup required for basic functionality
- Configure the types of alerts you want to receive by typing '/fa'

## 🔗 Configuration

### Slash Commands
Use these commands to open up the FriendAlerts configuration.
```
/fa
/friendalerts
```

## 💻 Development

#### Useful Links
Helpful links for developing or contributing to the addon.

[Sound IDs](https://www.wowinterface.com/forums/showthread.php?t=55702)

[BNGetFriendInfo](https://warcraft.wiki.gg/wiki/API_BNGetFriendInfo)

[Sounds](https://www.wowhead.com/sounds)

[Icon String Format](https://www.wowinterface.com/forums/showthread.php?t=46221)

[Chat Icons](https://wago.tools/files?search=chaticon)

[WoW Tools](https://old.wow.tools/files/#search=chat%2Ctype%3Aogg&page=1&sort=0&desc=asc)

#### Deploy
This copies the addon files to the appropriate World of Warcraft addons folder.
- MacOS: bash ./deploy.sh
- Windows: ./deploy.sh (via bash terminal)


## 🏆 Contributing
PRs accepted.

If editing the Readme, please conform to the [standard-readme](https://github.com/RichardLitt/standard-readme) specification.

#### Bug Reports and Feature Requests
Please use the [issue tracker](https://github.com/nickstuer/friendalerts/issues) to report any bugs or request new features.

#### Contributors

<a href = "https://github.com/nickstuer/friendalerts/graphs/contributors">
  <img src = "https://contrib.rocks/image?repo=nickstuer/friendalerts"/>
</a>
