Almost every guild has one. They're that selfless person that has the thankless job of writing down all the loot people get from the raids and posting that info on your guild's website. Sure there's the pen and paper method, and there's no arguing that it works, but I'd like to think that in the 59 years since the Bic pen has been invented (and we won't even talk about how long paper's been around) that a better way has come along.
This addon is designed to be that better way. It automatically scans the chat log for when people receive loot, filters out the irrelevant, and allows you to select why that person got what they did. Once you've selected the reason, it logs that information to the chat log so that it can be copied/pasted out for use on your guild's website.
In it's current form, Spoils of War will only work when your group is set to use Master Looter, and filters out anything that (a) doesn't meet the loot threshold, and (b) is party loot. You won't be bothered by everybody in the raid looting their badges from the boss.
LibDataBroker
At the moment, you will need a LibDataBroker viewer to use this addon. Personally, I use Fortress, but you're welcome to use anything you'd like. This will give you the launcher widget that you can use to open the main window. In order to prevent a user from accidentally opening the window, it will not open if there is no loot queued.
Slash Commands
- /spoils add <Name> <ItemLink>
- Use this slash command to manually assign an item to a character. This is useful when you are too far away from the person receiving loot for the addon to pick it up automatically. It is important to note that <ItemLink> needs to be a clickable link, not just the item name typed out. This will also override all filters.
- /spoils marker <Marker Name>
- Use this clash command to add a marker in the log. You may want to place a marker between bosses or between raids, if you're doing more than one in a single night. Spaces are allowed in the marker name, and it does not need to be encapsulated in quotes.
Interface Options
- Verbose
- Displays extra information during certain actions, used mainly for debugging purposes.
- BBCode
- When logging an item in the chat, enabling this option will format the message with a BBCode link to wowhead.com.
- For example:
[url=http://www.wowhead.com/?item=40396][The Turning Tide][/url]
- Chat Channel
- The addon logs your information by turning on the chat log, ouputting a formatted message to a specified chat channel, and then turning the chat log off. Here is were you specify the channel you want to use. You may use any private, user-created channel, or "/raid". If you want to use "/raid" you must enter "RAID" in this field. The addon will not join the channel for you, you must join it yourself.
What do I do with it?
So now you've got this text file in your logs folder and you might be asking how to make this useful. The first thing to do is open this up with a text-editor. I personally prefer an application called Notepad++, but you can use whatever you want. You'll have a whole bunch of extra information in your chat log that you might not really care about (time stamp, date stamp, channel information, who's talking, etc) when you really just want the data. If your editor supports it, the easiest way to get the data is to hold down the alt key while selecting a box of text. I normally select all the stuff I don't care about (time, date, etc) and then delete it. All that's left is my data which I can then copy/paste into my guild forum.
------------------------------------------------------------------------
r21 | brimmstone | 2009-09-18 17:46:48 +0000 (Fri, 18 Sep 2009) | 1 line
Changed paths:
A /tags/0.4 Beta (from /trunk:20)
Tagging as 0.4 Beta
------------------------------------------------------------------------
r20 | Brimmstone | 2009-09-18 17:07:05 +0000 (Fri, 18 Sep 2009) | 1 line
Changed paths:
M /trunk/embeds.xml
Added AceTimer-3.0 to embeds.xml
------------------------------------------------------------------------
r18 | Brimmstone | 2009-08-20 00:54:39 +0000 (Thu, 20 Aug 2009) | 2 lines
Changed paths:
M /trunk/SpoilsOfWar.lua
M /trunk/SpoilsOfWar.toc
Added 'Emblem of Triumph' to party loot blacklist
TOC bump.
------------------------------------------------------------------------
r17 | Brimmstone | 2009-04-15 15:48:33 +0000 (Wed, 15 Apr 2009) | 1 line
Changed paths:
M /trunk/SpoilsOfWar.lua
Fix problem resetting window position.
------------------------------------------------------------------------
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...
