About LunarSphere
LunarSphere is an all-class version of the popular "sphere" addons that exist for various classes within World of Warcraft. It's home, and more information, can be found at:
http://www.lunaraddons.com
When it comes to "sphere" addons, examples that come to mind are the following addons:
- Cryolysis (Mage)
- HolyHope (Paladin)
- Necrosis (Warlock)
- Sabella (Rogue)
- Serenity (Priest)
- Totemus (Shaman)
- Venantes (Hunter)
What separates this addon from the other sphere addons listed above is that every button is customizable. When you load up LunarSphere for the first time, you can load up a template for your specific class (Warriors, Druids, and now Death Knights have some sphere addon love) which will contain every spell that your character knows and attach it to the sphere (if you level up and learn new spells, you'll need to manually add them to the sphere, or, if you never changed your sphere layout, you can just reload the template again).
If you've never seen any of these addons, or need to know more about LunarSphere, here you go:
Features
Sphere
LunarSphere gives you a large sphere on the screen. Around said sphere, you will find 10 buttons that circle around it. These buttons, known as "main buttons," can take left, middle, and right click assignments to store spells, items, or macros. These buttons can also be turned into menu buttons, allowing an additional 12 buttons per menu button to exist, giving a total of 130 total buttons that you could possibly use, if you desire. The sphere can also function like a button, making the total up to 131 buttons.
Sphere Gauges/Display
The sphere provides up to two gauges (They look like rings or circular bars) that can display certain information such as health, mana, experience, rep, combo points, and more. You can also set text to be displayed on the middle section of the sphere, to also display your health, mana, rep, and more.
Buttons
The buttons can take actions that to assign them, but there are also special button types that you can assign the the button, such as "Use strongest water," "Use random epic flying mount," "Apply best Instant Poison to Main-hand" and more. Some can be seen as specific for certain classes, other button types can be used by all. Lots of "auto bar" type action assignments will happen within LunarSphere, if you assign such actions.
Reagent Restocking
LunarSphere can restock reagents from a custom list you define. Helpful for tailors who constantly need to restock on thread, or rogues you need poisons, hunters with ammo, priests with candles, and more.
Random Speeches
The random speeches that were trademark of most sphere addons? Yeah, LunarSphere can do that too. The addon comes pre-loaded with a few speeches for your mounts and for resurrecting people, but the sky is the limit since you can create your own speeches and assign them to items and spells that are used. Great for roleplayers, great for people who want to annoy their raid, or make them laugh.
Skinning
LunarSphere lets you skin the buttons with over 38 circular button skins and any color tinting you want to apply to them. LunarSphere was built to be customizable to fit most, if not all interfaces, no matter the color or design.
... and more
Tooltip handling and coloring, junk item selling, bank restocking, user interface object hiding (such as the action bar artwork, the main menu buttons, the mini-map zoom buttons, and more), and more can be handled by LunarSphere. If you want to use it as a full action bar replacement, you can hide all the action bars, assign the menu buttons and bag opening features to LunarSphere buttons, and clean up your screen.
Memory management
A lot of the extra bells and whistles of LunarSphere can be disabled so that it doesn't tie up lots of memory. In fact, with all features running, LunarSphere runs on about 850kb of memory and can replace between 3 and 10 addons, depending on the features used.
Longevity
Lastly, LunarSphere was made to last. When new drinks, food, potions, mounts, bandages and more are added to World of Warcraft, LunarSphere will usually pick up those new items without a version update. When new spells come out, you can just add them to your sphere just like dragging a spell from your spellbook to an action bar. That's some of the power and flexibility that LunarSphere provides, so that the only time you need to update LunarSphere will be for bells and whistle feature updates or bug fixes, but never so that you can finally use your new spell.
User Manual and various help that might be needed
I have a website setup for LunarSphere, as well as all my other project. It can be found at http://www.lunaraddons.com and with it there are FAQs, a User Manual, forums and more to help you out and to help me out, since responding to people from various sites is easier at one central location.
LunarSphere can be overwhelming at first. Lots of beta testers who helped with the project have said that after getting used to it, LunarSphere became really easy to setup and use, and they loved the power it provides.
Bug Reporting, Feature Requests, Comments and More
I would prefer comments on LunarSphere to be made on the LunarSphere website, but if you must, you can mention stuff here as well. I'll probably be a lot more open to things on the forums, though... =)
LunarSphere Public Release
Version 1.05 Changelog
Feature Additions
- Other Tab: Added the ability to hide the minimap under the "Hide UI" section.
- Other Tab: Added the ability to hide the new totem bar under the "Hide UI" section.
- Buttons: Added the ability add Equipment Manager sets to the buttons via a new button type called "Equip equipment set." You can assign sets by turning on Edit Button mode and either dragging a set icon onto a LS button, or, you can click a button to bring up the Button Settings window and select the new "Equip equipment set" button type in the Inventory category and drag the icon to the assignment box on the right side of the dropdown.
- Item Recognition: The healing and mana potion recognition code will now recognize the Super and Runic healing potion injectors. Yay.
Feature Changes
- Mount Recognition: With the new changes made in WOW 3.2, mount levels and speeds were adjusted to properly work with all of the "Use best mount" button types.
Bug Fixes
- Fixed an issue where the "Apply xxx Poison to Main/Off-hand" button types would not properly pick poisons that the player could actually use. Now, the item recognition code will make sure that the poison is of the right level of the player.
- Fixed an issue where the LS chat command "hide" would only hide the sphere, when it was meant to hide both the sphere and all the buttons. Now, it functions as it should.
- Fixed an issue where templates were not being loaded, saved, or viewed properly when the WOW 3.2 patch came out. Now, LS works again in regards to templates.
: : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :
LunarSphere Public Release
Version 1.04
Roronoa Zoro: Well, how about this. My "luck" versus this thing's "curse" ... wanna see what's stronger? If I lose, then I'm just that much of a man anyways...
Changelog:
Feature Additions
Feature Changes
Bug Fixes
- Fixed an issue where the randomized speeches within LunarSphere caused errors and broke LunarSphere, due to the randomseed() function being removed from Blizzard in the WOW 3.1 patch
: : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :
LunarSphere Public Release
Version 1.03
Monkey D. Luffy: I knew he was a hero ... he has a cape!
Changelog:
Feature Additions
Feature Changes
Bug Fixes
- Fixed an issue where LunarSphere and Docking Station didn't play well together
- Fixed an issue where LunarSphere and WOW 3.1 didn't play well together
: : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :
LunarSphere Public Release
Version 1.02
Changelog:
Feature Additions
Feature Changes
- Sphere Tab: The "Button Distance" setting has been modified so that it is more accurate to placing the buttons xxx pixels away from the sphere edges.
- Button Menus: Due to some changes in the WOW 3.0.8 patch API, timed menu closing and "on mouse out" closing of menu buttons in LunarSphere no longer works and will be fixed and working again when a new WOW patch is available. Blizzard is aware of this issue.
Bug Fixes
- Fixed an issue where any menu that would open outside of LunarSphere would cause an error due to the custom skinning LS applies on its own menus. This was due to some changes in the 3.0.8 patch on how WOW handles menus, which prevented LS from recognizing if the menu was opened from LS or not.
- Fixed an issue where moving the mouse over a submenu item in a dropdown menu found within the Button Settings window would cause an error. This was due to some changes in the 3.0.8 patch on how WOW handles menus..
- Fixed an issue where an error would occur while mousing away from any open menu that uses any sort of "auto-close on mouse out" or "timed delay menu closing" in the menu options. This was due to some changes in the 3.0.8 patch on how WOW handles secure button animation and will not be able to be fixed until a future WOW patch, therefore, both of these auto-closing methods will not work anymore, but will not cause an error anymore.
: : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :
LunarSphere Public Release
Version 1.01
Changelog:
Feature Additions
- Buttons Tab: New feature added called "Keep keybinds while swapping" which has been added to the "Button display options" section. If this is turned on, moving spells from one button to another will not transfer the keybind. Useful for those who like to swap around spells on their sphere into their "action bar" setup on LunarSphere with the 12 main keybinds.
- Buttons Tab: New feature added called "Always show pet button types when pet is out" which has been added to the "Button display options" section. This is on by default. When this option is on and "Edit Button" mode is off, all pet action button types within LunarSphere will always be visible while a pet it out, and will not be visible at all when a pet is not out. Turning this feature off will cause the pet action button types to show and hide like a normal LunarSphere button.
- Skin Tab: A new feature was added to the Sphere skinning section called "Use random sphere texture" which will pick a random sphere texture from the list and assign it to the sphere every time you reload your UI, log on, and of course, at the moment you turn on the option.
Feature Changes
- Sphere Tab: Setting the sphere scale will now only affect the sphere and not the sphere and the buttons. If you want to globally scale the buttons as well, use the "Global scale of buttons" feature to apply a scale to all buttons via the "Apply" button, or manually set each button's scale in its Button Settings window.
- Sphere Tab: The sphere scale can now be set to 3.0, up from 2.0.
- Buttons Tab: Added a scroll bar for the tab, allowing for more features to be represented, as well as allowing for some feature to have more room.
- Buttons Tab: "Global scale of buttons" feature has been modified. The "Apply" and "Reset" boxes have been removed, the scale can go up to 3.0, and the changes take effect as you slide the slider. Seems to be more intuitive this way.
- Buttons Tab: The "Force drag-and-drop assignment" feature now works with "click-to-drop" assignment as well. This means that you can pick up a spell/item/macro and just click a button with the left, middle, or right mouse button, while NOT in combat, to assign the action if this feature is turned on and the "Edit Button" is off. Before, you could only drag and drop, and only assign to the left mouse button.
- Buttons: Changed the code to allow for the highlighting of active aspects for Hunters and presences for Death Knights.
- Locale: Got rid of the "Google French" translation because it has been said to be horrible. Still waiting for translations of other languages when they are finished =)
- Item Recognition: "Noah's Special Brew" is now recognized as a healing potion for the Death Knights.
- Item Recognition: Changed the code to have a slight delay before checking for new mounts/pets when you learn a new companion, to help aid with some companions not being recognized immediately.
- Item Recognition: All "Rejuvenation Potion" items (Major Rejuvenation, Minor Rejuvenation, Powerful Rejuvenation, and Super Rejuvenation) and all "Alchemist Potion" items (Crazy Alchemist's Potion, Mad Alchemist's Potion) are now recognized as both health potions and mana potions and assigned to the proper strength settings within LS.
Bug Fixes
- Fixed an issue where the sphere text event for "Spell/Item Count" would not hide the text if a spell/item was dragged into the slot that has no count, whereas the original spell/item did, resulting in situations where, for example, "Prayer of Fortitude" would show a count, but if the spell was replaced with "Renew" the original count would still show.
- Fixed an issue where the sphere text event for "Spell/Item Cooldown" would not update properly if the user dragged a new spell/item to track, resulting in the previous spell/item, if any, still being shown for the cooldown tracking.
- Fixed an issue where sometimes, if the saved variables event doesn't fire properly, only part of the addon is loaded and crashed. Now, if the player login event happens before the saved variables event happens, LS will try to force it's way through the loading process. This is not the best idea I've had, but it will have to do for right now...
- Fixed an issue where mounts that would typically be "spell mounts" were not working well with the speech support. This was due to some code I added near the end of the beta testing that added rank support (mainly for polymorph spells) to the speech system... and it unfairly messed with the spell mounts as well.
- Fixed an issue where logging into the game while in a shape shift form would cause a loading error for some situations for druids and possibly other classes.
- Fixed a typo. "Vendor" is not spelled "Vender" ^.^
- Fixed an issue where the "Apply to weapon" button types (both the normal "apply to weapon" and the "apply poison to weapon" types) were not transferring the inventory targeting feature when being picked up as a "Use last submenu action" or "Use second to last submenu action" type.
- Fixed an issue where spell mounts and "small pet" companions that were saved to a template would not actually load properly when the template was loaded.
- Fixed an issue where the button types that did not rely on items (such as the "Open Backpack," "Apply to weapon," and "Random companion") would not load properly when when a template was loaded with these buttons types within it.
- Fixed an issue where the "Conjure Mana Gem" spells would not load properly if assigned to a template. The mage template handled it fine, just not custom-made templates.
- Fixed an issue where having submenu compression turned on and modifying the Button Distance, Button Spacing, or the Button Angle Offset in the Sphere tab, while "Edit Button" mode was off, would result in the submenu buttons no longer being compressed until "Edit Button" mode was turned on and then off.
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)...