Synopsis
Lootster is a loot rolling interface that allows you to call for and capture loot roll, arbitrate ties and announce winner(s). In addition to managing simple rolls, it also manges various DKP styles, including the ability to automatically record points credited for attendance and debited for loot. For more information see the FAQ that is at the end of readme.htm in the Lootster download.
Lootster 3.0.0 is Here!
After a long period of development, the new version is here. Here is a quick rundown of what is in this version:
Features
- NEW! Support for EPGP loot system. Requires upgrade of the EQDKP/NDKP Export Plugins (3.0.0.0).
- NEW! Support for 'usage rolls', such as main-spec, off-spec, bank shard, etc.
- NEW! Support for configurable usage roll loot costings, including a separate Alt factor.
- NEW! Support for events, such as raid start, boss wipe, bonus time, etc.
- NEW! Support for configurable event point awards for 10-man and 25-man raids for full, partial and standby attendance.
- NEW! Support for automatic loot point calculations based on the Allakhazam formula, including handling of all armor tokens.
- NEW! Support for configurable loot point calculation factors for the Allakhazam formula.
- NEW! Support for 'standby' attendance handling, allowing players outside the raid to whisper standby status.
- NEW! Support for detecting all bosses.
- IMPROVED! Streamlined bookkeeping of loot wins with the correctly costed points depending on usage roll and Alt status.
- IMPROVED! Better detection and separation of instance types, being dungeon, heroic dungeon, raid and heroic raid.
- IMPROVED! Expanded viewing of individual player attendances and adjustments, and easy 'goto' ability to see the initiating raid and boss for the attendance/adjustment.
- Various simple roll capture modes.
- Various point system roll capture modes.
- Automatically record raids, bosses, attendances and loot wins.
- Ability to easily set and/or override item points.
- Ability to easily set your own class restrictions on items.
- Ability to define membership (Full/Trial/Applicant) and toon types (Main/Alt) using the guild ranks and guild public notes.
- Ability to sort player rolls by item usage, membership and toon type, in addition to the inherent point system priorities.
- Ability to track the points for Alt(s) on behalf of a Main.
- Ability to passively 'snoop' rolls and winners, in addition to passively recording raids, bosses, attendances and loot wins, providing 'fail safe' point management.
- Ability to synchronise raid data, item data and restriction data with other Lootsters.
- Numerous option settings to control what the addon does and what it records.
- Numerous option settings to control the various loot systems.
There are important caveats with the use of Lootster 3.0.0 only if you want to revert back to the previous version of Lootster 2.x.x:
- The data structures have changed significantly in Lootster 3.0.0 from those in Lootster 2.x.x. Lootster 3.0.0 will not be able to snoop roll calls or synchronise data from Lootster 2.x.x, and visa versa;
- The data structures have changed significantly in Lootster 3.0.0 from those in Lootster 2.x.x. Lootster 3.0.0 will upgrade all saved data structures when loading the addon for the first time. However, once those data structures are upgraded, Lootster 2.x.x will not work. Follow these backup and restore instructions depending on paranoia:
- Before installing Lootster 3.0.0 for the first time, make a copy of the
Lootster.lua file found in the <WoW Directory>\WTF\Account\<account>\SavedVariables directory, calling it Lootster-2.lua;
- Install Lootster 3.0.0, and start WoW. There will now be two versions of your Lootster saved variable file, being
Lootster.lua for 3.0.0, and Lootster-2.lua for Lootster 2.x.x;
- To install Lootster 2.x.x again, rename the Lootster 3.0.0
Lootster.lua to Lootster-3.lua. Then rename the Lootster-2.lua file to Lootster.lua;
- To install Lootster 3.0.0 again, rename the Lootster 2.x.x
Lootster.lua file to Lootster-2.lua. Then rename the Lootster-3.lua file to Lootster.lua;
- If you wish to use an updated saved variable file from Lootster 2.x.x in Lootster 3.0.0, start at step one again. Note you will need to delete the existing
Lootster-3.lua file.
Bug Reporting
Please use a good error catcher like Bugsack (requires !BugGrabber), and provide the entire error text with as much information on how to recreate the problem. Report the problem via the CurseForge ticket system to ease tracking.
Slash Commands
- /ls - toggle display of Lootster window
- /ls resetui - reset the position of all Lootster windows
Language Support
Although basic roll capture will work in French and German, the additional abilities (loot capture) will not. If you would like to contribute a translation for this addon, let me know via private message on this site. You will be given credit for the translation.
Installation
Unzip into <WoW Directory>\Interface\Addons.
User Interface
The user interface is used to perform all functions, and call be toggled (shown/hidden) through three methods:
- Using the command line via the
/lootster or /ls command;
- Using the minimap button that can be used to toggle the user interface;
- Using the small Lootster frame that can be used to toggle the user interface.
To reset the various frame positions if they are dragged offscreen, use the command line /ls resetui to reset their positions.
The user interface can be moved anywhere on the screen via dragging the Lootster box. If the minimap button is not used, then the small frame will be shown, and visa versa.
Recent Version History
Version 3.0.0 - 06/27/09
- Fixed sub-boss kills not being correctly counted to determine a boss kill
- Fixed Sartharion drakes not being ignored when determining boss name
- Fixed some instances not being detected when entered
- Fixed boss not being marked as a wipe on zone in
- Fixed multi-boss kills not being detected
- Released
Version 3.0.Beta4 - 06/18/09
- Fixed dying during a successful boss kill causes boss attempt to be marked as a wipe
- Fixed LUA error when using calculated item points and attempting to add an override points for an item
- Fixed item synchronisation duplicating entries
- Fixed item synchronisation update common item checkbox not being reenabled after a synchronise
- Fixed loot synchronisation update common item checkbox not being reenabled after a synchronise
- Fixed roll usage pulldown resetting when roll page is reshown
- Fixed usage buttons being visible in simple rolling mode
- Fixed fake boss detection test values
- Added more missing bosses (Ulduar)
Version 3.0.Beta3 - 06/02/09
- Fixed game disconnect... again. This time I won't tweak working code before committing it
- Fixed some boss attempt mis-numbering
- Fixed some boss lookups
- Fixed some fake boss detection
- Fixed report selection tooltip
- Fixed report selection and refresh handling
- Fixed CTRT XML Import Format report not initially highlighting report text
- Fixed text report not showing adjustments in DKP mode that is not EPGP
Version 3.0.Beta2 - 05/29/09
- Fixed LUA error when annoucing a win and player adjustment whisper is enabled
- Fixed game disconnect when calling for a roll when active in DKP mode
- Fixed boss attempts sometimes not updated to a boss wipe
- Fixed transmission of roll call information
- Fixed formatting of DKP whisper to player
- Fixed sorting of raids in full report
- Changed raid report user interface to support multiple report formats
- Added CTRT XML Import Format as a report format (CTRT 1.16.13 for EQDKP 1.32+)
Version 3.0.Beta1 - 05/26/09
- Ability to utilise Effort Points/Gear Points (EPGP) rolling which calculates winners by calculating EP/GP=Priority Ratio
- Ability to utilise 'formulaic' item cost (DKP or GP), including the handling for armour tokens
- Ability to track boss attempts, kills and wipes
- Ability to track Standby attendance via whispers
- Ability to announce new raids/bosses to party/raid/guild/custom channel
- Ability to call for usage rolls and to book point costs appropriately (Main-Spec, Off-Spec, Alts)
- Ability to have events with their own 10-man/25-man points value booked automatically (raid start, boss wipe, etc)
- Ability to recognise all bosses
- Ability to call for rolls on raid warning channel
- Ability to detect badge loot to prevent booking
- Changed boss and item checks to be language neutral
NOTE: The data structures have changed significantly in Lootster 3.0.0 from those in Lootster 2.x.x. Lootster 3.0.0 will not be able to snoop roll calls or synchronise data from Lootster 2.x.x, and visa versa.
NOTE: The data structures have changed significantly in Lootster 3.0.0 from those in Lootster 2.x.x. Lootster 3.0.0 will upgrade all saved data structures when loading the addon for the first time. However, once those data structures are upgraded, Lootster 2.x.x will not work. If you are unsure about what version you want to use, make a copy of the Lootster.lua file found in the <WoW Directory>\WTF\Account\<account>\SavedVariables directory.
Complete Version History
See the version history document in the Lootster download for a complete version history of Lootster.
Known Issues
Boss detection on complex/multi-boss fights might be incomplete. Think Sartharion+Drakes, The Four Horseman or Assembly of Iron. There may also be misentered boss details. Please report these so they can be corrected.
Future Versions
No updates are planned at this time.
License
Lootster 3.x.x+ by Mackenz is licensed under a Creative Commons Attribution-Noncommercial-No Derivative Works 3.0 United States License.
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)...
