FocusFrame -- Created by Tageshi
1. WHAT IS "FocusFrame"?
FocusFrame is very simple addon to show your focus.
The frame looks almost exactly same as Blizzard's TargetFrame;
It provide following features.
- Click to target your focus or your focus's target.
- Shows your focus's health and mana.
- Shows your focus's target.
- Shows cast bar of your focus.
- Supports Click-Casting such as Clique addon by utilizing ClickCastFrames.
- Movable by dragging the title tab.
- Supports MobHealth.
2. WHAT IS "focus"?
The "focus" is a new feature of WoW API 2.0.
Basically you can use "focus" as a second target.
It works in similar way as your real Target
and allows you to use DOUBLE targets at the same time. (essentially)
From API 2.0 Changes:
> * There is a new unit "focus" which behaves like target,
> the "PLAYER_FOCUS_CHANGED" event is fired when it is changed,
> and you receive unit events for this unit.
> * Spell casting and targetting (including focus) are only allowed
> using secure templates or special slash commands (not /script).
3. HOW TO USE "focus"?
You can set "focus" by using new standard Keybinding "Focus Target" or
by using new macro command "/focus" with target name or target id.
Another new standard keybindings "Target Focus" will change your target
to your focus. For example, you don't need to remember which mob is
your "sheep" to poly again.
Also you can use a keyword "focus" as a target id like "player",
"target", "party2", etc.
Example1: You can assist your focus by this macro.
/assist focus
You may want to focus your main tank/main assist if you will do DPS.
Or focus raid boss and 'assist' it if you are healing.
Example2: You can cast your Earth Shock on your focus by this macro.
/cast [target=focus] Earth Shock
You can watch spell casting bar on FocusFrame.
4. COMMANDS
FocusFrame has a few slash commands;
/focusframe scale <num> (Changes size of FocusFrame window.)
/focusframe reset (Reset window position.)
/focusframe lock (Prevent dragging the frame by accident.)
/focusframe unlock (Allows to move again.)
If your screen space is limited, try smaller window size:
/focusframe scale 0.7
When you accidently lost FocusFrame from your sight, reset it's
position and FocusFrame will appear again at the center of screen.
5. CHANGES
Version 2.3.6
TOC updated for WoW 2.4 .
Version 2.3.5
Fixed slash command "/focusframe hidewhendead" so that it respects Saved Variables.
Restored dependency on the standard Interface option "Show Enemy Cast Bar".
(which I removed hastily on version 2.3.4 .)
Version 2.3.4
Added slash command "/focusframe hidewhendead" to toggle the new function introduced on 2.3.3 .
Suports WoW patch 2.4 PTR.
Version 2.3.3
Added additional condition so that FocusFrame will be hidden only when focused target is dead AND is enemey.
Version 2.3.2
FocusFrame will be hide when focused target is dead.(Finally!)
Added warning message for when too big scale argument is passed for /focusframe scale command.
Added warning message for when user tried to change frame scale in combat.
Version 2.3.1
Fixed broken MobHealth support.
Version 2.3.0 (<num> -- which changes size of FocusFrame.
Version 1.1
Fixed broken initialization. FocusFrame window is now really displayed.
Version 1.0
First release. But initialization was broken.
Version 2.5.1
Now saves precise frame position in saved variables to fix
erroneous behavior of positioning and scaling while scale is not 1.
Version 2.5.0
Updated for WotLK 3.1.0
Copyed several new functions from Blizzard's TargetFrame.
Version 2.4.4
Bug fix: Debuff icons sometimes displayed target's debuffs instead of focus's.
Bug fix: Sometimes failed to show Castbar after loading.
Version 2.4.3
The last version 2.4.2 was broken;
It was not showing focus's name, debuffs, etc on the name bar.
Version 2.4.2
Fixed nil value error.
Version 2.4.1
Updated for WotLK beta 9061.
Now disables and replaces Blizzard's FocusFrame.
Version 2.4.0
Updated for WotLK beta.
Version 2.3.7
Added localization for zhCN and zhTW. (Thanks for Isler!)
Version 2.3.6
TOC updated for WoW 2.4 .
Version 2.3.5
Fixed slash command "/focusframe hidewhendead" so that it respects Saved Variables.
Restored dependency on the standard Interface option "Show Enemy Cast Bar".
(which I removed hastily on version 2.3.4 .)
Version 2.3.4
Added slash command "/focusframe hidewhendead" to toggle the new function introduced on 2.3.3 .
Suports WoW patch 2.4 PTR.
Version 2.3.3
Added additional condition so that FocusFrame will be hidden only when focused target is dead AND is enemey.
Version 2.3.2
FocusFrame will be hide when focused target is dead.(Finally!)
Added warning message for when too big scale argument is passed for /focusframe scale command.
Added warning message for when user tried to change frame scale in combat.
Version 2.3.1
Fixed broken MobHealth support.
Version 2.3.0 (<- Skipped 2.2.0 to avoid confusion)
Updated for WoW client version 2.3 .
Version 2.2.1 (<- oops, this is typo. This version is actuallly 2.1.1)
Fixed a potential nil error.
Version 2.1.0
Updated for WoW client version 2.2.0 .
Added slash commands /focusframe lock and /focusframe unlock.
Version 2.0.2
Fixed a bug; tooltip of buff/debuff icons were not correctly updated. (Thanks to Alestane)
Version 2.0.1
Fixed a nil concatenate error at line 852. (Thanks to JMHammer)
Version 2.0
Mimics new Target frame of WoW client 2.1 ;
Displays maximum 32 buff icons.
Displays buff/debuff timer.
Mobhealth support added.
Version 1.3
Added slash command /focusframe reset -- which reset window position to center of screen.
Supported silver dragon decoration for rare-elite mobs.
Version 1.2
Added slash command /focusframe scale <num> -- which changes size of FocusFrame.
Version 1.1
Fixed broken initialization. FocusFrame window is now really displayed.
Version 1.0
First release. But initialization was broken.
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)...
