-------------------------------------------------
MIRAGE UI COMPILATION
(Previously known as the 'Insomniax Recompilation')
Version 2.3.03, January 24th, 2008
Created and maintained by Eduardo Lucero (LedMirage)
-------------------------------------------------

Thank you for downloading the Mirage UI Compilation, I sincerely hope you enjoy it as much as I have and that it makes your gaming experience a better one :)

The MUI compilation is intended to be as easy and simple to setup and as user friendly as possible, it compiles some of the best user interface modification for World of Warcraft and it has changed a lot since the first version I released back in December of 2004 however the quality, attention to detail and commitment to our online community remains the same.

While a I put a lot of work and time into maintaining and improving this compilation including some minor coding and artwork please do not forget that all the individual mods that make up the compilation come from many talented and different authors; for us mod authors credit for our work is more than often the only thing we will ever receive, please do not forget to give proper credit where it's due, taking credit for someone else's work is not only uncool and rude, it's demoralizing and will only be detrimental in the development of free add-ons.

A big thank you goes out to each and every contributor in the mod community and a special thanks to all the authors whose work has been a part of this compilation. Thanks guys!

P.S. Those of you who have helped with donations and kind words, you know who you are, THANKS!!!


-------------------------------------------------
USER AGREEMENT:
(Last revised 12/21/2006)
-------------------------------------------------
1. You agree to this agreement by downloading and using any and all files and intellectual property contained in this compilation.
2. You agree to NOT discredit any Author of their original work found in this compilation, be it code, graphics or intellectual property.
3. You agree to NOT hold any author responsible for any damage, data loss or any problems caused directly or indirectly by this compilation.
4. You agree to NOT use any material found in this compilation for monetary gain, as it is against Blizzard's EULA agreement and it is NOT your right to make money off of other Author's work.
5. You may redistribute any and all files contained in this compilation ONLY if they remain unmodified, this user agreement is included and remains unmodified and proper credit to any and all Authors is given.
6. You may modify and redistribute any and all files contained in this compilation ONLY with the expressed written consent of any and all respective Authors.
7. If you do not agree then delete any and all files included in this compilation as well as previous and future versions of it, by doing this you implicitly agree to NOT use any and all material found in this compilation for any purpose.
8. Original Authors of Modifications included in the compilation have the final say in how any and all of their work is to be used, redistributed and modified, and in so doing taking precedence over any and all of the previously defined agreements.


-------------------------------------------------
How to help (Donations and User Ratings)
-------------------------------------------------
Please download the mod and cast your vote on all you favorite websites to help in promoting the compilation. This compilation has been around since December 2004 but all statistics were reset after WoW version 2.0 was released, in addition the compilation went through a name change and I now host the file directly from my own website primarily. The result is ratings and numbers of downloads nowhere near indicative of its popularity - but clearly there's a LOT of you out there who continue to use it, so cast your vote and rate the mod would ya?

Any and all donations are particularly appreciated at this time since both my wife and me continue to find ourselves without a job and looking for ways to pay the next bill, to those of you who have kindly donated I have no words to express just how much help you have been, THANKS! :)

My personal Paypal account to which you can send any and all donations is:

LedMirage[AT]woh.rr.com

Thanks for your support!


-------------------------------------------------
INSTALLATION
-------------------------------------------------
A lot of time and effort is put into making sure the initial default settings are as tolerable and user friendly as possible, however only new users (or clean installations) would have noticed this; if you are an advanced user then use the Quick Installation method, otherwise you should use the Clean Installation method, both are explained below.

11/15/2007: IMPORTANT, all ACE dependant mods have been changed to not include external libraries, this drastically reduces loading time and the amount of files on your PC, however, you must absolutely make sure to completely empty up your ..InterfaceAddOns folder prior to extracting the files in the compilation to avoid complications.

9/29/2007: IMPORTANT, make sure to backup your ..World of WarcraftWTF folder, there were many significant changes in recent releases including the removal of MetaMap - to convert your existing map notes from MetaMap to Cartographer follow the step-by-step instructions under the Importing Map Notes section.

