LFGVoyeur Refreshed
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 favourite 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 favourites (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.
It now also (optionally) monitors chat for LFG type messages and transmits all refreshed instance data to other users of LFG so that they can see instances that may be outside their current LFG range. This is handy when you want to check if there is anything going on for an alt.
PURPOSE:
A one stop shop for location players and groups for instances and raids.
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.
**All configuration is made through the standard WOW interface options screen**
KEY FEATURES:
Main Window
------------------
Favourites Tab
------------------
- Lists of all eligible instances and raids.
- Allows you to add those instances and raid to your favourites.
- Allows you to manage you favourites.
- Favourites persist between logins.
- Refresh individual instances or all favourites.
- 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 colours 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 colourized (Orange - active , Grey – inactive, Dark Grey not a favourite).
- Optionally use class colours 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)
- Management of Roles and display of single player roles. Single player/leader roles in tool tips.
------------------
Chat Tab
------------------
- Displays all detected messages (when enabled)
- looks for key words such as (LFG, LFM, LF1M, etc)
- Automatically adds all LFG channel discussions
- Messages coloured by how sure you can be that the sender is lloking for group (light is less sure)
- Click message to whisper sender
- matching messages can be announced. An audio effect is played and a highlighted message is placed in the default chat frame.
------------------
Server Tab
------------------
- when LFGV refresh an instance is publishes the data to all other LFGV addons on the server.
- Lists all instances that have been published alphabetically.
- Instance name tool tip indicates how long since the instance was last refreshed.
- Name links can be clicked to whisper the player.
------------------
About Tab
------------------
- Gives credit where it is due!
Whisper Window
------------------
- Clicking on the player link in the main/mini window will open the whisper window.
- move through the history of the last 5 messages sent using the tab key.
- invite a player to your group (with or without message)
- Supported macros in message text:-
+ #class – your class is inserted
+ #lvl – your level is inserted
+ #std - Places a standard message in the whisper (Includes all macros text available in whispers)
+ #health = Adds health points (xx HP)
+ #mana = Adds mana points to whisper (xx MP)
+ #epic = Add Epic and Superior links to the whisper
+ #role - adds list of roles to whisper.
Mini Window
------------------
- Emulates the original LFGV window
- Displays P for Party's and S for a single player.
- *new* optionally 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 favourites.
- 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 colours 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 accessible via the Fubar addon)
- Favourites refresh screen with progress bar.
- Integration with DOIKnowYou Scoring
- Integration with GearScore
Languages
----------------
- English
- German
---------------Translation/Localisation Credits------
* German - ClausAS
* French - ClausAS
* Spanish - Need Someone!!!
* Taiwanese - Need Someone!!!
* Chinese - Need Someone!!!
* Korean - Need Someone!!!
---------------Testing Credits------
* Lennara
* ClausAS
---------------Version 3.20------------
Version Credits:-
*ClausAS for Grman translation and bug testing
*Alaron for ideas for a number of the additions below
Changes
- [Changed] Auto join now works when window is closed. Auto join checks every 2 seconds
- [Changed] Now more event/timer driven, less code and less unnecessary refreshes.
- [Changed] Autojoin now only work when you are not in a raid/party.
- [Fixed] Corrected and added to the locale Functionality. Thanks to ClausAS for working with me.
- [Added] German and French localisations - thanks to ClausAS for working with me.
- [Fixed] Roles are applied whenever you join a queue (auto join of clicking on join) which should ensure the latest are set.
- [Added] Message announcement now also appears in the default message frame on screen.
- [Added] Added support for GearScores Add-on. If data is available:-
+ The player/leader tooltip will show their Gear Score and a color chart of raids they qualify for.
+ A new Gear button will appear on the whisper box, if you move hover the button it will show the unit tooltip if available. Clicking on the button will launch GearScores
- [Added] Selecting an instance to join will overwrite the zone instance if queued (used by auto join).
- [Added] Looking for group instances are remember when you join a group and will be joined after leaving the group if AutoJoin is enabled.
---------------Version 3.10------------
Changes
- [Changed] Changed layout of Roles Boxes to make clearer
- [New] Added framework for localisation of Add-on. **Need translators**
- [Changed] Various changes to English text as part of localisation.
---------------Version 3.08b------------
Fixed issue with Telepathy libraries.
---------------Version 3.08------------
Changes
- [Change] Updated supported version to 3.2
- [New] When other players refresh LFGV, the data is sent to all other LFGV users, this builds up a list of all instances on the server that have been queried. If there are enough players on the server using LFGV, you should be able to see groups/player looking for lower level dungeons.
- [New] Added "Tabs" for viewing either local lfg, detected messages or server lfg data.
- [New] Added wisper macro text support to LFG messaging too (e.g. #std LFG hero)
- [New] If LFG channel is not active and you attempt to advertise it will auto join the channel
- [New] Option to auto join LFG/LFM channel
- [New] Added options button to main window.
- [New] Detection for LFG messages in chat. These can be displayed in the main LFG windows (most recent 10) and/or highlighted in chat with an audio alert (click links to whisper).
- [Fixed] Whisper macro text for role was reporting DPS as healz and Healz as DPS.
- [Fixed] In some cases the LFG Channel number is not 4, added code to detect channel number
- [Fixed] "Your are saved for" changed to "You are saved for".
- [Fixed] "0" time saved instance displayed bug.
---------------Version 3.07------------
Changes
- [Fixed] Issue with displaying some save instance info. There is a name difference used by blizz. See change below
- [New] Display of Save Instances is now optional (configured through the options screen).
- [Change] Saved instance info is now in a separate section and coloured (time in main window, name in mini) according to time before reste (red> 2 hours, orange < 2 hours, yellow < 1 hour)
- [Change] Aligned Input boxes for Note and advertisement to look like whisper box.
- [Change] Added colour coding to active instance so that it is easier to separate Raids from Dungeons.
- [New] Added option to disable grouping (i.e. default groups active favourites, inactive favourites and then others).
- [Fixed] #lvl & #class now work in wispers
- [new] Added new wisper macros:-
+ #std - Places a standard message in the wisper (Includes all macros text available in wispers)
+ #health = Adds health points (xx HP)
+ #mana = Adds mana points to wisper (xx M)
+ #epic = Add Epic and Superior links to the wisper
+ #role - adds list of roles to wisper.
- [new] Added tooltip to wisper text box explaining macros.
- [new] Refresh window is now moveable.
---------------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)...
