Description
AutoGroupFriends automatically groups you with anyone in your friend list when you or they sign on, automatically accepts group invitations from anyone in your friend list, and when forming such groups automatically sets looting to free-for-all.
Obviously this behavior isn't going to be desirable for everyone — it is intended for users who play mostly in the same groups all the time, or for special-purpose toons that will always be in the same group (i.e. arena teams). I'm guessing most other users would find this addon annoying; luckily they don't have to install it.
Original Addon
This addon is based on AutoInviteFriends from tcconway, but that addon was never updated for 3.1, so I branched and then eventually forked the project.
Usage
Sign on, or wait for your friends to do the same. Watch the magic. There's nothing else to it.
Slash Commands
AutoGroupFriends now supports several slash commands for in-game configuration. All slash commands can be called either as /agf or /autogroupfriends as is most convenient for your usage.
Loot
You can permanently (until changed again) set the loot method AutoGroupFriends will use with the slash command:
/agf loot loot_method
where loot_method is one of the following:
- freeforall
- group
- roundrobin
- needbeforegreed
Enable/Disable & Status
You can permanently (until toggled back) disable AutoGroupFriends with the slash command:
/agf disable
and re-enable it with:
/agf enable
or check the current status with:
/agf status
Roadmap
Coming Features:
- None. The possible features still sound like a good idea, but I'm not sure I'll get to them in the immediate future.
Possible Features:
(If I'm properly motivated to learn how to write a configuration UI, or can find some appropriate code to steal)
- Add a toggle to disable own-login-time invitations — it's only needed to deal with the case that only one friend is running AutoInviteFriends, and disabling this feature would remove one of the known bugs
- Provide an in-game method to specify exceptions to the friends list
- Make the exceptions list invertible, so that only listed friends are invited
Known Bugs
There are currently two know bugs:
- I think I've fixed the fail-to-accept-immediately-at-signon bug thanks to a suggestion from Necrosniper (though I've only tested it for a couple dozen logins, so I could be wrong). If you disagree please let me know.
- Invitations are sent to all your friends, even if they are already in another group. I can't find an appropriate API call to determine if a given character is in some group other than your own — if such a call exists let me know and I'd be happy to fix this bug. In the mean time your friends will just have to deal with a little spam-inviting when you log on.
Contact
If you have an interest in additional features, any bugs to report, or anything else to contribute let me know at: zach-curse@kotlarek.com
------------------------------------------------------------------------
r14 | profplump | 2009-08-19 14:12:16 +0000 (Wed, 19 Aug 2009) | 1 line
Changed paths:
A /tags/v1.0.4 (from /trunk:13)
Tagging as v1.0.4
------------------------------------------------------------------------
r13 | profplump | 2009-08-19 14:03:56 +0000 (Wed, 19 Aug 2009) | 24 lines
Changed paths:
M /trunk/AutoGroupFriends.lua
M /trunk/AutoGroupFriends.toc
Fairly major refactor -- a.k.a Zach learns LUA
- Figure out how to declare local functions to limit scope
- Refactor to split/join functions to match new architecture
Improve the design of delay/defer mechanism
- Do not do anything until our variables are loaded
- Restore deferred invitation acceptance
-- Thought about making it a queue instead of a single name
-- Decided the case where that is important is not reasonable for AGF
-- A fundamental assumption of AGF is that all your friends are in the same group
-- Hence there's no value in remembering more than one deferred invitation
Add support for different loot types:
-- freeforall
-- group
-- needbeforegreed
-- roundrobin
- Skipped master loot, as that requires more settings and seems an unlikely use case for AGF
- Loot type is set with /agf loot <type>
- Loot type is persistent
Improve slash-command system
- Muck about with what LUA calls "pattern matching" (oh how I miss ye, dear perl)
------------------------------------------------------------------------
r11 | profplump | 2009-08-17 08:04:40 +0000 (Mon, 17 Aug 2009) | 1 line
Changed paths:
M /trunk/AutoGroupFriends.lua
Delay 15 seconds; if your friends have faith this is a better plan anyway
------------------------------------------------------------------------
r10 | profplump | 2009-08-17 08:00:47 +0000 (Mon, 17 Aug 2009) | 1 line
Changed paths:
M /trunk/AutoGroupFriends.lua
M /trunk/AutoGroupFriends.toc
Bump delay to 10 seconds
------------------------------------------------------------------------
r8 | profplump | 2009-08-15 19:42:42 +0000 (Sat, 15 Aug 2009) | 1 line
Changed paths:
M /trunk/AutoGroupFriends.lua
M /trunk/AutoGroupFriends.toc
Install the version I actually tested, not some broken version that never invites anyone
------------------------------------------------------------------------
r6 | profplump | 2009-08-15 08:03:30 +0000 (Sat, 15 Aug 2009) | 1 line
Changed paths:
M /trunk/AutoGroupFriends.lua
Finish the delayed/cached modifications
------------------------------------------------------------------------
r5 | profplump | 2009-08-15 07:56:53 +0000 (Sat, 15 Aug 2009) | 1 line
Changed paths:
M /trunk/AutoGroupFriends.lua
M /trunk/AutoGroupFriends.toc
More delay mucking
------------------------------------------------------------------------
r4 | profplump | 2009-08-15 06:33:54 +0000 (Sat, 15 Aug 2009) | 1 line
Changed paths:
M /trunk/AutoGroupFriends.lua
M /trunk/AutoGroupFriends.toc
Try this stashed-list plan
------------------------------------------------------------------------
r2 | profplump | 2009-08-11 19:27:40 +0000 (Tue, 11 Aug 2009) | 1 line
Changed paths:
A /trunk/.pkgmeta
A /trunk/AutoGroupFriends.lua
A /trunk/AutoGroupFriends.toc
Initial import
------------------------------------------------------------------------
r1 | root | 2009-08-11 19:09:15 +0000 (Tue, 11 Aug 2009) | 1 line
Changed paths:
A /branches
A /tags
A /trunk
"autogroupfriends/mainline: Initial Import"
------------------------------------------------------------------------
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)...
