Skip to main content

Groups Tool Reference

info

The Groups window can be opened from the World Editor via Tools menu → Groups.

The Groups tool provides a helpful tree view that displays all the groups currently available in your map/refmap. Switching maps will refresh the Groups tool and show you the list of groups available in that specific map. Within each group, you will see a list of entities that belong to it. Additionally, groups can be nested within other groups, allowing for a more organized and structured approach. It's important to note that group names must be unique, but sub-groups only need to be unique in relation to other sibling groups.

info

Entities can be assigned to as many or as few groups as desired. If an entity as been assigned to multiple groups, it will be listed accordingly in each group.

Group Properties​

Groups can be marked as ghosted and/or marked as hidden. These states are independent of each other, and can be toggled in any combination.

Each group listed in the window has buttons for toggling these states. The toolbar and the context menu also provide methods for adjusting these properties.

Ghosted groups​

Ghosting a group renders it unselectable, but still visible in the World Camera. Entities contained in ghosted groups will be drawn grayed-out.

Hidden groups​

Entities contained in groups that are marked as hidden will not be shown, and cannot be selected.

tip

If an entity belongs to multiple groups, only one of them needs to be marked as ghosted or hidden for the entity to be treated as such.

Managing Groups​

Groups can be managed via the Groups tool, or the World Editor's context menu.

Create a new group​

General new entity group procedure:

  1. Hold Shift and Left Click to select all of the entities you’d like to group.
  2. Right click to open the context menu. Go to Group → Add selected to → New group
  3. The Groups tool will open. Give the group a name. Hit Enter.

New groups can be created in several ways:

  • Right-click in any blank space of the Groups window and select New Group to create a new root-level group.
  • Click the New Group button in the toolbar without any entities highlighted to create a new root-level group.
  • Right-click on a selected group of entities and choose Group → Add Selected to → New Group to create a new root-level group.
  • Click the New Group button in the toolbar with a group highlighted to create a new sub-group.
  • Via the World Edit window's context menu's groups options.
info

Having trouble finding a group in your map?

Selecting a group in the Groups tool and then hitting Ctrl + Home in the 3D viewport, or Ctrl + Tab in the 2D view, will take you directly to that group.

Ungroup​

Remove entities from a group by:

  1. Delete the entire group (The group folder will be removed, but the entities will not.)
  2. Select an individual entity or multiple entities, then right click, and remove the group.

Add an entity to a group​

  1. Press Shift + Left Click to select the entity you’d like add to an existing group.
  2. Right Click to open the context menu. Go to Group → Add selected to → <your group>

Remove an entity from a group​

  1. Open the Groups tool. (You can find it by going to World Editor → Tools menu → Groups)
  2. Expand the group with the entity you’d like to remove.
  3. Select the entity (or entities) you’d like to remove from the list.
  4. Right Click to pull up the context menu. Select Remove from Group

Delete a group​

Groups can be deleted by highlighting them and pressing the Delete key, or by clicking the trash can icon on the toolbar.

Deleting a group will not delete the entities it contains.

warning

Deleting a ghosted group leaves the entities in that group ghosted (invisible).

These entities can be found in the No Groups group to unghost (show).

Ghost a group​

Ghosting a group renders the group unselectable while still being visible in the World Editor (in grey) and World Camera.

  1. Open the Groups tool. (You can find it by going to World Editor → Tools menu → Groups)
  2. Click the Ghost selected button next to the group you’d like to make unselectable. (Click it again to unghost the group.) The outline of these entities will turn grey in the 2D camera.
  3. Use the Ghost All and Unghost All buttons to toggle all groups.

Toggle the visibility of a group​

You may eventually have so many entities that they start to get in the way. Hiding an entity group will make it invisible and unselectable. This can help you remove some of the visual noise while working on a map.

  1. Open the Groups tool. (You can find it by going to World Editor → Tools menu → Groups)
  2. Click the eye button next to the group to toggle its visibility in the map.
    • You can also use the World Editor context menu by Right Clicking and selecting Groups.
      • Hide Group will let you select a group to hide
      • Show Group will let you select a hidden group to show

Select a group​

Groups and the entities contained in them can be selected or deselected by toggling the check-boxes next to their name.

Moving groups​

Groups and entities can be moved to other groups by highlighting them in the Groups window and selecting the Move To... context menu option.

Default Groups​

info

You must create default groups. There are no automatically-set default groups.

New entities are automatically added to all default groups.

  1. Go to the Groups tool.
  2. Left Click the group to highlight it in the list.
  3. Rt. click to bring up the context menu.
  4. Select Set as default.
info

Default groups are displayed with yellow text

Settings​

You can find settings relating to groups and the groups window on the toolbar, under the gear icon drop-down menu.

  • List Ungrouped Entities: If enabled, a category named No Groups at the top of the list of groups will be shown. All entities that have not been assigned any groups will be listed here. Note that this is not a group, but a method for viewing entities without groups.