Using the Switch Actor

Use the Switch Actor to quickly toggle visibility between mutually exclusive child Actors.

Windows
MacOS
Linux

The Switch Actor provides a quick way to toggle the visibility of Actors or entire hierarchies of Actors in your Level.

Only one child of the Switch Actor can be visible at any time. When you choose a child Actor that you want to be visible, the Switch Actor automatically hides all other child Actors, along with all their descendants. It then makes the one child Actor you chose visible, along with all of the descendants of that selected child Actor.

This behavior is most convenient when you have mutually exclusive Level Actors or hierarchies of Actors, where only one of those Actors or hierarchies should ever be visible at any given time. For example, a car configurator might offer several different trims, each of which is represented by a different set of Static Mesh Actors that have different geometry, as shown below:

Multiple mutually exclusive Actor hierarchies

To switch the visible model of the car from one trim option to another would require showing and hiding multiple Actors. You could do this using Blueprint, the Variant Manager, or even manually in the Unreal Editor. However, changing visibility on dozens or potentially hundreds of different Actors at the same time can be cumbersome. If you use a Switch Actor as the parent for all the different trim options, you can easily switch between the different trims by setting a single option on the Switch Actor parent.

The Switch Actor is contained in the Editor > Variant Manager Content Plugin. This Plugin is typically enabled by default. However, if you don't see the Switch Actor in your Modes panel, you may need to enable this Plugin for your project.

Adding the Switch Actor to a Level

The Switch Actor is listed in the All Classes tab of the Modes panel. Drag it from the Modes panel into your Level Viewport.

Add the Switch Actor to your Level

Selecting the Child Actor to Show

The following sections describe the different ways you can choose which child of the Switch Actor you want to show.

In the Unreal Editor

Select the Switch Actor in your World Outliner. In the Details panel, find the Switch Actor > Selected Option setting. This dropdown lists the names of all the child Actors parented by your Switch Actor.

Selected Option setting

Select the option that you want to be visible.

In Blueprint

The Switch Actor offers a Blueprint API that you can use to work with its selected child. If you drag right from a reference to a Switch Actor in a Blueprint graph, you'll find these nodes listed under the Switch Actor category:

Switch Actor Blueprint API

Node

Name

Description

Get Options

Get Options

Returns an array of references to all the child Actors currently parented by this Switch Actor.

Get Selected Option

Get Selected Option

Returns the index of the child Actor that is currently shown.

Select Option

Select Option

Changes the Switch Actor to select the child with the index you specify.

The array returned by Get Options is not guaranteed to be in the same order as the child Actors that you see in the World Outliner or in the Details panel for the Switch Actor. In addition, the index number that is returned by Get Selected Option and that you specify when you call Select Option both identify elements within this array.

In the Variant Manager

When you bind a Switch Actor to a Variant in the Variant Manager, capture its Selected Option property. The Values column shows a dropdown that lists the names of all the child Actors parented by your Switch Actor.

Select the option that you want to be visible when this Variant is switched on.

Select Skin
Light
Dark
언리얼 엔진 문서의 미래를 함께 만들어주세요! 더 나은 서비스를 제공할 수 있도록 문서 사용에 대한 피드백을 주세요.
설문조사에 참여해 주세요
건너뛰기

새로운 언리얼 엔진 4 문서 사이트에 오신 것을 환영합니다!

문서 사이트에 대한 의견을 모을 수 있는 피드백 시스템을 포함해서 여러가지 새로운 기능을 준비하고 있습니다. 아래 Documentation Feedback 포럼(영문) 또는 언리얼 엔진 네이버 공식 카페(한글) 중 편하신 곳에 의견이나 문제점을 알려 주세요.

새 시스템이 준비되면 알려 드리겠습니다.

네이버 카페
공식 포럼