This addon provides further control possibilities for any other Grid status. By now the following controls are available:
- show or hide status on key press (KeyGuard)
- show or hide status in or out of combat (CombatGuard)
- convert duration status (like aura duration) to min/max value status to be able to display remaining time of auras on bar indicators (like GridManaBars) (ToBarFilter)
- filter status for specific classes (ClassGuard)
- convert color of status to class color (ClassColorFilter)
- aura filter (can be used as debuff white list) (AuraGuard)
- convert value to text (like health) (ToTextFilter)
- threshold filter for values (ThresholdGuard)
How does it work
Like the name says, the addon works like a pipe, every pipe consists of four parts:
- indicator - status registered with the indicator of a pipe are used as input for the pipe
- guards - guards control if a pipe is open or not
- filters - filters change the values piped through the pipe
- status - the pipes status is the output of the pipe and can be registered with the actual destination indicator
So what you have is the following:
[status to control] -> [pipe indicator] -> [pipe status] -> ([guards] -> [filters]) -> [destination indicator]
How to use - a few examples
Generally you do the following steps to configure a pipe:
- Create pipe by entering its name under "Grid -> Control Pipes -> New Pipe". This will create a new status for the pipe under "Status" and a new indicator for it under "Frames".
- Set input of the pipe by registering the status to filter with the pipes indicator under "Grid -> Frames -> <pipe name>"
- Set the destination of the pipe by registering the pipes status with the destination indicator under "Grid -> Frames -> <destination indicator>"
- Configure the pipes Guards and Filters by adding new ones under "Grid -> Status -> <pipe name> -> <Filters/Guards>"
Some example configurations
"Shadow ward pipe" - As a priest I use GridStatusMissingBuffs to display missing buffs. But since Shadow ward isn't always needed I want to be able to easily toggling showing missing shadow wards on/off. To do this I pipe its state through a pipe which uses the KeyGuard. So I can toggling showing of missing shadow wards by pressing a key.
"Remaining Health pipe" - Most times health deficite is the only value I need to know for healing. But in some cases I need to know the remaining health of a unit to decide who needs special healing (during AoE for example). For this I pipe grids health status through a pipe with a "ToTextFilter" (to convert the health value to a text), a "ThresholdGuard" (to show remaining health only on half death people) and a "KeyGuard" (to toggle this on of).
"Debuff white list pipe" - Grid doesn't come with a whitelist for the debuff type status. To add this I pipe the debuff type status through a pipe with a "AuraGuard" where I can add the debuffs of this kind i don't need to see.
"Remaining hot duration pipe" - I use the mana bar of GridManaBars to show the remaining time of my hots on a unit by piping the "Aura Status" of the hot through a pipe with a "ToBarFilter". The destination of the pipe is the Mana bar indicator.
There are a lot more things you can use it for, just play around with it :).
If you need other guards or filters tell me, its pretty easy to add new ones.
Notes
- The reaction of the key depends on the duration you keep the key pressed. This means, if you keep the key pressed for more than 300ms the key will react as "while key is pressed", otherwise it will react like "toggle on key press".
- Please resist the urge to create loops with the pipes! I know its tempting but I didn't test what happens if you do so and I won't take responsibility if it caused the ending of the world! Seriously!
------------------------------------------------------------------------
r49 | julith | 2009-08-12 21:23:04 +0000 (Wed, 12 Aug 2009) | 1 line
Changed paths:
A /tags/v0.95 (from /trunk:48)
Tagging as v0.95
------------------------------------------------------------------------
r48 | julith | 2009-08-10 06:55:03 +0000 (Mon, 10 Aug 2009) | 3 lines
Changed paths:
M /trunk/GridStatusControlPipes.toc
M /trunk/PipeGuards.lua
GridStatusControlPipes:
- fixed not working aura whitelist
- updated toc
------------------------------------------------------------------------
r46 | julith | 2009-07-22 20:29:15 +0000 (Wed, 22 Jul 2009) | 2 lines
Changed paths:
M /trunk/GridPipe.lua
M /trunk/PipeGuards.lua
M /trunk/local-enUS.lua
GridStatusControlPipes:
- fixed options for Dewdrop
------------------------------------------------------------------------
r45 | julith | 2009-06-22 20:28:25 +0000 (Mon, 22 Jun 2009) | 3 lines
Changed paths:
M /trunk/GridStatusControlPipes.toc
M /trunk/PipeGuards.lua
M /trunk/local-enUS.lua
GridStatusControlPipes:
- added absolute threshold guard
- made threshold guards apply able to stacks and duration
------------------------------------------------------------------------
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)...