[![Install](https://img.shields.io/badge/install-wago-C41E3A)](https://addons.wago.io/addons/gargul)
[![CurseForge](https://cf.way2muchnoise.eu/418746.svg)](https://www.curseforge.com/wow/addons/gargul)
[![Discord](https://img.shields.io/discord/864124999300153344?label=discord&color=5865F2)](https://discord.gg/D3mDhYPVzf)
[![Patreon](https://img.shields.io/badge/patreon-ff424d?logo=patreon&logoColor=white)](https://www.patreon.com/gargul)
[![Ko-fi](https://img.shields.io/badge/ko--fi-F16061?logo=ko-fi&logoColor=white)](https://ko-fi.com/gargul)

# Gargul

<p align="center">
  <img width="300" height="300" alt="image" src="https://github.com/user-attachments/assets/356aafed-be20-4c9d-b5e7-896394faff79" />
</p>

The all-in-one loot addon for World of Warcraft. GDKP, SoftRes, auto looting, auto rolling, TMB, DFT, and more. Works on Retail, Classic Era, and every flavor in between.

Only the loot master needs Gargul for most features. Raiders benefit from installing it too, but it's not required.

## Getting Started

```
/gl start
```

Run this in-game and Gargul walks you through everything: hotkeys, GDKP, SoftRes, auto looting, and auto rolling. No raid required, you can test every feature by yourself.

## What Can It Do?

| Feature | What it does | Command |
|---|---|---|
| **GDKP** | Auction loot and split the gold. Multi-auction lets you sell many items at once. | `/gdkp` or `/gl ma` |
| **SoftRes** | Import soft reserves from softres.it. Reserves show on tooltips and when rolling. | `/gl sr` |
| **Auto Looting** | Automatically send loot to the right player. Greens to DE, epics to ML, you name it. | `/gl pm` |
| **Auto Rolling** | Search for items and assign need, greed, or pass. Gargul rolls for you automatically. | `/gl autoroll` |
| **TMB / DFT** | Import wishlists and prio lists. Tooltip and roll integration. | `/gl tmb` or `/gl dft` |
| **Boosted Rolls** | Reward regulars with roll bonuses. | `/gl br` |
| **Plus Ones** | Track MS > OS +1 across raids. | `/gl po` |
| **Group Manager** | Auto-invite and sort groups from a raid signup. | `/gl gr` |

## Hotkeys

Use these on any item in your bags, loot windows, or chat links:

| Action | Default Hotkey |
|---|---|
| Roll out / Auction | `ALT_CLICK` |
| Award to a player | `ALT_SHIFT_CLICK` |
| Mark for disenchant | `CTRL_SHIFT_CLICK` |

Change hotkeys in `/gl` -> Shortcut Keys.

## Useful Commands

| Command | What it does |
|---|---|
| `/gl` | Open Gargul settings |
| `/gl start` | Quick start guide |
| `/gl help` | List all commands |
| `/gdkp` | GDKP session manager |
| `/gl ma` | Multi-auction (batch auction) |
| `/gl sr` | SoftRes import |
| `/gl pm` | Auto loot rules (PackMule) |
| `/gl autoroll` | Auto roll rules |

## Support Gargul

Gargul is free and always will be. If it saves you time, consider supporting development:

[![Patreon](https://img.shields.io/badge/monthly-patreon-ff424d?style=for-the-badge&logo=patreon&logoColor=white)](https://www.patreon.com/gargul)
[![Ko-fi](https://img.shields.io/badge/one--time-ko--fi-F16061?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/gargul)

Found a bug or need help? [Join the Discord.](https://discord.gg/D3mDhYPVzf)
