Triggering Sequences from Gameplay

Illustrates how to trigger a Sequence from an in-game event.

Choose your operating system:

Windows

macOS

Linux

Once you have created your cinematic sequence, you may want to have it called and played during gameplay as part of a cutscene. For example, maybe the player walks into a room and you want to have the camera zoom in on an object. Or perhaps you want to trigger an ending cinematic after the player kills an enemy. By getting a reference to your Level Sequence, you can use Blueprint or C++ code to tell your sequence to start playing.

In this How-to, we create a sample cinematic that turns on a light when the player enters a Trigger Box. When the cinematic finishes playing, we'll instruct Sequencer to apply the changes to the light in the Level so it persists after the cinematic has finished playing. We also allow the player to skip the cinematic while it is playing but still instruct Sequencer to turn and leave the light on after skipping the scene.

HeroImage.png

Steps

For this How-to, we are using the Blueprint Third Person Template project.

  1. From the Place Actors panel in the Basic tab, drag a Box Trigger into the Level and resize and position as desired.

    Trigger01.png

    When the player enters our trigger, we will instruct our cinematic to start playing through Blueprint.

  2. From the Main Toolbar, click the Cinematics button then select Add Level Sequence and give your cinematic a name.

    Trigger02.png

  3. From the Place Actors panel in the Basic tab, drag a Point Light into the Level and place the light in the position shown below.

    Trigger03.png

  4. With the Point Light selected, in the Details panel, change the Intensity value to 0.0 and click the Keyframe button.

    Trigger04.png

    This will add the Point Light to Sequencer and keyframe its initial value at the start of the sequence.

  5. In Sequencer, move the timeline to frame 150 and set the Intensity value of your light to 5000 and keyframe it.

    Click image for full view.

    Your Point Light will now start in the off position and get brighter as the Sequence plays out.

  6. Click the Add Camera Button, then move the Camera in the Level to a position near the Character and keyframe it.

    Click image for full view.

  7. Move the Timeline to frame 75 , then in the Level, move the Camera to a new position overlooking the Character and the light and keyframe it.

    Click image for full view.

  8. Move the Timeline to frame 150 , then in the Level, move the Camera to a position focused on the light and keyframe it.

    Click image for full view.

    Our cinematic now has a camera fly-through animation that will show the player where the light is in the Level.

  9. Select the Trigger Box in the Level, then from the Main Toolbar, click the Blueprints button and select Open Level Blueprint .

    Trigger09.png

  10. Right-click inside the graph, then select the Add On Actor Begin Overlap for the Trigger Box .

    Trigger10.png

  11. Return to the Level and select your Level Sequence, then back inside the Level Blueprint , right-click and Create a Reference to your Level Sequence.

    Trigger11.png

  12. Drag off the Level Sequence reference and select Play (SequencePlayer) .

    Trigger12.png

  13. Connect the OnActorBeginOverlap node to the Play node.

    Trigger13.png

    When entering the Trigger Box, the Play node will be executed and will play your Level Sequence.

    You will notice if you play in the Editor that the sequence plays when entering the Trigger Box, however, it will only play once. If you want to play the sequence again, you will need to start the sequence over using the Set Playback Position node with the Playback Position set to 0 (or the start of the sequence) before telling the sequence to play.

  14. In the Level Blueprint , drag off the Sequence Player node and use the Set Playback Position node.

    Trigger14.png

  15. Connect the Set Playback Position node between the OnActorBeginOverlap and Play nodes.

    Trigger15.png

    This will set the Level Sequence back to the beginning prior to playing it.

  16. Inside Sequencer , right-click on the Intensity track, then under Properties set When Finished to Keep State .

    Trigger16.png

    Using the Keep State option enables our light Intensity setting to remain after the sequence has ended. This is useful for situations where you want effects or settings you make in Sequencer to remain after the Sequence has ended. For example, your cinematic opens a door and you want the door to remain open once the cinematic ends.

  17. In the Level Blueprint , add an F keyboard event connected to a Branch (with condition Is Playing ) that is connected to the Go to End and Stop node.

    Trigger17.png

    When pressing the F key, if the Level Sequence is currently playing, it will immediately jump to the end and stop playing. The Go to End and Stop node is useful for situations when you want to allow your player to skip your cinematic but continue with any changes that Sequencer would have applied if the Sequence continued playing.

    For example, in our cinematic, Sequencer turns on a light in the Level. If the player skips the cutscene of the light being turned on, we still want the light to be on after the cutscene is skipped. If we were to simply use the Stop node to stop playing our cinematic, it would not complete the cinematic and would stop at whatever point in the cinematic we chose to stop (meaning the light would not be fully on or not on at all depending on where we stopped).

  18. Return to the Main Editor, then from the Main Toolbar, click the Play button to play in the Editor.

End Result

When you play in the Editor, you will notice that the light is not on by default. When entering the Trigger Box, the cinematic will start playing and the light will turn on and stay on when the cinematic completes. You can re-trigger the cinematic by entering the Trigger Box again, which will play the sequence from the beginning. You can also enter the Trigger Box and press the F key to skip the cinematic, which will result in the light automatically turning on.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Dismiss