ForceRefTo - ReferenceAlias

From the CreationKit Wiki
Jump to navigation Jump to search

Member of: ReferenceAlias Script

Forces this alias to use the specified reference.

Syntax[edit | edit source]

Function ForceRefTo(ObjectReference akNewRef) native

Parameters[edit | edit source]

Return Value[edit | edit source]

None.

Examples[edit | edit source]

; Force the alias to use us as the reference (if script extends ObjectReference)
Alias_JohnDoe.ForceRefTo(self)

Notes[edit | edit source]

  • Use of this function causes this actor (and all other actors in any current running scene in the quest) to re-evaluate their packages. Calling this multiple times in a row can result in actors in running scenes to lose their scene package permanently and result in brokenness. Do not call this multiple times in a row while a scene is running in the quest whose alias you are forcing to.
  • This function does not allow you to clear an alias by forcing it to None. Instead, use the Clear method.

See Also[edit | edit source]