ScriptedActions are used by ScriptedSequences. These allow mappers to create complex behaviours for actors without actually programming in UnrealScript. You can think of this as a bit like creating macros in an application. ScriptedAction has a HUGE number of subclasses, each which carries out a particular kind of action.
See also Creating And Using ScriptedActions.
Available Actions
- Latent actions stop the execution flow of the scripted sequence until their task has been finished.
- Several actions by design can't be used with a ScriptedTrigger. They're marked separately below.
Environment Control
| Action Class
|
Latent?
|
ScriptedTrigger?
|
Purpose
|
| ACTION_ChangeLevel
|
No
|
Yes
|
Sends the server to another level.
|
| ACTION_DestroyActor
|
No
|
Yes
|
Destroys all Actors with a given Tag.
|
| ACTION_PlayAmbientSound
|
No
|
Yes
|
Plays an ambient sound.
|
| ACTION_SetCorona
|
No
|
Yes
|
Sets the bCorona property for all Actors with a given Tag.
|
| ACTION_SetHidden
|
No
|
Yes
|
Sets the bHidden property for all Actors with a given Tag.
|
| ACTION_SpawnActor
|
No
|
Yes
|
Spawns an Actor.
|
| ACTION_TriggerEvent
|
No
|
Yes
|
Fires the given Event.
|
Player Control
General
| Action Class
|
Latent?
|
ScriptedTrigger?
|
Purpose
|
| ACTION_ConsoleCommand
|
No
|
Yes
|
Executes a console command on the server for the instigator.
|
| ACTION_DamageInstigator
|
No
|
Yes
|
Inflicts damage on the instigator.
|
| ACTION_DestroyPawn
|
No
|
No
|
Destroys the instigator's Pawn.
|
| ACTION_ForceMoveToPoint
|
No
|
Yes
|
Instantaneously moves the instigator to the specified point.
|
| ACTION_KillInstigator
|
No
|
Yes
|
Kills the instigator with a given DamageType.
|
| ACTION_PlaySound
|
No
|
Yes
|
Plays a sound.
|
| ACTION_SetPhysics
|
No
|
Yes
|
Sets the instigator's physics mode.
|
| ACTION_TeleportToPoint
|
No
|
Yes
|
Instantly teleports the instigator to a given destination, optionally displaying a respawn/teleportation effect.
|
Human Players
| Action Class
|
Latent?
|
ScriptedTrigger?
|
Purpose
|
| ACTION_DisplayMessage
|
No
|
Yes
|
Sends a message to the instigator or all players.
|
| ACTION_FadeView
|
Yes
|
Yes
|
Fades the instigator's view to a given constant color.
|
| ACTION_GotoMenu
|
No
|
Yes
|
Opens a given menu on the first found human player's screen.
|
| ACTION_LocalizedMessage
|
No
|
Yes
|
Displays a certain LocalMessage on the instigator's screen.
|
| ACTION_PlayLocalSound
|
No
|
Yes
|
Plays a sound for all human players in the game.
|
| ACTION_PlayMusic
|
No
|
Yes
|
Sets the music for either the instigator only or all human players in the game.
|
ScriptedControllers and Bots
| Action Class
|
Latent?
|
ScriptedTrigger?
|
Purpose
|
| ACTION_ChangeTeam
|
No
|
Yes
|
Changes the instigator's team.
|
| ACTION_ChangeWeapon
|
No
|
Yes
|
Changes the instigator's Weapon (if present in his/her inventory).
|
| ACTION_Crouch
|
No
|
No
|
Tells the instigator to start crouching (as opposed to walking or running).
|
| ACTION_FinishRotation
|
Yes
|
Yes
|
Waits until the instigator has finished rotating towards its goal.
|
| ACTION_FireWeapon
|
No
|
Yes
|
Tells the instigator to fire its current weapon.
|
| ACTION_Freeze
|
Yes
|
Yes
|
Freezes the instigator.
|
| ACTION_FreezeOnAnimEnd
|
No
|
Yes
|
Freezes the instigator after its current animation has ended.
|
| ACTION_Jump
|
No
|
Yes
|
Makes the instigator jump or dodge.
|
| ACTION_MoveToPlayer
|
Yes
|
No
|
Makes the instigator go to its associated player.
|
| ACTION_MoveToPoint
|
Yes
|
No
|
Makes the instigator go to a specified Actor specified by its Tag, or the UnrealScriptedSequence actor's location itself if none is specified.
|
| ACTION_PlayAnim
|
No
|
No
|
Plays an animation for the instigator.
|
| ACTION_Run
|
No
|
No
|
Tells the instigator to start running (as opposed to walking or crouching).
|
| ACTION_SetAlertness
|
No
|
No
|
Sets the instigator's alertness.
|
| ACTION_SetViewTarget
|
No
|
No
|
Tells the instigator to focus on the actor specified by a given Tag.
|
| ACTION_ShootTarget
|
No
|
Yes
|
Tells the instigator to start shooting its current target.
|
| ACTION_StopAnimation
|
No
|
No
|
Stops the instigator's current animation.
|
| ACTION_StopShooting
|
No
|
Yes
|
Tells the instigator to stop shooting its current target.
|
| ACTION_ThrowWeapon
|
No
|
Yes
|
Tells the instigator to throw its weapon.
|
| ACTION_TurnTowardPlayer
|
No
|
No
|
Tells the instigator to turn towards its associated player.
|
| ACTION_Walk
|
No
|
No
|
Tells the instigator to start walking (as opposed to running or crouching).
|
Flow Control
- Scripted sequences can contain conditional blocks. A conditional block starts with an ACTION_IfCondition or an ACTION_IfRandomPct and ends at an ACTION_EndSection. Blocks can be nested.
- There is support for loops built into the code, but no scripted action that exposes that functionality in UnrealEd. You will have to combine ACTION_IfCondition and ACTION_GotoAction to create conditional loops.
| Action Class
|
Latent?
|
ScriptedTrigger?
|
Purpose
|
| ACTION_ChangeScript
|
No
|
No
|
Continues execution with a different script.
|
| ACTION_EndSection
|
No
|
Yes
|
Marks the end of a section of script actions that was started with ACTION_IfCondition or ACTION_IfRandomPct.
|
| ACTION_GotoAction
|
No
|
Yes
|
Jumps to a given action number within the current sequence.
|
| ACTION_IfCondition
|
No
|
Yes
|
Skips all actions up to the next ACTION_EndSection unless a given TriggeredCondition is enabled.
|
| ACTION_IfRandomPct
|
No
|
Yes
|
Skips all actions up to the next ACTION_EndSection with a given probability.
|
| ACTION_LeaveSequence
|
No
|
Yes
|
Stops this scripted sequence.
|
| ACTION_WaitForAnimend
|
Yes
|
No
|
Waits until the instigator's current animation has ended.
|
| ACTION_WaitForEvent
|
Yes
|
Yes
|
Waits until the given Event has been fired.
|
| ACTION_WaitForPlayer
|
Yes
|
No
|
Waits until the instigator is within a given distance of its associated player.
|
| ACTION_WaitForTimer
|
Yes
|
Yes
|
Waits until a given number of seconds has elapsed.
|
External Links
Related Topics
