playtest-unity/playtest/Library/PackageCache/com.unity.visualscripting@1.8.0/Documentation~/vs-groups.md

Create node groups

You can organize the nodes in your Script Graphs and State Graphs with node groups.

Create a new group

To create a new group:

1. Open the graph where you want to create a new group.

2. In an empty area of the Graph Editor, Ctrl+click (macOS: Cmd+click) and drag to create a selection.

3. Release the mouse to create the group.

After you create a group, you can:

• Change the group name
• Add a comment to the group
• Change the color of the group
• Resize the group
• Move the group

Change a group name

To change the name of the group in your graph:

2. In the group header, click Group.

3. Enter a new name for the group.

4. Press Enter to save your changes.

Add a comment to a group

To add a comment to a group in a graph:

1. Select the group where you want to add a comment.

2. Open the Graph Inspector.

3. In the (Comment) field in the Graph Inspector, enter comments or information about the group.

[!NOTE] Group comments are only visible in the Graph Inspector. To add comments to a graph that are always visible, use a Sticky Note.

Change the color of a group

To change the color of a group in a graph:

1. Select the group you want to edit.

2. Open the Graph Inspector.

3. In the Graph Inspector, select the Color field.

4. Select a new color for your group through one of the following methods:

   • Use the color picker.
   • Use the sliders or RGBA value fields.
   • Enter a hexadecimal color value.
   • Select the eyedropper icon and select a color from anywhere on your screen.

Resize a group

To resize a group in a graph:

1. Click and drag from any edge or corner on the group.

Move a group

To move a group and its nodes:

1. Click and drag the group's header to a new location in the Graph Editor.

[!NOTE] You can also move a group without moving any of the nodes inside, but the required input changes based on your chosen control scheme. For more information, see Choose a control scheme

Next steps

After you've created a node group, you can add nodes to your Script Graph, create and add variables, or add a Subgraph.

You can also add a Sticky Note to add comments to a graph.