Clean Installation (Basic Users):

Use this method if you are new to mods and do not understand how mods work in World of Warcraft, this is the recommended procedure.
1. Exit the game

2. Delete all the contents of your ..World of WarcraftInterface folder

3. Make a Backup of your ..World of WarcraftWTF folder, you only need to do this if you want to have a backup of data from mods previously installed, for example Gatherer, Map Notes, etc.

4. Delete your ..World of WarcraftWTF folder

5. Delete your ..World of WarcraftCacheWDB folder

6. Launch the game without any mods installed and log into the game with one of your characters

7. Exit the game

8. Extract all the files from the Mirage UI compilation Zip file making sure to use folder names and point to your root World of Warcraft folder.

9. Launch the game

Quick Installation (Advanced Users):

Use this method if you have a good understanding of how mods work in World of Warcraft and can easily solve common mod conflict issues on your own.
1. Exit the game

2. Delete all the contents of your ..World of WarcraftInterface folder

3. Extract all the files from the Mirage UI compilation Zip file making sure to use folder names and point to your root World of Warcraft folder.

4. Launch the game



-------------------------------------------------
IMPORTING MAP NOTES
From MetaMap, CT_MapMod or Gatherer to Cartographer
-------------------------------------------------

1. Find the folder ..World of WarcraftWTFAccountYOUR-LOGIN-NAMESaved Variables

2. Once there find the file named MetaMap.lua and copy it (this also applies to Gatherer.lua and CT_MapMod.lua)

3. Find the folder ..World of WarcraftInterfaceAddonsCartographer_Import

4. Paste the file MetaMap.lua that you just copied inside the folder ..Cartographer_Import

5. Launch the game and open your the map and click on the cartographer button

6. From the Cartographer drop down list choose "Icon packs" and make sure that "Metamap Iconpack", "Gatherer Iconpack", CT_MapMod Iconpack" and "Enabled" are all checked.

7. Enjoy your MetaMap Notes in Cartographer!



-------------------------------------------------
List of Mods included with the Mirage UI compilation version 2.3.03
(Every mod in the list up to date as of 9:01pm EST 1/23/2008)
-------------------------------------------------
This is a simplified list of all the modifications included in the Mirage UI Recompilation; they are all up to date, tested, tweaked and in a lot of cases even have added functionality.

