Difference between revisions of "PlayIdle - Actor"
Jump to navigation
Jump to search
imported>DavidJCobb (→Notes: Confirmed through reverse-engineering.) |
m (Remove superfluous "form to whose animation", leaving "The idle to play on this actor") |
||
Line 11: | Line 11: | ||
== Parameters == | == Parameters == | ||
*akIdle: The idle | *akIdle: The idle to play on this actor. | ||
== Return Value == | == Return Value == |
Latest revision as of 16:22, 25 July 2023
Member of: Actor Script
Plays the idle passed.
Syntax[edit | edit source]
bool Function PlayIdle(Idle akIdle) native
Parameters[edit | edit source]
- akIdle: The idle to play on this actor.
Return Value[edit | edit source]
True if the idle was successfully loaded and played, false otherwise.
Examples[edit | edit source]
; Start Hadvar's flute animation
if Hadvar.PlayIdle(fluteIdle)
Debug.Trace("Hadvar is playing his flute!")
else
Debug.Trace("Something went wrong")
endIf
;Force Prisoner idle. Below is how to properly setup an actor in the "bound hands" pose as seen in first scene of the game in helgen.
Idle property OffsetBoundStandingStart auto
;Place this inside an Event, Function, etc
myActor.PlayIdle(OffsetBoundStandingStart)
Notes[edit | edit source]
- Too many things can happen while you are attempting to play an idle, so make sure to gracefully handle all circumstances. Never use the structure "play idle, wait for event" - this will inevitably cause your script to get stuck forever when some other code or script overrules your idle. Calling the PlayIdle function on the same actor, with the same idle again, will have the actor stop playing it (if it's a looped animation).
- Some idles cannot be played with this function if the idle has an associated special furniture and is not listed in the idle manager. To which other means to force a player to play such an idle is required.
- You cannot play an idle on an actor whose AI is disabled.