Grid - WoW AddOns - WowAce.com

About Grid

Grid is a 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. It is also modular, making it easy to add new features.

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.

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.

How to report a bug in Grid

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 curse.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

Please check on your ticket daily. If a ticket is waiting on a response from you for more than 7 days, I will assume that you have fixed the problem yourself and have abandoned the ticket.

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 or aggro status. An indicator is a part of the unit frame that can display information, such as the health bar or a corner square.

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.

Each status consists of the following:

name: The internal name used by Grid to identify the status.
description: The name displayed in Grid's menus.
priority: A number from 0 (lowest) to 99 (highest).
range (optional): If specified, the status will only be shown if the unit is within range yards of the player.
color: A color (including alpha) to be used when the status is displayed.
text: A short message to be used when the status is displayed.
value (optional): If specified, value will be used to set the current value of a statusbar indicator.
maxValue (optional): If specified, maxValue will be used to set the maximum value of a statusbar indicator.
texture (optional): If specified, texture will be used to display an image.

The GridFrame module implements several indicators:

Center Text: Displays the text of the status using the color.
Border: Displays the color of the status as a 2px border around the unit frame.
Health Bar: Sets the value of the health bar based on value and maxValue. Sets the color based on the color.
Healing Bar: Sets the value of the healing bar based on value and maxValue.
Four Corners (top left, top right, bottom left, bottom right): Displays the color of the status as a small box in the corner of the unit frame.
Center Icon: Displays the texture of the status as an icon in the center of the unit frame.
Frame Alpha: Sets the alpha (fade) of the frame based on the alpha of the color.