Configuring whisperloot
Open the wishperloot.lua and configure these variables (if needed)
-- languages: DEFAULT_CHAT_FRAME.defaultLanguage (autodetection or Common, Darnassian, Dwarvish, Taurahe, Orcish, Gutterspeak, Demonic)
whisperloot_Language=DEFAULT_CHAT_FRAME.defaultLanguage;
-- Channel: "SAY", "WHISPER", "EMOTE", "CHANNEL", "PARTY", "GUILD", "YELL", "RAID"
whisperloot_Channel="RAID"
Using whisperloot
/wlconfig. Shows the configuration window for whisperloot (added in wl 0.5)
/wlstart <item>. Starts a bid for an item. It shows now (v0.5) a window with the current bid info. Commands are not longer needed.
/wlstop. Stops the bids, announces the winner. If autoupdate is on removes the dkps from the winner.
/wlcancel. Cancel the current bid, dkps are not taken and all is set to previous state. (added in wl 0.4)
/wlcurrent. Shows the current higher bid
/wlinfo. This help file
/wlmin <min>. Set min bid value
/wlmax <max>. Set max bid value
/wldkp on/off. Enables/disables the use of dkps from eqdkp
/wlsetuserdkps <user> <dkps>. Set the number of dkps for a certain user (added in wl 0.4)
/wlcheckuserdkps <user>. Returns the number of dkps from a certain user (added in wl 0.4)
/wlautoupdate on/off. Enables/disables autoupdate of dkps when a bid is finished
/wltake <value>. Set the min value to subtract if removedkps is enabled
/wltimer <time>. Set the bid duration in seconds
/wltimerbid <time>. Set the new timer after a bid in seconds
/wlsecretbids on/off. All announces are disabled
/wlsecondbidder on/off. Winner pays 2nd bidder + 1 dkps if this command is on (added in wl 0.4)
/wlallowtie yes/no/dkp. If the script allow a tie (added in wl 0.4)
/wlconfig
/wlstart
To start a bid just use "/wlstart <item>". To link the item use Shift + left mouse click. It will show the message "Bids for <Item> started. use /w <masterlooter> bid <bid value> to make your bids. To check your dkps use /w <masterlooter> checkdkps."
In v0.5 it shows also a window where you can see current max bidder, bid, time left, and item bidded. Also 2 buttons to stop or cancel de bid.
Users will need to whisper the mod owner with private messages following this format:
/w <masterlooter> bid <quantity>
for example
/w youpunk bid 50
Automatically youpunk will write a message in raid channel "New higher bid. <bid value> for <item>. Bid more if you want this item"
It will also send a private message from master looter to the bidder telling him that he is the new max bidder.
To finish the bids for an item (for example 20 secs after higher bid) just write
/wlstop
It will announce in raid channel the winner with this message: "<winner> wins <item> for <higher bid> dkps."
/wlcancel
It will cancel the current bid, no changes to dkps made.
/wlcurrent
It will announce in raid channel the current item and the current bid value.
/wlinfo
It will show the full list of commands
/wlmin <number>
Set the min bid possible, bids under this value will be ignored
/wlmax <number>
Set the max bid possible, bids over this value will be ignored
/wldkp on/off
When you enable this command, Whisperloot will check the saved variables database, checking if a user have enough dkps to bid. To generate this file you need to use the program eqdkp2wl.exe included in this package and that i coded too. Source code is included so you can check that it is not doing anything strange.
/wlsetuserdkps <user> <dkps>
Sets the ammount of dkps for a certain user, this command makes sense only if /wldkp is set to On.
/wlcheckuserdkps <user> <dkps>
Returns the ammount of dkps from a certain user, this command makes sense only if /wldkp is set to On.
/wlautoupdate on/off.
When this value is On, Whisperloot will automatically remove dkps from a user after the user wins the item. Just one small detail, if the bid was 20 but the take value (check above command) is 30, whisperloot will remove 30 dkps instead of 20.
/wltake <value>.
Set the min value to subtract if removedkps is enabled
/wltimer <time>
Set the bid duration in seconds. If it is 0, then timer is disabled and you need to stop it manually with /wlstop
/wltimerbid <time>
If there is a bid, this is at least the time allowed for new bids. For example, imagine that we have timer in 60 seconds and timerbid in 15, there is a bid 20 seconds after it started, so whisperloot shows a message telling that you have 40 seconds more to bid. 5 secs before the limit there is a new bid, then the time left is timerbid (15 seconds in our example).
/wlsecretbids on/off
Removes all echoing to raidchannel.
/wlsecondbidder on/off
If this param is On, when there is a whinner, whisperloot will take the dkps+1 from second bidder. If only one bidder (the winner) it will take what he/she bidded.
/wlallowtie yes/no/dkp
If this param is yes, whisperloot collects a list with all members that bidded the max.
If this param is no, whisperloot doesnt allow you to bid the current ammount of dkps.
If allowtie is dkp, the member with more dkps will win it, if more than one user, a list will be showed. (this param only makes sense if /wldkp is on)
On tie whisperloot will generate a random value and assign a winner
Eqdkp2Wl
As i said, this program, included in the addon too (tools directory), allows you to parse eqdkp standing pages (compatible with 1.2 and 1.3, probably previous eqdkps versions too), generating a .lua database that whisperloot will use. You can check the source code (also included) to see how it works and change it if you want. Btw, it uses ICS library coded by fpiette (http://www.overbyte.be/frame_index.html)
Steps to use the program:
1.- Write in URL field the url of your dkp standings page, for example http://www.myguild.com/dkps/listmembers.php
2.- Set the different fields , min value, max value, etc.
3.- Press Parse, it will download the html page and parse it.
4.- Save the file in <wow directory>\WTF\Account\<Yourlogin>\SavedVariables directory. Remember that you need to be in character selection screen if you are running wow or out of it.
You are now ready to use WhisperLoot with real dkps.
all credits go to the original maker of this addon Satanico
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)...
