NeedGreedLoot (NGL) is a World of Warcraft (WoW) addon designed for raid leaders and loot master assistants to streamline loot distribution and track /roll scores. It features Need vs. Greed priority rules, multiple loot modes, Profile management, and loot history tracking.
1. Quick Start & Core Logic
Permission Requirements: Initiating and ending rolls are restricted to the Raid Leader or Raid Assistant.
Need vs. Greed Rules:
When a player performs a /roll, the addon checks whether they have consumed their "Need" eligibility in the current active Profile.
- Has Need Eligibility: Roll score is tagged as [Need].
- Need Expired: Roll score is automatically tagged as [Greed].
- Winner Determination: [Need] rolls always beat [Greed] rolls, regardless of score. If no player rolls Need, the highest [Greed] roll wins.
- Winning an item via Need automatically marks the winner's Need as consumed. Winning via Greed increments their Greed count (+1) without affecting their Need status.
2. Loot Distribution Modes
NGL provides three primary commands to initiate rolls depending on the raid scenario:
| Command | Mode | Description |
/ngl |
Need/Greed (Default) | Default mode. Players with unused Need roll as Need; those without roll as Greed. |
/ngln |
Need Only | Restricts rolling exclusively to players who still have Need eligibility. Greed rolls are ignored. |
/nglg |
Greed Only | All rolls are treated as Greed. Does not consume anyone's Need status, but increments Greed win counts. |
3. Starting a Roll & In-Game Controls
Hover Roll (Recommended)
Hover your mouse cursor over an item in your bags or equipment slots, then type in chat:
/ngl|/ngln|/nglg- Starts a roll for the hovered item using the global default countdown duration.
/ngl [seconds]|/ngln [seconds]|/nglg [seconds]- Starts a roll for the hovered item with a custom timer (e.g.,
/ngl 15starts a 15-second countdown).
- Starts a roll for the hovered item with a custom timer (e.g.,
Item Link Roll
/ngl [Item Link]- Starts a roll for the linked item with default timer.
/ngl [Item Link] [seconds]- Starts a roll for the linked item with a custom timer (e.g.,
/ngl [Item Link] 30).
- Starts a roll for the linked item with a custom timer (e.g.,
Early Termination
/ngl stop- Immediately stops the active roll timer, evaluates the current scores, and announces the winner.
4. Profile Management
NGL supports multiple Profiles to help manage different raid groups (e.g., 25-man raids, 10-man alt runs, or GDKP tracking).
| Command | Description |
/ngl profiles |
Lists all created Profiles (shows which one is currently active). |
/ngl profile [name] |
Switches to the specified Profile (e.g., /ngl profile 25manMain). |
/ngl profile new [name] |
Creates a new Profile and automatically switches to it. |
/ngl profile delete [name] |
Prepares to delete a specified Profile (requires confirmation). |
/ngl yes |
Confirms Profile deletion within 30 seconds of issuing a delete command. |
/ngl default |
Instantly switches back to the default system profile (default). |
5. Loot History & Records
/ngl listDisplays a summary for all players in the active Profile, including:
-
-
Need status (
[Eligible]/[Consumed]) -
Total Greed wins count
-
Item history and winning roll scores
-
-
/ngl reset- Resets all records for the current active Profile (clears consumed Need statuses and win history). Use this at the start of a new raid lockout or reset day.
6. System & Configuration Commands
/ngl timer [seconds]- Sets the global default roll timer (minimum 5 seconds, default is 20 seconds).
/ngl debug- Toggles debug log messages in the chat frame for troubleshooting roll detections.
/ngl helpor/ngl ?- Opens the in-game command reference summary.
The NeedGreedLoot (NGL) Team
