(263 Kb)
Updated: 07-10-18 09:58 AM
File Info
Battle for Azeroth (8.0.1)
Updated:07-10-18 09:58 AM
Created:06-09-18 05:00 AM

PersoLootRoll (BFA Beta)

Version: 9
by: Shrugal [More]

A World of Warcraft addon to share and roll on items when using personal loot.

This is the BFA-Beta version of the addon, you can get the live version here.


  • Shows Blizzard's built-in group-loot roll windows to roll on tradable personal loot from other players.
  • Rolls on loot by whispering/rolling in chat or (if the other person has PLR as well) via addon-message in the background.
  • Offers loot you don't want to others, and handles accepting bids, picking a winner and trading automatically.
  • Figures out what you and other players can trade and use, so you only have to decide when it actually makes sense.
  • Includes a masterloot mode with support for loot councils and custom answers.
  • Messages the addon sends to other players can be customized and turned on/off based on the type of group (raid/party, guildgroup, LFR) or target (friend, guildmember).

The idea of PLR is to use the built-in roll frames (that are used for group loot etc.), and make them work for personal loot as well. This means that whenever someone in your party/raid gets an item PLR will figure out if you could use it (based on armor/weapon type, attributes, equipped ilvl etc.), and pop up a roll window for you to decide whether you want it or not. If you click "Need" or "Greed" and the item owner doesn't have PLR as well, then it ask for the item by whispering "Do you need that [item-link]?", and it will also roll (/roll) for the item if the owner posts a link in group chat. If the owner also has PLR, then all this happens in the background without any chat messages.

If you loot an item that someone else could use, then it will show you the same roll window, and offer it to your group if you don't roll "Need" on it. It then accepts bids via whispers, rolls in chat or in the background if the other person is also using PLR, and after a short waiting period it will pick a winner and inform your group about it. If you want to decide yourself you can also right-click on other players' unit frames to directly give them an item that is being rolled for, ending the roll instantly.

Once you won loot from someone or someone won loot from you, PLR will give you a link in chat that you can click on to start following and trading the owner/winner of the item. It will then automatically put won items into the trade window, so you only have to click accept.

Whenever you join a group PLR will start inspecting the other group members, to figure out which items you loot would be interesting for them, and which items they looted should be tradable. The inspection process is done in a way that it shouldn't interfere with your gameplay (e.g. it pauses during boss fights), and there is a 30 ilvls (60 ilvls for trinkets) threshold in place so PLR doesn't ignore stuff that is lower than what you have but e.g. has better stats or a gem slot.

You can open the overview window by clicking on the minimap icon, and then search for or become a masterlooter by clicking the button in the lower right corner. When you become a masterlooter other PLR-users in your group will get a message, asking them to accept you as their masterlooter. If they accept, then all loot they get will be distributed by you, so other players' bids on items will go to you, and once a roll has ended you can decide by hand who should get it. The item owner will get a notice in chat, instructing him/her to trade the item to the winner. As a masterlooter you can also declare other players as your loot council, so they will see bids as you do and can vote on who should get the loot.

Use /plr or /PersoLootRoll to open the rolls overview window, manually start rolling for items in your bag etc.

/plr: Open rolls window
/plr roll [item]* (<timeout> <owner>): Start a roll manually for one or more item(s)
/plr bid <owner> ([item]): Bid for an item from another player
/plr options: Open options window
/plr config: Change settings through the command line
/plr help: Print this help message

Legend: [..] = item link, * = one or more times, (..) = optional

I would consider this a Beta release right now. I am using it myself and it works well, but there are probably some bugs left.

These are the things I have planed currently:
  • More translations: Sadly I only speak German and English, so if you speak another language (or find errors in my translations) and want to help then please head over to the CurseForge translation section!
  • Better trade tracking
  • Blocking all whispers from eligible players while a roll is going on
  • Integrations with Pawn and DKP systems like EQDKP and EPGP

You can either post here in the comments or create an issue over on GitHub if you encounter any bugs or want to suggest a feature.

BFA Beta
  • Updated interface version
  • Updated Ace3 libs to r1175-alpha
  • Added workaroud for SendAddonMessage's diconnect bug

