BugSack eases the process of capturing bugs. It captures information about Lua errors that occurred during your play session, including the full debug stack. It aims to be invaluable to developers, and a useful tool for players that use beta-quality addons.
BugSack includes a FuBar plugin that displays the last 5 errors in the tooltip. It can also bring up a frame to display all other errors for the current session, or for any other session. The text of the error can then be copied & pasted to a source outside of WoW (for example the forums) so that other developers can determine what's at fault.
!BugGrabber
The addon has a hard dependency on !BugGrabber, which is the addon that actually grabs the bugs. !BugGrabber is intentionally kept small, and it does not use any Ace2 libraries, to make sure that any errors in those libraries do not mess up the system.
Credits
BugSack and !BugGrabber has been hacked on by many people since it was started, including but not limited to: Fritti, Rowne, Ramble, kergoth, Industrial, ckknight, Gamefaq, thomasmo and damjau.
The current maintainer is Rabbit.
------------------------------------------------------------------------
r201 | rabbit | 2009-11-19 15:01:15 +0000 (Thu, 19 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
Remove some unused code.
------------------------------------------------------------------------
r200 | rabbit | 2009-11-19 14:40:38 +0000 (Thu, 19 Nov 2009) | 1 line
Changed paths:
M /trunk/.pkgmeta
M /trunk/BugSack.lua
M /trunk/BugSack.toc
Make AceComm/Serializer optional and remove AceAddon.
------------------------------------------------------------------------
r199 | rabbit | 2009-11-19 14:22:33 +0000 (Thu, 19 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
Delay frame creation until needed.
------------------------------------------------------------------------
r198 | rabbit | 2009-11-19 14:11:03 +0000 (Thu, 19 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.toc
A /trunk/Locales/frFR.lua
Added frFR locale from Balreign. Thanks\!
------------------------------------------------------------------------
r197 | rabbit | 2009-11-19 13:44:26 +0000 (Thu, 19 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
M /trunk/BugSackLDB.lua
Make the sack a UI panel so that we can easily close it with the Esc key. Not sure if this is a good idea or not, we'll see.
------------------------------------------------------------------------
r196 | rabbit | 2009-11-19 12:07:07 +0000 (Thu, 19 Nov 2009) | 1 line
Changed paths:
M /trunk/Locales/enUS.lua
Remove a unused locale entry.
------------------------------------------------------------------------
r195 | rabbit | 2009-11-19 12:06:40 +0000 (Thu, 19 Nov 2009) | 4 lines
Changed paths:
M /trunk/.pkgmeta
M /trunk/BugSack.lua
M /trunk/BugSackLDB.lua
M /trunk/Locales/enUS.lua
M /trunk/config.lua
* Make sure the LDB only displays session bugs.
* Update the english locale file, translations are welcome now.
* Don't stop the BugGrabber chat messages when bug grabbing is throttled, since the LDB no longer displays information about this.
------------------------------------------------------------------------
r194 | rabbit | 2009-11-19 11:28:56 +0000 (Thu, 19 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
M /trunk/BugSackLDB.lua
M /trunk/config.lua
Right-clicking the LDB opens options and clicking it hides the sack if it's already open.
------------------------------------------------------------------------
r193 | rabbit | 2009-11-19 11:26:01 +0000 (Thu, 19 Nov 2009) | 1 line
Changed paths:
M /trunk/config.lua
Starting to look decent.
------------------------------------------------------------------------
r192 | rabbit | 2009-11-19 11:15:11 +0000 (Thu, 19 Nov 2009) | 1 line
Changed paths:
M /trunk/config.lua
Expose the widget descriptions with tooltips.
------------------------------------------------------------------------
r191 | rabbit | 2009-11-19 01:31:29 +0000 (Thu, 19 Nov 2009) | 1 line
Changed paths:
M /trunk/.pkgmeta
M /trunk/BugSack.lua
M /trunk/BugSackLDB.lua
M /trunk/config.lua
Get rid of dewdrop - the new options look like crap at the moment, but they should work.
------------------------------------------------------------------------
r190 | rabbit | 2009-11-18 10:25:40 +0000 (Wed, 18 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.toc
A /trunk/config.lua
Started option panel work, not even half-finished, but time for work.
------------------------------------------------------------------------
r189 | rabbit | 2009-11-18 09:28:57 +0000 (Wed, 18 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
Add a 'Send errors' button to the sack and remove it from the dropdown.
------------------------------------------------------------------------
r188 | rabbit | 2009-11-18 09:03:06 +0000 (Wed, 18 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
Fix time display.
------------------------------------------------------------------------
r187 | rabbit | 2009-11-17 19:30:03 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
M /trunk/BugSackLDB.lua
New look for the sack.
------------------------------------------------------------------------
r186 | rabbit | 2009-11-17 14:16:04 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
Add in some xxx comments so I don't forget things later.
------------------------------------------------------------------------
r185 | StingerSoft | 2009-11-17 13:19:13 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/Locales/ruRU.lua
-- ruRU update (fix typos,rectification translation)
------------------------------------------------------------------------
r184 | sunmark | 2009-11-17 12:40:48 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/Locales/zhTW.lua
- zhTW update
------------------------------------------------------------------------
r183 | rabbit | 2009-11-17 10:45:24 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
Add a heading stating the current errors session ID and which number the error is in the set.
------------------------------------------------------------------------
r182 | rabbit | 2009-11-17 10:30:19 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
M /trunk/BugSackLDB.lua
There's just one action to open the sack now, I\'ll let the user navigate the sessions from the sack instead.
------------------------------------------------------------------------
r181 | rabbit | 2009-11-17 10:04:31 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
Received errors no longer exists, they are put into your current session with a .source set to the senders player name.
------------------------------------------------------------------------
r180 | rabbit | 2009-11-17 09:01:39 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
Some more minor cleanups.
------------------------------------------------------------------------
r179 | rabbit | 2009-11-17 05:42:44 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
M /trunk/BugSackLDB.lua
Add in a note about a new frame design and some ascii art.
------------------------------------------------------------------------
r178 | 7destiny | 2009-11-17 05:37:13 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/Locales/koKR.lua
koKR Update
------------------------------------------------------------------------
r177 | rabbit | 2009-11-17 05:32:45 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
M /trunk/BugSack.toc
M /trunk/BugSackLDB.lua
Fix the LDB.
------------------------------------------------------------------------
r176 | rabbit | 2009-11-17 05:21:54 +0000 (Tue, 17 Nov 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
D /trunk/BugSack.xml
Get rid of the old school XML UI. Hopefully I can clean up this mess soon.
------------------------------------------------------------------------
r175 | Zeksie | 2009-09-23 12:53:36 +0000 (Wed, 23 Sep 2009) | 1 line
Changed paths:
M /trunk/BugSack.lua
Now scrolls to top of errors instead of to bottom.
------------------------------------------------------------------------
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)...
