This addon brings back the Need-Greed loot system and makes it work for Personal Loot. The goal is to make asking for, giving away and trading loot easy and straight forward, in PUGs as well as organized guild groups. Everything is designed to be as streamlined and out of your way as possible, so you can focus on playing the game instead of manually checking and keeping track of items you and others want.
Get it from Curse or WoWInterface!
Whenever an item drops for someone in your group that might be an upgrade for you, you will get a good old Need-Greed-Pass roll window (remember those? :P) to decide if you want it or not. Rolling "Need" or "Greed" will add the item to your actions list (see below) for easy asking and trading, and optionally automatically send a whisper message to the owner asking for the item. If the owner uses PLR or another compatible addon as well, then all this happens in the background without need for whisper messages.
You also get a similar Keep-Greed-GiveAway roll window when you loot something that your party members might be interested in. If you choose "Greed" or "Give Away", then PLR offers the item to your group through party chat and handles accepting bids, picking a winner and trading the item for you. If you choose "Keep" on the other hand, then it'll automatically answer incoming whisper requests with "I need that myself".
All your pending actions (asking for loot, trading, ...) will be shown in a simple list on screen, along with buttons for completing them.
PLR is especially smart when it comes to choosing the right items for you. Many factors are checked before you are asked to roll on or give away an item, e.g. if it is actually tradable, what ilvl you and your party members have equipped, class restrictions, trinket type, and so on. It will only ask you to decide when it actually makes sense, while making sure you don't miss any loot you might be interested in.
It works great for randomly giving away loot in PUGs and organized groups, but it also has a masterloot mode where one person decides who should get which item. The masterlooter can also configure things like custom answers and a loot council.
Just about everything can be easily tweaked in the options menu. This includes whether or not to send messages to other players and customizing them, what items are considered "useful" (e.g. only certain specs or transmog missing) and which parts of the UI you want to see. See this Wiki page for details.
This includes the popular loot roll addon Personal Loot Helper, Pawn to only roll on stuff that actually has your preferred stats, and EPGP to give away loot based on PR value or credit GP for awarded items.
More details can be found here.
Use /plr or /PersoLootRoll to open the rolls overview window, manually start rolling for items in your bag etc.
/plr: Open rolls window/plr help: Print this help message/plr roll [item]* (<owner> <timeout>): Start a roll for one or more item(s)/plr bid [item] (<owner> <bid>): Bid for an item from another player/plr trade (<player>)Trade with the given player or your current target/plr testStart a test roll (only you will see it)/plr options: Open options window/plr config: Change settings through the command line/plr logShow log
Development commands:
/plr debugToggle debug mode/plr trinketsGenerate and show a new list of trinkets/plr instancesGenerate and show a new list of instances
Legend: [..] = item link, * = one or more times, (..) = optional
PLR is translated (incl. chat messages) to
- English: 100%
- German: 100%
- Traditional Chinese: 100% (by BNS333)
- Simplified Chinese: 100% (by john_yasen)
- Spanish: 75% (by jolugon, sinnkin)
- Russian: 60% (by Voopie)
- French: 20% (by Harkann)
If you want to help translate it to your language or correct translation errors you found then please visit the Curseforge Translation section and also check out this wiki page for some tips.
This project is fully open-source and the source code can be found on GitLab. To test out new features there are also beta versions available. Please report any bugs you find with these versions should you be brave enough to install them, so the stable releases will be as bug-free as possible.
Please create a new entry on the issue tracker if you encounter any bugs. You can also post little things
here in the comments. Also, in order to better identify the problem please type in /plr log right after the bug happend, and add the result to your issue/post.
You can suggest new features and vote on existing suggestions here.
To build a package from source you need to copy .release/.env.example to .release/.env, fill in the relevant infos (projects IDs and API tokens) and then
run .release/release.sh. The completed file(s) will be available in the .release folder. More information about possible arguments to the
release script can be found here.
You can run tests in-game or on the commandline. For in game tests install the WoWUnit addon so the tests will automatically
run on login. For the CLI install the LUA binary for your OS and then run lua Test.lua to test the current working dir, or lua Test.lua -b to run the
tests against a finished build.
Click on the "Donate" button if you want to support the development of this addon or just buy me a beer. Always appreciated, never required!
