This addon was written by the guild Angry (US-Illidan) to handle bidding out items in a DKP-like system. The addon itself is run by the master looter and anyone else (typically officers) who will be handling bids on items. Addon comm and chat messages are tied to the guild and raid lines, so it's assumed all bid handlers are in the guild and raid (no need to be in the actual raid instance, though). The addon is intended to automate the actual bidding process, and doesn't get involved in other aspects of the guild's points system (points are exported nightly to and then re-imported the next day from EQDKP). A separate client interface must be used by bidders: Angry Raid Points Client.
Bidding style used (with standard configuration) is:
- Only the people belonging to the highest priority group can bid, group priority is: Member mainspec > Member offspec > Trial mainspec > Trial offspec. If all members of a higher priority group pass, then the next-highest priority group can begin bidding.
- For mainspecs, the minimum bid is 10, for offspecs, the minimum bid is 1.
- Bidding is one round, from whoever currently has the least points to whoever has the most.
- Normally, all bids must be at least 1 point above the previous bid. However, bidders with less than the minimum can bid the minimum, but any bidder who has less than the minimum points can always be outbid by later bidder(s) if they also simply bid the minimum.
- Bidders who have the same current points will have their bidding order determined randomly.
Interfacing with the addon happens through the "/arp" command:
- /arp toggle - toggles the main GUI window of the addon (this is also bindable in the game's key bindings).
- /arp bid, /arp lastcall, /arp reminder - these are the console equivalents of buttons inside the GUI (see below for info).
- /arp remove [player] - this allows you to remove a player from your bidding list, before bidding begins (players can also remove themselves by sending a tell).
- /arp adjust [player] [points] - this allows you to adjust the current points of a player, when/if needed. Only usable by the master looter.
- /arp points - displays a list of the current points of all known players (alphabetical order)
- /arp reset - this resets the current bid you're handling, cancelling it and making yourself available for a new one (console command only, not in GUI).
- /arp reload - this clears the current loot assignment window, resets all bid handlers' current bid, and will re-load loot from the current (or next) corpse/chest opened. Only usable by the master looter.
- /arp scale [scale] - this sets the UI scale of the ARP windows (/arp alone will show you your current scale).
- /arp version - performs an ARP version check for everyone in the guild, displaying what version they're running.
Points management: In the Loot Assignment section of the GUI window, which only the master looter can bring up, there are a few items at the bottom right. One is the current "age" of the points data, in hours. If the current data is 15 hours or older, the master looter must either use the "Import EQDKP" button to import new data, or use the "Refresh Current" button to refresh the timestamp on the existing points data, and continue using it. Typically, you would refresh if EQDKP hasn't been updated since the previous night's raid, otherwise you would import the data from EQDKP. The format on the imported data is a line containing "BEGIN", followed by lines containing player names and point values, then "END". As items are won during the raid, players' points will be updated appropriately. Any manual adjustments needed can be done with the "/arp adjust" command.
Bid assigning: after a boss is killed, the master looter will open up the corpse (or chest), which will load in the items from that kill into the addon. Next, bring up the main window and loot assignment window (push the button to toggle it, you must be master looter). In the loot assignment window, you'll have the opportunity to assign each epic item present on the corpse to a particular bid handler (the bid handlers available will be detected via addon com, and limited to people in the raid). The name of the person handling each item will appear next to it as the items are assigned. Each person running ARP can be handling a bid for one item at a time. If a bid handler cancels his bid (via "/arp reset", reloading his UI, etc) his item must be manually unassigned (using the "Unassign" button) and then re-assigned. Any items remaining on the item list will be purged when you open the next new corpse/chest.
Bid handling: Players will add/remove themselves to the bid lists, and view the bid list, using the separate ARPC addon. The bid handler should push the "Last Call" button (or use "/arp lastcall") at some point to issue a "last call" warning. Later, the bid handler will push the "Start Bid" button (or use "/arp bid") to begin the bidding process. The bid handler can use the "Reminder" button (or use "/arp reminder") to remind the next bidder to put in his bid. After the last bid is in, the winner will be announced and the item/winner/cost information will be added to the "Loot Log" section of the main window.
After bidding/loot: After all items have been bid out, the master looter can then assign items to players based on the information in the Loot Log. The "Copy" button can be used to get a copy'able version of the log (which only contains purchased items, the DE'ed items are stripped out) so you can paste it into something outside WoW (eg: EQDKP). Afterwards, the "Clear" button may be used to clear the accumulated Loot Log. The Loot Log itself does get saved across logins, so if you forget to copy the data out, it should be there in not only your own Loot Log, but also the Loot Log of every other person in the raid who is running ARP.