* ArkInventory
* Auctioneer Advanced (## DefaultState: Disabled)
* AutoBar (## DefaultState: Disabled)
* Bartender 3
* BigWigs (and many plugins for it)
* Bottom Scanner (## DefaultState: Disabled)
* Cartographer (and many plugins for it)
* ClearFont2 (MUI version)
* CT_Core, CT_MailMod
* cyCircled
* Damage Meters
* ElkBuffBars
* Enchantrix (## DefaultState: Disabled)
* EquipCompare
* ErrorMonster
* Examiner
* Fubar (and many plugins for it)
* FuTextures
* GFW_AdSpace
* GFW_DisenchantPredictor (## DefaultState: Disabled)
* GFW_Gemologist
* GFW_HuntersHelper
* GFW_ReagentCost
* HealBot (## DefaultState: Disabled)
* Informant
* LittleWiggs
* MirageUI_Core
* MirageUI_cyCircled
* MirageUI_XPBar
* MirageUI_SunnViewport_ArtPack
* MobInfo2
* MonkeyQuest
* Omen (## DefaultState: Disabled)
* OmniCC
* oRA2 (## DefaultState: Disabled)
* Outfitter
* Quartz
* QuestAnnouncer
* ScrollingCombatText, ScrollingCombatText - Damage
* Simple Minimap
* Skillet
* sRaidFrames (## DefaultState: Disabled)
* Sunn Viewport Art
* Swatter
* TipBuddy (by Aezay)
* TrinketMenu
* WoW Instant Messenger
* Xloot, XlootGroup, XlootMaster, XlootMonitor (## DefaultState: Disabled)
* X-Perl Unit Frames




-------------------------------------------------
Mirage UI Modifications Included
-------------------------------------------------
A few of the modifications are made by myself LedMirage, while some offer added functionality or visual themes they are all list here along with recent changes for your reference.

*Mirage UI CyCircled Themes. Current version is v20300.3, it adds custom themes for your buttons, to access the themes find the word "CyCircled" on your Fubar bar and right click on it, from the menu choose "Skins" and you will see the many MUI unique themes available.

*Mirage UI Experience Bar. Current version is v20300.3, it's a standalone experience bar, you can customize many features through the slash command /mxp (GUI coming soon!), /mxp border will show you a list of custom themes available.

*Mirage UI SunnViewport Art Pack. Current version is v20300.3, it adds many custom themes for the background image used on the SunnArt Viewport mod, to access them find the word "Sunn - Viewport Art" on your Fubar and right click on it, from the menu choose "Themes" and you will see the many MUI unique themes available.

*Mirage UI Core. Current version is 20300.1, among many other support files used throughout the compilation this mod adds 68 custom Status Bars that can be accessed by any ACE mod. Quartz, X-Perl and many other mods can choose from these unique textures through their configuration menus.


-------------------------------------------------
Essential Slash Commands:
-------------------------------------------------
These are commands that do not yet have a button to be easily accessed

1. /hb to configure HealBot
2. /mi2 to configure MobInfo2
3. /tip to configure TipBuddy (or press the gauntlet button found attached to the main options menu)
4. /sct to configure Scrolling Combat Text
5. /mxp to configure the Mirage UI XP Bar (You can change it's appearance)
6. /wim to configure WoW Instant Messenger
7. /omnicc to configure Omni Cooldown Count
8. /ex to configure Examiner
9. /quartz to configure Quartz (Casting Bars Mod)
10. /omnicc to configure OmniCC (Global Cooldown Mod)
11. /smm to configure SimpleMiniMap (MiniMap customization Mod)
12. MonkeyBuddy slash commands:

/monkeybuddydismiss or /mbdismiss
Sends the MonkeyBuddy icon away :(

/monkeybuddycall or /mbcall
Calls the MonkeyBuddy icon back :)




-------------------------------------------------
Known Issues and workarounds
-------------------------------------------------
If you have any problems not listed below it is highly recommended that do a clean installation of the compilation as indicated in the Installation section, if this does not resolve your issue please let us know in the forums at http://www.ledmirage.net/


* Player, Pet, Target, Party frames reset to a default position on the left side of the screen the first time the X-Perl configuration panel is launched, to fix this simply move the frames and close the configuration panel, it only occurs on the first time the configuration is opened and closed without moving the frames.

* Minimap distorted and configuration menu is inaccesible: To fix this issue type "/smm reset" if this doesn't work then exit the game and go to the ..WTFAccountLoginNameSaved Variables folder and delete all files named "SimpleMinimap.*"; To prevent this issue when the minimap is displayed properly, right click on it to bring up SimpleMinimap's menu and make sure to enable both the "Lock Minimap" and the "Lockdown Enabled" options.



-------------------------------------------------
Recent Changes
-------------------------------------------------
-------------------------------------------------
Version 2.3.03
-------------------------------------------------

*Added MonkeyQuest v2.7
*Added MonkeyBuddy v2.7

*Removed nQuestLog (Replaced by Monkey Quest)
*Removed Fubar_OmenFu (Redundant)

*Updated DamageMeters v5.8.1
*Updated Examiner v08.1.18

*Updated MirageUI_CyCircled to v20300.3
*Updated MirageUI_XPBar to v20300.3
*Updated MirageUI_SunnViewport_ArtPack to v20300.3

*Updated Outfitter to v4.0.1
*Updated WIM to v2.3.19
*Updated X-Perl to v2.3.9

*Updated all ACE addons to latest version as of 9:01pm EST 1/22/2008

* As always many tweaks all around!



-------------------------------------------------
Version 2.3.02
-------------------------------------------------

*Added CT_MailMod v3.01
*Added FishingAce
*Added Fubar_Omen
*Added EquipCompare v2.11

*Removed EQCompare (Mod Abandoned, replaced by Equip Compare)

*Updated Damage Meters to v5.7.1
*Updated Examiner to v7.11.24
*Updated Mirage UI Sunn Viewport Art Pack to v20300.2 (Some new themes and tweaks, 23 Original themes in all!)
*Updated Mirage UI cyCircled to v20300.2 (Fixed all button theme bugs, added 6 more original MUI button themes)
*Updated Mirage UI Core to v20300.1 (Added 68 MUI Original Art ACE compliant Bar Textures! You can use them in any ACE Mod!)
*Updated Mirage UI XP Bar to v20300.1 (Added new textures for the XP frame border, type /mxp border for more info!)
*Updated all ACE Addons to latest version as of 7:08pm 11/25/2007

* As always many tweaks all around!


-------------------------------------------------
Version 2.3.01
-------------------------------------------------

*Added CT_Core v2.004
*Added GFW ReagentCost v2.3
*Added MirageUI_cyCircled v20300.1
*Added Xloot, XlootGroup, XlootMaster, XlootMonitor
*Added X-Perl v2.3.8

*Removed AutoBar_Config (Obsolete)
*Removed GFW_TrackMenu (Obsolete)
*Removed CT_MailMod (Obsolete)
*Removed Fubar_ExperienceFu (Redundant)

*Updated Mirage UI Sunn Viewport Art Pack v20300.1 (Many new Background themes, enjoy!)
*Updated Examiner v7.11.12
*Updated OmniCC v2.0.7
*Updated GFW AdSpace v2.3
*Updated GFW DisenchantPredictor v2.3
*Updated GFW Gemologist v2.3
*Updated GFW HuntersHelper v2.3
*Updated WIM v2.2.28

*Updated all ACE Addons to latest version as of 7:13am 11/15/2007
*Changed all ACE Addons to not include external libraries, this drastically improves load times and that's what all those LibXYZ Mods are ;)


-------------------------------------------------
Read Me & FAQ:
-------------------------------------------------
You can find installation instructions, tips, a FAQ and instructions for most of the mods in this compilation in our forums at [url]http://ledmirage.net/forums/[/url]
Enjoy :-)

Patch notes for Mirage UI Compilation v2.3.03 (Insomniax)
=================================================
Known Issues and workarounds
=================================================
If you have any problems not listed below it is highly recommended that do a clean installation of the compilation as indicated in the Installation section, if this does not resolve your issue please let us know in the forums at http://www.ledmirage.net/

* Player, Pet, Target, Party frames reset to a default position on the left side of the screen the first time the X-Perl configuration panel is launched, to fix this simply move the frames and close the configuration panel, it only occurs on the first time the configuration is opened and closed without moving the frames.

* Minimap distorted and configuration menu is inaccesible: To fix this issue type "/smm reset" if this doesn't work then exit the game and go to the ..WTFAccountLoginNameSaved Variables folder and delete all files named "SimpleMinimap.*"; To prevent this issue when the minimap is displayed properly, right click on it to bring up SimpleMinimap's menu and make sure to enable both the "Lock Minimap" and the "Lockdown Enabled" options.

=================================================
Known Issues and workarounds
=================================================
If you have any problems not listed below it is highly recommended that do a clean installation of the compilation as indicated in the Installation section, if this does not resolve your issue please let us know in the forums at http://www.ledmirage.net/


· Minimap distorted and configuration menu is inaccesible: To fix this issue type "/smm reset" if this doesn't work then exit the game and go to the ..WTFAccountLoginNameSaved Variables folder and delete all files named "SimpleMinimap.*"; To prevent this issue when the minimap is displayed properly, right click on it to bring up SimpleMinimap's menu and make sure to enable both the "Lock Minimap" and the "Lockdown Enabled" options.

Mirage UI v2.2.01Insomniax), archived on 25/01/08