Difference between revisions of "SetRestrained - Actor"

From the CreationKit Wiki
Jump to navigation Jump to search
imported>SarthesArai
(→‎Notes: note on player behaviour)
Line 31: Line 31:
* Using SetRestrained on the player disables player movement, camera switching, and camera rotating, but keeps the full HUD displayed (unlike [[DisablePlayerControls - Game|Game.DisablePlayerControls()]]).
* Using SetRestrained on the player disables player movement, camera switching, and camera rotating, but keeps the full HUD displayed (unlike [[DisablePlayerControls - Game|Game.DisablePlayerControls()]]).
* Restrained Actors can still be moved with functions that invoke movement, such as KeepOffsetFromActor().
* Restrained Actors can still be moved with functions that invoke movement, such as KeepOffsetFromActor().
* Actors cannot be restrained and unconscious in the same time - flaging the actor as restrained unflags it as unconscious, and vice versa.


== See Also ==
== See Also ==
*[[Actor Script]]
*[[Actor Script]]

Revision as of 19:52, 11 July 2023

Member of: Actor Script

Flags this actor as restrained or not. Restrained actors will not move from their current position, but will continue to "think" (pick packages, run detection so they could yell alarms) and go into dialogue.

Syntax

Function SetRestrained(bool abRestrained = true) native

Parameters

  • abRestrained: Whether to set or clear the actor's restrained status.
    • Default: True

Return Value

None.

Examples

; Set Prisoner to restrained
Prisoner.SetRestrained()


; Clear Prisoner's restrained status
Prisoner.SetRestrained(false)

Notes

  • Using SetRestrained on the player disables player movement, camera switching, and camera rotating, but keeps the full HUD displayed (unlike Game.DisablePlayerControls()).
  • Restrained Actors can still be moved with functions that invoke movement, such as KeepOffsetFromActor().
  • Actors cannot be restrained and unconscious in the same time - flaging the actor as restrained unflags it as unconscious, and vice versa.

See Also