Difference between revisions of "ForceRefTo - ReferenceAlias"
Jump to navigation
Jump to search
imported>DavidJCobb (→Notes) |
imported>DavidJCobb (→Notes: apparently that's a thing) |
||
Line 25: | Line 25: | ||
== Notes == | == Notes == | ||
* Use of this function causes this actor (and all other actors in any current running scene in the quest) to re-[[EvaluatePackage - Actor|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. | * Use of this function causes this actor (and all other actors in any current running scene in the quest) to re-[[EvaluatePackage - Actor|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. | * This function does not allow you to clear an alias by forcing it to None. Instead, use the [[Clear - ReferenceAlias|Clear]] method. | ||
== See Also == | == See Also == |
Latest revision as of 20:49, 24 April 2017
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]
- akNewRef: The ObjectReference to tell this alias to use
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.