Grid is a compact and highly configurable party/raid unit frame addon. The compact grid of units lets you select a group member quickly, while retaining a good overview of the whole group. It displays as much information as possible without overloading the user. It allows you to customize what information you see, and how that information is displayed.
Grid includes status modules for health, mana, incoming heals, aggro/threat, buffs and debuffs, and range. It supports pets and vehicles. Each unit's frame is a health bar, with additional statuses overlaid on top. Information can be displayed using the center text, the center icon, the frame border, the frame opacity, or the colored square in each of the four corners.
Finally, Grid is written in a modular fashion that makes it easy for developers to add new status modules, new display indicators, or even completely new features.
Options are available from the minimap button or DataBroker launcher, or from the command line by typing /grid.
Due to its flexible design, Grid has a fairly daunting configuration menu. We recommend taking a few minutes to look through the configuration and familiarize yourself with the options available to you.
There is also a small User's Guide which you may find helpful.
If you downloaded Grid from wowace.com, or through the Curse Client, please do not post here. The WoWInterface releases are actually tested. Anything from wowace.com is bleeding-edge and may or may not work.
How to report a bug in Grid
Please DO NOT report errors or other problems caused by plugins here. Plugins are third-party addons, and the Grid team does not maintain them or provide support for them.
Before reporting a bug, please check the bug tracker to make sure it hasn’t already been reported.
Once you've verified that the bug hasn't been reported yet, submit a new ticket.
Be sure to include the following information in your ticket:
Grid version (ex: 1.30200.2009120101 from wowinterface.com)
WoW version (ex: 3.2.2 enUS)
What you were doing when the bug occured
What happened (ie. what the bug is)
Any error messages (enable Lua error display, or install BugSack)
A screenshot if it is a graphical bug
Design Overview
Grid is based on the concept of statuses and indicators. A status is a piece of information, such as a unit's health. An indicator is a part of the unit frame that can display information, such as the health bar.
More than one status can be assigned to one indicator, and one status can be assigned to more than one indicator. This is where the priority system comes into play. Each status is assigned a priority level. Each indicator will show the highest-priority status active at any given time.
For example: The Power Word: Shield and Weakened Soul statuses show you when those auras (buffs or debuffs) are active on a particular unit. If you assign both statuses to the Bottom Left Corner indicator, and give them priority levels of 90 and 80, respectively, then when you cast Power Word: Shield on a unit, you will only see the Power Word: Shield status, until the shield is absorbed or expires, at which time you will then see the Weakened Soul status until it ends.
Credits
Pastamancer: core, complete conversion to OO, modules
Maia: initial concept, UI design, status modules
Phanx: official maintainer
Mikk: icon
kaybe: german localization
JoshBorke: API documentation
Jerry: Pet support
Julith: HealComm usage
Change Log - Grid
1.30300.1304
Added dual spec support.
Added "By Class" layouts without pets.
The health bar background will now be colored correctly (instead of black) when "Invert Bar Color" is enabled but "Use class colors" is disabled on the Unit Health status.
The minimap icon will now be correctly shown or hidden when changing profiles.
Switching specs will no longer cause a momentary freeze.
Updated embedded libraries for WoW 3.3.5. (Note that this does NOT break compatibility with 3.3.3 or lower, so you can safely update Grid even if your locale hasn't patched yet.)
1.30300.1290
Upgraded to LibHealComm-4.0
Updated the By Class layouts to be more practical for modern raid sizes
Added default settings for Earth Shield
Fixed statusbar texture tiling in WoW 3.3.3
Fixed several minor bugs in the incoming heals status module
Fixed a bug that occasionally prevented available spell ranges from being detected on login
Removed global references for core modules – you will need to update your plugins to work with this release!
1.30300.1265
Fixed settings related to incoming heals not updating when changing profiles
Fixed range checking in esES/esMX locales
Changed versioning scheme, because Pasta's was too damn long!
1.30300.2009121801
Added default settings for Forbearance, Lifebloom, and Riptide
Added X-WoWI-ID field to TOC for WoWInterface's MMOUI Minion
Updated esES and esMX translations (Guiaswow @ CurseForge)
Updated TOC for WoW 3.3
1.30200.20090120101
The selected Battleground layout will now be used in outdoor PvP combat zones (eg. Wintergrasp).
The text of the Unit Health status now shows the unit's current health instead of the unit's missing health.
Fixed an issue causing performance degradation when group members are using addons which repeatedly change their character's title.
Fixed an issue causing range filtering on individual statuses to prevent those statuses from ever appearing.
Fixed an issue preventing debuffs with the same name as their type (eg. Poison) from triggering the appropriate Debuff Type status.
1.30100.2009041601
Fixed nil error in GridStatusAggro
Updated for 3.1
1.30000.2009021101
Separate layout presets for normal and heroic raids.
Mouseover highlight can now be disabled under Frame -> Advanced.
Adding a debuff by name will once again prevent it from triggering the associated debuff type status.
Added tooltip for drag tab.
Added option to hide drag tab when unlocked and revert to old dragging behavior.
By Group 5 layouts sort by index and *should* only show your party in a raid or bg.
Better handling of cross-realm units.
Code cleanups.
Misc. performance improvements.
1.30000.2009011501
Please update any status or layout addons you are using. Some of the important new features in this version are not backwards compatible.
Handles multiple units with the same name (Malygos drakes, hunter pets, etc.).
..... Vehicles in battlegrounds and raids are displayed as pets.
Separate layout options for solo, group, raid, battleground, and arenas.
Improved aura handling
..... Can show only buffs you've cast.
..... Can show duration for buffs and debuffs on the center icon indicator.
Improved aggro status: can now show threat levels like the default UI.
Added readycheck status.
Added drag handle when Grid is unlocked.
Disabled statuses properly unregister events so they do not consume cpu time.
1.30000.2008112401
Added esMX locale.
Updated RosterLib to teach it about vehicles.
No longer registers '/gr' as a slash command. Use '/grid' instead which has always worked.
Added Death Knights to the By Class layout (I forgot to add them to the By Class w/Pets layout, that'll be fixed in the next release).
1.30000.2008101802
Fixed bug when icon border size is set to 0
1.30000.2008101801
Updated Roster-2.1 to prevent errors in arenas.
1.30000.2008101601
New versioning scheme
Updated for WotLK
r66550
Improved incoming heal support via LibHealComm-3.0.
Improved range checking now allows for multiple ranges to be checked.
r60382
Added pet support (Sometimes pet frames will not have any information and will target an unknown unit. There's nothing we can do about it.)
Updated to LibBanzai-2.0
Misc bugfixes.
r50615
Updated for 2.2
Added voice chat status module from Halgrimm.
r24388
Updated for 2.0.3
Remove center text 2 indicator from the menu if it's disabled.
Updated to Roster-2.1 and Banzai-1.1. This will break any Grid addons that depended on Roster-2.0 and Banzai-1.0! It also improves performance, so it's worth it.
Use CastCommLib for communicating incoming heals.
Added status for Feign Death.
Layout now reloads when switching between solo/party/raid/battleground. This should fix raid groups not showing up occasionally.
Made range module more friendly to addon developers.
Probably the same "reason" the inspect and follow distances are "around" 11 and 28 yards. I'd imagine the development process at Blizzard went something like this:
Dev #1: Hey guys, I'm writing the range check function, should it be 35 yards or 40 yards? Other Devs: Uhh... I don't know. No idea. Good question. Dev #2: Let's roll a D6! Everyone Else: Okay! Dev #2 rolls a 3 (1-6). Dev #2: So, 35 + 3 = 38, sound good? Other Devs: Sure, whatever. Dev #1: Okay, cool. Dev #1 implements the range function with a 38-yard check.
UnitInRange isn't 40 yards; it's more like 38, and it's what's used by the default 38-yard range check. However, if your class has a friendly spell with a 40-yard range (such as a healing spell), that will be used instead, and you won't be given a choice between 38 and 40 yards. But, if you're on a class that doesn't have a 40-yard spell, it will fall back on UnitInRange and give you a 38-yard range check.
The range check module is "smart", in that you can enable the 38-yard check on your rogue, and the 40-yard check on your paladin, and when you're on your paladin, Grid will only check the 40-yard range, not both ranges.
Originally posted by Phanx It sounds like you may be better served by one of the auto-layout plugins. Or, you could write your own layout. Otherwise, setting the backdrop and border alpha to 0 is the intended method of hiding the background.
Thanks, I found a suitable plugin.
Another thing; any plans to add a range check that uses the 40 yard UnitInRange function, that any class could use? Or are you (or anyone else) aware of such a plugin?
__________________
Grab your sword and fight the Horde!
At this time there are no plans to add additional GUI options for configuring the background. You can change the backdrop by editing the appropriate SetBackdrop call in GridFrame.lua. If you need more detailed help, post a thread on the forums.
Is there a way to disable the background gradient? I'm currently deleting lines in the .lua's like a 3-year old playing minesweeper. A bit off idiot-proof GUI for this would be nice.
It sounds like you may be better served by one of the auto-layout plugins. Or, you could write your own layout. Otherwise, setting the backdrop and border alpha to 0 is the intended method of hiding the background.
Hi,
I recently decided to give this addon a try, but to be honest I find the whole layout system a bit annoying. I want to see all raid members, regardless of which raid difficulty is set. Do I have to set all layouts to 40 man? But I'd rather the backdrop didn't expand to fit a full 40 man raid. Can this be made auto adjusted? Or is there any way to hide it except setting background and border alpha to 0?
Thanks
__________________
Grab your sword and fight the Horde!
GridStatusRole is a third-party plugin, and is not maintained by the Grid team. Error messages or other problems relating to third-party plugins should be reported on the plugin's ticket tracker or download page; even if the plugin is maintained by someone who also helps maintain Grid, it is a separate addon, and any problems with it are totally separate from Grid itself.
Is gridstatusrole still maintained or is it maintained by someone outside of grid team? After 3.3.5 I've been having some problems with gridstatusrole. Sometimes a role color changes its opacity to 0%, for example all ranged unit frames go from bright blue to dark blue without any action from me. When trying to change the color with the color picker tool, I get a lua error:
"Message: Interface\AddOns\GridStatusRole\GridStatusRole.lua:80: attempt to index global 'GridStatus' (a nil value)
Time: 07/11/10 23:16:40
Count: 1
Stack: [C]: ?
Interface\AddOns\GridStatusRole\GridStatusRole.lua:80: in function <Interface\AddOns\GridStatusRole\GridStatusRole.lua:74>
Interface\AddOns\GridStatusRole\GridStatusRole.lua:119: in function <Interface\AddOns\GridStatusRole\GridStatusRole.lua:119>
...ace\AddOns\Grid\Libs\Waterfall-1.0\Waterfall-1.0.lua:2204: in function `func'
[string "*:OnColorSelect"]:3: in function <[string "*:OnColorSelect"]:1>
[C]: in function `SetColorRGB'
...ace\AddOns\Grid\Libs\Waterfall-1.0\Waterfall-1.0.lua:2218: in function <...ace\AddOns\Grid\Libs\Waterfall-1.0\Waterfall-1.0.lua:2178>
Locals:"
I have deleted the entire wtf folder and configured grid and gridstatusrole from scratch and I still get this error when trying to change the role color. Would it be possible to update Grid and Gridstatusrole to fit 3.3.5?
Or even integrate the role plugin to grid itself? Many healers appreciate to see tanks as red and melee as yellow etc.
Is there a way to show the Raid Icons on grid? Sometimes we'll slap raid icons on our tanks so we can see where they are during a fray. Is there a way to have those show on Grid?
No. The four characters in "+1.1" actually take up less space than the four characters that are normally shown in the exact same location for someone's name...