Need help?

• Use the ticket tracker to report a problem or suggest a feature.
• Use the forums to ask a question or post a comment.
• Do not send us private messages asking for help. We will not respond to such messages Use the above links to get help.

What is 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. Its aim is to display as much information as possible without overloading the user. It allows you to customize what information you see, and how that information is displayed.

Compared to many other similar addons, Grid at first appears quite minimal. This is intentional, as we chose to keep the Grid core limited to only the bare necessities and features useful for all classes and roles. Instead of packing tons of features into Grid itself, we've included a simple plugin API that makes it easy to add new features to Grid through plugins. Over 75 third-party plugins are already available.

Type "/grid" to open the configuration UI, or right-click the minimap button or DataBroker launcher.

Due to its flexible design, Grid has a fairly daunting options 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, and a forum thread for questions and discussion.

Design Overview

Grid is built on the concept of statuses and indicators. A status is a piece of information, such how much health someone has, or whether they have aggro. An indicator is a UI element that can display information, such as a health bar, an icon, or text. In Grid, you can show almost any status on almost any indicator, giving you total control over what information you see, and how it's shown.

For example, you could show incoming heals as a bar showing you visually how much healing is incoming, as text showing you a numeric representation of the healing amount, as a colored border around the frame, as a simple colored square, or even by changing the color of the whole frame.

Grid also uses a priority system, so you can assign more than one status to the same indicator. If more than one status is active at the same time, you'll only see the one with the higher priority.

For example, as a priest, you could assign both the Power Word: Shield buff and the Weakened Soul debuff to the same indicator, and give Power Word: Shield a higher priority. While someone is shielded, you'll only see the Shield buff (say, as a yellow border around the frame), but once the shield wears off, you'll see the Weakened Soul debuff on the same indicator (say, as a red border).

How to report a bug in Grid

Before reporting a bug, please:

1. Double-check that you have the latest Release or Beta version of Grid.
2. Disable all other addons, including all Grid plugins, and see if the problem still happens.
3. Enable "Display Lua Errors" under Interface Options > Help, or install an error-catching addon like BugSack.

Then, submit a bug report in the ticket tracker. Check for existing tickets about your bug first, and fill in as much of the requested information in the ticket template as you can. Finally, remember to check back on your ticket in case we need more information from you.

Please note that the Grid team cannot provide support for third-party plugins. If you are experiencing problems with a plugin, you will need to contact the plugin's author for help.

Frequently Asked Questions / Known Issues

Please do not submit tickets about these issues. We already know about them, and in some cases, they are not actually bugs.

Incoming heals are showing HoT ticks!

This is not a bug in Grid. The game client doesn't differentiate between incoming health from direct heals and incoming health from periodic effects, so Grid cannot specifically filter out HoTs. You can filter out most HoT ticks by using the Minimum Value setting for the Incoming Heals status to hide smaller amounts of healing.

Incoming heals are showing the wrong amount!

This is not a bug in Grid. Incoming heal values now come from the game client itself, instead of requiring everyone in your group to install a third-party library to communicate about their healing spells. Grid has no control over the accuracy of incoming heal values; feel free to report such issues to Blizzard.

If you don't see any incoming heals at all, check the Minimum Value setting for the Incoming Heals status, and make sure it's set appropriately for your level and gear.

Incoming heals aren't shown at all!

Check the Minimum Value setting for the Incoming Heals status, and make sure it's set appropriately for your level and gear. It should be set to a number that is lower than the size of a direct heal, but higher than the size of a HoT tick.

I'm using version r1234 and it's broken!

Version numbers that follow the "r1234" pattern are Alpha versions, or snapshots of the current development process, and are not recommended for general use. Such versions are not officially supported, may be unstable or not work at all, and may cause you to lose your settings. If you are not comfortable running experimental code, please stick with Release and Beta versions, whose numbers follow the "4.0.3.1234" or "4.0.3.1234-beta" patterns.

Localization

Grid is compatible with English, Deutsch, Español (EU), Español (AL), Français, Português (BR), Русский, 한국어, 简体中文, and 繁體中文.

Grid is translated into English, Deutsch, Español (EU), Español (AL), Français, Português (BR), Русский, 한국어, 简体中文, and 繁體中文.

To add or update translations for any language, please use the localization system on WowAce. New and updated translations will be automatically included in the next version of Grid!

Credits

• Maia: initial concept, UI design, status modules
• Pastamancer: core, complete conversion to OO, modules
• Phanx: maintenance and development since 2009
• Greltok: bugfixing
• Jerry: pet support
• jlam: advanced aura options
• JoshBorke: API documentation
• Julith: HealComm usage
• kaybe: German localization
• Mikk: icon