Difference between revisions of "IsBoundGameObjectAvailable - ScriptObject"

From the Fallout4 CreationKit Wiki
Jump to navigation Jump to search
imported>Docclox
m (Undo revision 6004 by Threedee (talk))
imported>Docclox
m (The example is wrong - it's a ScriptObject not an ObjectReference.)
Line 20: Line 20:
<source lang="papyrus">
<source lang="papyrus">
; Make sure we have a reference to manipulate before we try to do so
; Make sure we have a reference to manipulate before we try to do so
if MyReference.IsBoundGameObjectAvailable()
if MyScriptObject.IsBoundGameObjectAvailable()
   ; Do cool stuff with MyReference here, as it is available to be manipulated
   ; Do cool stuff with MyReference here, as it is available to be manipulated
endIf
endIf

Revision as of 02:46, 23 June 2020

Member of: ScriptObject Script

Returns whether this script is attached to a valid and available in-game object. If it returns false, then calling native functions from one of the ScriptObject-extended scripts (like Form, or Alias, or ActiveMagicEffect) will immediately fail because it has no in-game object to operate on. The most common cases of this happening would be a magic effect that has expired, or a reference that is stored in a container.

Syntax

bool Function IsBoundGameObjectAvailable() native

Parameters

None.

Return Value

True if this script is attached to a valid in-game object. False if not.

Examples

; Make sure we have a reference to manipulate before we try to do so
if MyScriptObject.IsBoundGameObjectAvailable()
  ; Do cool stuff with MyReference here, as it is available to be manipulated
endIf

See Also