Grid

Description

Grid is a compact and highly configurable party/raid unit frame addon. A 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.

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, please don't 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 use the WowAce bug tracker to report problems with Grid. If you don't have an account on WowAce (hint: if you have an account on Curse, you can use it to log into WowAce), you can post a comment here as a last resort.

Before reporting a bug, check the bug tracker to see if someone else has already reported it.

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:

1.30300.2009121801

• 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.
• Added a font outline option
• Added LibDataBroker-1.1 support
• Added CUSTOM_CLASS_COLORS support
• Added ConfigMode support
• Updated to LibHealComm-4.0
• Removed FuBarPlugin support
• Fixed the Filter Abolished Units option.
• Fixed the Ready Check status for WoW 3.3.
• 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.
• Added UTF-8 support. GridFrame counts characters properly when truncating names now.
• Increased maximum text length to 20.
• Health updates should be more responsive.
• Use the right addon communication channel in battlegrounds.
• Improved group placement, groups shouldn't end up stacked ontop of each other anymore.

r19919

• SpecialEvents-Auras got a major overhaul.
• update advanced frame options on profile change
• update Grid.inCombat on P_E_W.
• remove status cache for units leaving the raid/party
• added option to disable "Center Text 2" indicator (defaults to disabled for that classic Grid look).
• status modules ignore pets (perviously there could be confusion if a pet and a player had the same name).
• allow click-through of layout background when layout position is locked.

r18940

• Removed 1.12 compatibility code. Don't install this until after 2.0 is released!
• Added advanced frame options: corner size, font size, frame height, frame width, icon size, orientation.
• Added second text indicator.
• Tries harder to find the right texture for buffs/debuffs.
• Indicator list is now part of the frame class.
• Fixed bug where auras on invalid units were not being ignored.
• Fixed bug where range check would attempt to use spells that didn't have a range on the tooltip.
• Ignore statuses that can't be displayed on the chosen indicator. Turn on debugging for GridFrame to see ignored statuses.

r17574

• Ignore attempts to ad a (de)buff that already has settings.
• Added class filtering for auras.
• "show party in raid" now off by default.
• range check for status modules is disabled by default
• Moved text length option from GridStatusName to GridFrame.
• Cleaned-up/reorganized config menus.
• Added advanced layout options for layout and group anchors.
• Range for debuffs is 28 so 1.12 will use CheckInteractDistance()
• Don't use AceComm or Compost in 2.0
• Improved lua51/WoW 2.0 check.
• Set icon alpha only if we have a texture too.

r16685

• Why was 100 the max value for frame spacing? I do not know. 25 is a much better max value for it.
• Try harder to hide the center icon indicator properly.
• Check for loss of debuff type when a named debuff is lost.
• Added GridRange, a TBC/1.12 range checking module.
• GridFrame and GridStatusRange now use GridRange instead of ProximityLib.
• Updated deDE locale (thanks kaybe)
• Status modules now check their settings for an icon where appropriate.
• Added neXter's GridStatusRange module.
• Added 'frameAlpha' indicator.
• Show tooltips 'ooc' option shows tooltips for dead units while in combat.
• Added tooltips: "always", "never", "ooc".
• Give modules a db in OnInitialize().

r16209

• Added noha's GridStatusTarget module.
• Handle units going offline better. (thanks eternally777)
• Better defaults for alert_offline status.
• Reset bar color when resetting bar indicator.
• Added option to show Grid when in raid but not when grouped.
• Fixed bug where units would be targeted when using Clique.
• Fixed a problem where GridStatusName? tried to update a unit that didn't exist.

r15898

• Better support for switching profiles without reloading the UI.
• Status modules use self.core instead of the global GridStatus.