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.1.0 is Here!
Here is a quick rundown of what is in Lootster 3.0.0+:
Features
- JUST ADDED! Support for non-heroic/heroic loot of the same name.
- JUST ADDED! Support for the new 10-man and 25-man normal/heroic raids.
- 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.
WoW Call of the Crusade 3.2 Heroic Loot Naming
The WoW 3.2 patch introduced non-heroic and heroic loot with the same name. To support existing DKP systems (EQDKP, NDKP and Null DKP), I have chosen to differentiate the two types of loot with a " (H)" suffix on the item name of heroic items. This means that the item databases of those systems should use the same " (H)" suffix so that Lootster can correctly find and manage DKP settings and overrides for those heroic items.
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.1.3 - 10/15/09
- Fixed more boss wipe false positives
- Fixed bogus creation of a non-instance raid when entering an instance
- Fixed LUA error @ 3494 when engaging a boss in a dungeon type you are not tracking
Version 3.1.2 - 09/20/09
- Fixed LUA error on startup introduced into 3.1.1. Changes in 3.1.1:
- Fixed more new boss false positives
- Fixed more boss wipe false positives
- Fixed heroic dungeon/raid instance ID detection
- Fixed occasional startup error when using Roll Modified DKP
- Fixed roll usage not being shown when using Roll Modified DKP
- Fixed Bonus Award creation to pickup correct dungeon type values
- Fixed manually created non-boss related events internally marked as TBD
- Fixed manually created boss/non-boss events having incorrect attempt number
- Fixed re-running a previous raid not re-running a previous TBD boss attempt
- Fixed manually created/modified adjustments not correctly recording the entered DKP
- Added new Vault of Archavon boss
- Added all Trial of the Champion bosses
- Added all Trial of the Crusader bosses
- Added Manual Entry as an adjustment's usage type
- Added ability to manually create/modify adjustment DKP as earnt or spent
- Added option to use only the roll when comparing greed rolls in Simple and DKP rolling
- Added option to use player's earnt attendance DKP in player's total DKP for non-EPGP DKP modes
Version 3.1.1 - 09/20/09
- Fixed more new boss false positives
- Fixed more boss wipe false positives
- Fixed heroic dungeon/raid instance ID detection
- Fixed occasional startup error when using Roll Modified DKP
- Fixed roll usage not being shown when using Roll Modified DKP
- Fixed Bonus Award creation to pickup correct dungeon type values
- Fixed manually created non-boss related events internally marked as TBD
- Fixed manually created boss/non-boss events having incorrect attempt number
- Fixed re-running a previous raid not re-running a previous TBD boss attempt
- Fixed manually created/modified adjustments not correctly recording the entered DKP
- Added new Vault of Archavon boss
- Added all Trial of the Champion bosses
- Added all Trial of the Crusader bosses
- Added Manual Entry as an adjustment's usage type
- Added ability to manually create/modify adjustment DKP as earnt or spent
- Added option to use only the roll when comparing greed rolls in Simple and DKP rolling
- Added option to use player's earnt attendance DKP in player's total DKP for non-EPGP DKP modes
Version 3.1.0 - 08/04/09
- Fixed more new boss false positives
- Fixed more boss wipe false positives
- Fixed scheduler error causing LUA error when sometimes exiting an instance
- Added T9 tokens
- Added Emblem of Triumph to ignored loot
- Added raid type and boss type to the textual reports
- Added adjustment (loot) usage to the textual reports
- Added handling of non-heroic/heroic loot of the same name
- Added ability to echo all roll messages to Raid Warning channel
- Modified dungeon types to reflect new normal/heroic 10-man and 25-man raids
- Updated for the WoW Call of the Crusade 3.2.0 patch
Version 3.0.1 - 07/08/09
- Fixed class restrictions not being enforced when using single usage roll call in DKP mode
- Fixed LUA error @ 17939 in Simple 100/1000 rolling with a single class restriction
- Fixed LUA error @ 1903 when managing multiple timer scheduling for bonus time
- Fixed creation of spurious raids when sometimes entering an instance
- Fixed Simple 100/1000 rolling rejecting /roll 1000 greed rolls
- Fixed Simple 100/1000 rolling not sorting Need/Greed
- Changed rules text area to autofocus when Rules page is shown
- Changed class restricted usage roll call message to be clearer
- Updated various boss entries for better detection/less false positives
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)...
