RED Groups

Learning out to use groups in Red is essential if you want to become efficient in Red. Moving geometry (i.e. doors) cannot be created without knowing how to use groups.

There are 3 types of groups in RED - Master Groups, User-Defined Groups, and Moving Groups.

Group Rules

 * A brush and/or object can exist in more than one group.
 * Movers do not boolean with the rest of the world.
 * The center of a mover group must be in the world or it will not be created at game time.
 * Particle emitters cannot be attached to movers.
 * When a level is saved (or Auto-Saved), movers will also be put at their gold keyframe.
 * Groups that are loaded or duplicated groups are always placed at the same coordinates as the original group.
 * You can copy and paste User-Defined Groups.
 * You cannot copy and paste Mover Groups but you can "Duplicate" them.
 * If you try to load or duplicate a group in a level and a group with the same name already exists in that level, the editor can automatically rename the new group.
 * You should never groups with the same name. Every group should have a unique name.

Master Groups
Master Groups are pre-defined by Red. Every single thing you create in Red is automatically assigned to a specific Master Group. For example, you can use Master Groups to easily select all the brushes or all the lights in your level. Master groups are not as flexible as User-Defined groups but they have their place and can come in handy sometimes.

User-Defined Groups
A User-Defined Groups (or just a "group" as it is commonly referred to) is simply a user-defined collection of brushes and/or objects. User-Defined Groups allow you to efficiently manage the level design process and have quite a few benefits.

With User-Defined Groups, you can quickly and easily select whole sections of a level then move, rotate, unhide/unhide and export these sections. For example, hiding everything in the level but the area you want to work makes the editor run faster (since it doesn't have to render as much) and you can avoid accidentally moving or modifying other brushes or objects.

You can also save and load User-Defined Groups. Saving a group allows you take parts of a level for use in other levels. You simply save a group and reload it in a different level. This allows for consistency across levels (which is a necessity for level loads in single player levels) and saves you a lot time since you don't have to rebuild and retexture common things like doors, for example. You can also duplicate groups within a level.

When saving groups, you can save multiple groups at once. When saving multiple groups, you can save User-Defined Groups and/or Mover Groups. Saving multiple groups at once is easy. In Group Mode, you simply click on the "Save" button and this will bring up the Save Group dialog. Now select the groups (CTRL + Left Click) you want to save and click "OK". This will bring up the standard Windows Save dialog box. The name displayed the Save dialog pops up is always the name of the first group in the Save Groups dialog box. To keep things simple, use a different file name to when saving multiple groups. Once you have named the group, click "OK" to save the new group file.

Loading the group that contains multiple groups is easy. Create a new level and (in Group Mode) click "Load" and this will bring up the standard Windows load dialog box. Select the new group file we just created and click "OK" to load. This will load the 2 individual groups we saved in the multiple group file and that's it.

The editor allows you to easily create "temporary groups". A "temporary group" is just a group that editor automatically names "temp001", "temp002", etc. Temporary groups just make it a little quicker to create User-Defined Groups by automatically naming them incrementally. There is also a "Dissolve Temporary" button that will dissolve all groups named "tempXXX" (XXX being numbers).

Moving Groups
A Mover Group (or mover as it is more commonly referred to) is simply a User-Defined Group that physically moves between two or more keyframes (Translating Mover) or around a single keyframe (Rotating Mover). Movers can be used to make a wide variety of doors, hatches, lifts, trams, etc. Movers are created in Group Mode and use a keyframe system to specify how groups should move. Also, a mover can be made up of many objects and/or brushes.

Follow these steps to create a mover group:
 * 1) Create the brushes/objects you wish to turn into a mover.
 * 2) Place them where you want them to start moving from (the initial state). Texture the brushes as needed.
 * 3) Go into Group Mode and select the brushes/objects (even if it's just one brush or object) and create a user group for them.
 * 4) Find the user group you just created and select it.
 * 5) Hit the "Keyframe" button to turn this group into a Moving Group and create the master keyframe for it. The master keyframe shows the starting position for this mover and is shown as a gold key object.
 * 6) After you create a mover you can "animate" it by giving it more keyframes that tell the mover what to do and where to move to.

Keyframes

 * See Keyframes