About Grid

Grid is a modular, lightweight, and screen-estate saving grid of party/raid unit frames.

Read This

Due to its flexible design, Grid has a fairly daunting configuration menu. I suggest taking a few minutes to look through the configuration and familiarize yourself with the options available to you.

There's a very small User's Guide that needs some love but may be helpful in its current state.

How to report a bug

Before reporting a bug, check the bugtracker to see if the bug you were going to report has already been reported!

After verifying that your bug hasn't been reported (or resolved!), create a new ticket.

Please be sure to include the following information in the ticket:

• Grid version (ex: r16623 from wowace.com)
• WoW version and language (ex: 1.12 enUS)
• What you were doing when the bug occured
• What happened (ie. what the bug is)
• Any error messages if applicable (please use BugSack to get a full stack trace for the error message)
• A complete list of addons you have installed
• 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.

Each indicator can only show one status at a time. This is where the priority system comes into play. The highest priority in-range status will be displayed. Indicators are only updated when a status is gained or lost on the unit. Status setting changes only take effect when a new StatusGained event is sent.

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.

Credits

• Pastamancer: core, complete conversion to OO, modules
• Maia: initial concept, UI design, status modules
• Mikk: icon
• kaybe: german localization
• JoshBorke: API documentation
• Jerry: Pet support
• Julith: HealComm usage