This article's documentation is for anything that uses the Source engine. Click here for more information.


From Valve Developer Community
Jump to: navigation, search
English (en)
... Icon-Important.png
class hierarchy
CSceneEntity defined in sceneentity.cpp
Choreo scene.png

 logic_choreographed_scene is a point entity available in all Source Source games. It manages a choreographed scene of one or more actors.

For an example on how this entity can be used, see the npc_gman_overwatch prefab.

Icon-Bug.pngBug:In multiplayer, the actor must be within a player's PVS in order for lines to be heard. This does not apply in Portal 2 Portal 2 .
Blank image.pngTodo: Are there any other games where it works? Any way to force it to get sent?


Scene file (SceneFile) <scene>
The VCD scene file to use.
Target 1 (target1) to Target 8 (target8) <targetname>
Use these keyvalues to specify the resolution of Actor or Event Target names that are using a !Target# name in the VCD.
If an Actor is talking... (busyactor) <choices>
What to do if an actor this scene needs is already talking when this scene is told to start.
  • 0 : Start immediately
  • 1 : Wait for actor to finish
  • 2 : Interrupt at next interrupt event
  • 3 : Cancel at next interrupt event
On player death (onplayerdeath) <choices>
What should this entity do if the player dies
  • 0 : Do Nothing
  • 1 : Cancel Script and return to AI

Name (targetname) <string>
The targetname that other entities refer to this entity by.


Starts playback of the scene file
Pauses playback of the scene file
Resumes playback of the scene if it has been paused
Cancels playback of the scene
Cancels playback of the scene at the next interrupt event in the scene.
PitchShift <float>
Multiplies the pitch
InterjectResponse <string>
Finds an actor who can respond to the specified concept string while the scene continues playing
Stop waiting on an actor to stop talking.


The scene has started
The scene has completed
The scene has been canceled
OnTrigger1 to OnTrigger16
Scene trigger 1. (!activator is the activator)