LFGVoyeur Refreshed 3.05
INTRODUCTION:
This is based on the concept by Lenja
The add-on list all the instances (heroic and normal) and raids you are eligible for. You can create a list of favorite queues (dungeons, raid, etc) and refresh the list of groups/players with a single click. You can also the refresh button to refresh all you favorites (unfortunately required confirmation for each due to a Blizzard limitation).
I really like the original and just wanted a few enhancements, hence the “refreshed” version
PURPOSE:
Do you enjoy going into instances but searchING for groups A PAIN WIHT THE WOWO lfg SYSTEM o? Are you more like an opportunist who decides at a time of your own choosing if you want to join a group or not? This addon provides you with a full and abbreviated (mini) overview over all your favorite instances/raids in the LFG tool. With this, you no longer need to manually browse through each queue and then select groups or indivisuals.
OPTIONS:
The slash command for LFGVoyeur is "/lfgv". The following options exist:
show = Show main window
mini – Show Mini Window
[message] – Send a message (advertise) to both the zone and LFG channels.
E.g. "/lfgv show", "/lfgv lfm for a good raid" are both valid commands.
KEY FEATURES:
Main Window
------------------
- Lists of all eligible instances and raids.
- Allows you to add those instances and raid to your favorites.
- Allows you to manage you favorites.
- Favorites persist between logins.
- Refresh individual instances or all favorites.
- Displays an asterisk (*) against and individual or party that is/has a guild member in it.
- Lists all players/groups looking for groups/more. Displays roles for individuals.
- Display lockout times and status.
- Add yourself to the LFG channel without selecting an instance (uses the default zone).
- Class colors in tool tips
- Tool tips show members of groups or help.
- One-click to join [Join]/leave [Leave] LFG/LFM queue for an instance/raid.
- Raids./instance titles colorized (Orange - active , Grey – inactive, Dark Grey not a favourite).
- Optionally use class colors for single players.
- Control the Gamma of the window.
- Advertise yourself in the general and LFG chat channels (configure on screen of by command line)
- Mangement of Roles and display of single player roles. Singleplayer/leader roles in tooltips.
Whisper Window
------------------
- Clicking on the player link in the main/mini window will open the whisper window.
- *new* move through the history of the last 5 messages sent using the tab key.
- *new* Invite a player to your group (with or without message)
Mini Window
------------------
- Emulates the origonal LFGV window
- Displays P for Party's and S for a single player.
- *new* optionaly replace the "S" with the role if available.
- Displays an asterisk (*) against and individual or party that is/has a guild member in it.
- Lists all favorites.
- Refresh an individual or refresh all.
- Lists all players/groups looking for groups/more.
- Tool tips show members of groups
- One click advertise
- Optionally use class colors for single players.
- Control the Gamma of the window.
Key Bindings
------------------
- Key binding available for displaying the main window.
- Key binding available for sending a LFG message (advert).
- Please see attached images for instructions.
Other
------------------
- Integration with Fubar (left-click for main window, right-click for options an other show options).
- Configuration through the standard WOW interface menu (also accesible via the Fubar addon)
- Favourites refresh screen with progress bar.
- Integration with DOIKnowYou Scoring
----------------Future Features----------
- Multi Language
- recording of individual and leaders (where roles can be established) for a any time search feature (a bit like who) but shown all on-line and off-line and allowing you to search on roles.
- Integration with Karma to show player rating
- Replace text icons ([-], [+], etc) with graphics
- Right Click Menu
- Establish events for roles, note and LFG chnages to make timed screen refresh unnescessary.
---------------Version 3.05------------
Changes
- [New] Added option to display roles in place of "S" on mini window.
- [Change] Reformatted wisper window.
- [New] Added whisper message history (5 plus current), use TAB when in the message field to access.
- [Change] Send button no longer closes wisper window
- [Change] Cancel now renamed close and postion moved.
- [New] Added Invite button to whisper screen.
- [New] Added "Invite with Message" function to whisper screen. it is the same as pressing send & then invite.
**Thanks to Jackdeth and Lennara for testing**
---------------Version 3.02------------
Changes
- Added options dialog to WOW standard interface (also accessible through Fubar).
- Added Gamma controls in options for both wondows.
- Added option to turn on classcolours for individuals;
- [Bug] Fixed issue with dungeon lockout times appearing in both normal and heroic.
- Added FuBar support (accesses windows and options screen - Left click to show main window, right click to show menu)
- Replaced refresh dialog with a new dialog that stay in a constant position and displays progress.
---------------Version 3.01------------
Changes
- Fixed Error on Line 138, Initalisation will complete without error and level-up refresh will now work
- Speeded up refresh to 2 second to make more responsive to change.
- Changes around refresh of locked instances to ensure no innecessary commands back to server.
- Changed position of list build code and added to refresh button (should help those that are getting "Waiting for instance list...)
- Remove resulst count to make it clearer - (?) still appears when you have not refreshed a queue
- Added last refresh duration to instance name tooltip.
- Colour changes to top section to make it clearer
- Compressed group/player diaply test to reduce number of lines displayed.
- Fixed bug in roles setting code.
---------------Version 3.00------------
This is almost a complete rewrite. Blizzard have disable the ability to refresh all queues and the user has to request each queue update.
Functionailty
-Added - Concept of favourite queues. When you select/refresh a queue it is added to your favourites.
-Added - Favourites persist between logouts. It will assess you current favourites against available queues and adjust f some are no longer available (i.e. you have levelled).
-Added - Level Event - When you level your all queues are reset and reloaded to ensure any eligibility is picked up. Favourites are re-applied against the new list and updated.
-Added - Clicking on a queue name will add it to your favourites and/or refresh its list of payers and groups.
-Added - Ability to remove queues from you favourites.
-Added - Totals in queue to display (a ? means it has not been refreshed).
-Changed - The mini screen only displays your favourites. These can be managed form the main screen.
-Changed - Refresh now refreshes favourites only. A confirmation box is displayed for each favourite (its the only way to get around the new Blizzard limitation);
-Changed - I have standardised the colouring in the main and mini windows. Class colours now only appear in the tool tips.
-Removed - Filter options for inactive, Normal, Raid and Heroic. Favourites allow you to pick just the instances you want so no need for filters.
From Pre-release 2.7x versions:-
BUGS/Fixes
- LFGVoyeur.lua : Fixed random concat string error on line 264, 274, 280,284
- Corrected group tooltip display error that hid LFG/LFM comment.
Functionality
- Added support for joining channel without adding instance (uses default zone)
- Added support for raid/heroic lockouts (saves) and resets - If you are locked, it will be shown in red and the time to reset will be shown on the mini it shows a red (L). Time refreshed Approx every 2 mins when window shown.
- Added Advertising Mode - You can set-up a standard advert for groups/players and send it using the Hyperlink or bound key to the zone and lfm/lfg channels. Use #I in message to insert instance names. Also use /LFGV [message] to create and post message to channels
- Added Bind key for Advertising so that once the message is configured it is a one press send (please do not spam - if there are complaints about the add-on and spamming I will added a time delay so that it can only send a message every 5 minutes).
- Added Clear function to clear all LFG/LFM assignments
- Changed Font sizes to make smaller and clearer
- Added error message to chat when you try to add to LFM and you are not the leader.
- Added optional support for DoIKnowYou ratings display.
- Changed Settings Storage Method to make it easier for later updates
- Settings now being saved per character and not by account as was previously configured
- LFG Note is now persistent for character.
- Last LFG Advert Message is now persistent.
- Added support for roles
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)...