Version 9
  • Added an actions window to show pending actions such as trade or whisper
  • Added recording of whisper chats with winner/owner of items
  • Added a whisper button to Actions and Rolls windows that also shows recorded whispers on mouseover
  • Added support for item level scaling in low-level content and while timewalking
  • Added ilvl threshold scaling for low-level chars
  • Added support for argument reordering in translation lines
  • Added zhTW translation (big thanks to BNSSNB!)
  • Update other translations and made importing from CurseForge easier in the future
  • Updated whisper reaction, answer and suppression logic
  • Whispers from other addon users are now ignored
  • Only handle outgoing whispers when tracking and only to other party members
  • Roll visibility is now stored inside the roll, to make it consistent across GUIs
  • Renamed masterlooter saved var to make it consistent with the other vars
  • Fixed bug caused by previous renaming of lang-lines
  • Removed upper() call on Rolls window headers
  • Minor Trade refactoring
  • Replaced custom realm list with LibRealmInfo
  • Moved options table registration to OnEnable so realm data is available
  • PLR rolls ids are now negative numbers instead of strings prefixed with "PLR" to prevent errors when other addons try to pass them to GameTooltip:SetLootRollItem on their own (unhooked) GameTootlip instances. Now those calls will just silently fail.
  • Fixed bug causing no items to be added to the trade window when trading with players from other realms
  • Fixed bug where rolls appeared for legendary and heirloom items
  • Fixed bug where the game menu won't show up anymore after clicking the "Move" button in the options
  • Fixed internal events for more than one listener
  • Hopefully fixed item label formatting once and for all
  • Minor bugfixes

Version 8
  • Added whisper message suppression while giving away loot
  • Added a group-wide whisper limit of 2 per item to prevent spamming players not using the addon
  • Added an empty message to the rolls window
  • Added roll frame highlighting for own items
  • Updated last-chatted logic
  • Rearranged and simplified options interface
  • Removed UnitMenu hooks and UnitMenu on right-click in rolls window to prevent taint
  • Moved remaining dropdown menus to AceGUI implementations
  • Trinket list update
  • Fixed LibDBIcon import (thanks to wagg1)
  • Fixed bid links for non-ascii unit names
  • Minor bugfixes and translation updates

Version 7
  • Add a hide/show button to hide specific rolls in the list
  • Changed "Canceled" to "Hidden" filter, filtering in/out canceled, pending and hidden rolls.
  • Embedded CallbackHandler into Roll and Masterloot
  • GUI Updates are now triggered by events, rather than direct method calls
  • Moved masterloot council options into it's own tab
  • Changed table layout slightly to be more in-line with the upcoming AceGUI version

Version 6
  • Fixed bug where players could be added, but not removed from the masterlooter whitelist.
  • Updated the version tooltip to better distinguish between players with/without the addon
  • Fixed workaround for ElvUI bug causing group loot frames to appear on top of each other
  • Hopefully fixed taint caused by early dropdown initialization
  • Fixed leaking "unit" variable into global namespace
  • Added a table pool to reduce memory usage when using temp tables
  • Fixed preview of equipped items for relics and when there is no min slot level (because of missing links or non-unique relics)
  • Fixed item position detection and trading
  • Inspection now includes the player, to streamline the access to equipped item links
  • Refactored GUI update code to make it more readable and straightforward
  • Some translation updates

Version 5
  • Moved some options around, made more use of tabbed UI (for masterloot+masterlooter and messages options)
  • Added options to customize the messages the addon sends to other players
  • Added toggle to enable/disable the double ilvl threshold for trinkets
  • Bugfixes and translation updates

Version 4
  • Fixed options migration bug causing the options page to throw an error once after updating
  • Added time remaining to rolls list and chat roll result to bids list in the overview window

Version 3
  • Custom answers for 'need' and 'greed' can now be specified in the 'Masterlooter' options and accessed with a right-click on the corresponding roll button
  • Bids are now color-coded in the rolls overview window
  • Fixed rolls overview window frama strata, so it's no longer above everything else
  • Added version label and tooltip in the upper right corner of the rolls overview window
  • Added item icons to the bids list of the rolls overview window
  • Updated trinkets list
  • Bugfixes

Version 2
  • Masterlooting is now tracked for all players with the addon
  • Added ilvl threshold option
  • Added custom timeout option when masterlooting
  • Added an option to pick the specs the player cares about
  • Fixed bug where item attribute amounts where wrong
  • Added transmog options to also check if the player has an item's appearance unlocked when deciding to roll on it or not
  • Added option to add members of a certain guild rank to the council, in addition to guild master and officers
  • Made masterloot and council whitelists realmfaction options
  • Translation updates and bugfixes
Optional Files (0)

Archived Files (3)
File Name
07-02-18 12:59 PM
06-25-18 06:24 AM
06-09-18 05:00 AM

There have been no comments posted to this file.
Be the first to add one.

Category Jump: