Editing
ObjectReference Script
(section)
Jump to navigation
Jump to search
Warning:
You are not logged in. Your IP address will be publicly visible if you make any edits. If you
log in
or
create an account
, your edits will be attributed to your username, along with other benefits.
Anti-spam check. Do
not
fill this in!
== Member Functions == :'''[[Activate - ObjectReference|Activate]](ObjectReference ''akActivator'')''' :*Have the passed in reference activate this object. :'''[[AddInventoryEventFilter - ObjectReference|AddInventoryEventFilter]](Form ''akFilter'')''' :*Adds an inventory event filter to this reference. :'''[[AddItem - ObjectReference|AddItem]](Form ''akItemToAdd'', Int ''aiCount'', Bool ''abSilent'')''' :*Adds the passed in item to this object's inventory. :'''[[AddKeyIfNeeded - ObjectReference|AddKeyIfNeeded]](ObjectReference ''ObjectWithNeededKey'')''' :*Adds the key to ObjectWithNeededKey if this object's inventory does not contain it already. :'''[[AddToMap - ObjectReference|AddToMap]](Bool ''abAllowFastTravel'')''' :*Adds this map marker to the map, optionally making it available for fast travel. :'''[[ApplyHavokImpulse - ObjectReference|ApplyHavokImpulse]](Float ''afX'', Float ''afY'', Float ''afZ'', Float ''afMagnitude'')''' :*Apply a Havok impulse force to this object. :'''[[BlockActivation - ObjectReference|BlockActivation]](Bool ''abBlocked'')''' :*Blocks normal activation processing for this reference. :'''Int [[CalculateEncounterLevel - ObjectReference|CalculateEncounterLevel]](Int ''aiDifficulty'')''' :*Calculate this object's encounter level, using the specified difficulty. :'''Bool [[CanFastTravelToMarker - ObjectReference|CanFastTravelToMarker]]()''' :*Can the player fast travel to this map marker? :'''[[ClearDestruction - ObjectReference|ClearDestruction]]()''' :*Clears all effects of destruction from this object. :'''Int [[CountLinkedRefChain - ObjectReference|CountLinkedRefChain]](Keyword ''apKeyword'', Int ''maxExpectedLinkedRefs'')''' :*Counts the number of linked refs that are in a linked Ref chain :'''[[CreateDetectionEvent - ObjectReference|CreateDetectionEvent]](Actor ''akOwner'', Int ''aiSoundLevel'')''' :*Create a detection event at this reference, with the specified owner. :'''[[DamageObject - ObjectReference|DamageObject]](Float ''afDamage'')''' :*Damages this object and advances the destruction stage. :'''[[Delete - ObjectReference|Delete]]()''' :*Deletes this object. :'''[[DeleteWhenAble - ObjectReference|DeleteWhenAble]]()''' :*Waits until this reference is out of the loaded area and then deletes it :'''[[Disable - ObjectReference|Disable]](Bool ''abFadeOut'')''' :*Disables this object. :'''[[DisableLinkChain - ObjectReference|DisableLinkChain]](Keyword ''apKeyword'', Bool ''abFadeOut'')''' :*Disables all of the references that are linked, in a chain, to this one. :'''[[DisableNoWait - ObjectReference|DisableNoWait]](Bool ''abFadeOut'')''' :*Disables this object and does not wait for the object to be disable or faded out. :'''[[DropObject - ObjectReference|DropObject]](Form ''akObject'', Int ''aiCount'')''' :*Drops the specified object from this object's inventory. :'''[[Enable - ObjectReference|Enable]](Bool ''abFadeIn'')''' :*Enables this object. :'''[[EnableFastTravel - ObjectReference|EnableFastTravel]](Bool ''abEnable'')''' :*Enables or disables fast travel to this map marker. :'''[[EnableLinkChain - ObjectReference|EnableLinkChain]](Keyword ''apKeyword'')''' :*Enables all of the references that are linked, in a chain, to this one. :'''[[EnableNoWait - ObjectReference|EnableNoWait]](Bool ''abFadeIn'')''' :*Enables this object and does not wait for the object to be enabled or faded in. :'''[[ForceAddRagdollToWorld - ObjectReference|ForceAddRagdollToWorld]]()''' :*Forcibly adds the ragdoll of a reference to the world :'''[[ForceRemoveRagdollFromWorld - ObjectReference|ForceRemoveRagdollFromWorld]]()''' :*Forcibly removes the ragdoll of a reference from the world :'''ActorBase [[GetActorOwner - ObjectReference|GetActorOwner]]()''' :*Obtains the actor base that owns this object. :'''Float [[GetAngleX - ObjectReference|GetAngleX]]()''' :*Obtains this object's rotation around the x axis. :'''Float [[GetAngleY - ObjectReference|GetAngleY]]()''' :*Obtains this object's rotation around the y axis. :'''Float [[GetAngleZ - ObjectReference|GetAngleZ]]()''' :*Obtains this object's rotation around the z axis. :'''Bool [[GetAnimationVariableBool - ObjectReference|GetAnimationVariableBool]](String ''asVariableName'')''' :*Fetches the value of a variable on the reference's animation graph (bool version). :'''Float [[GetAnimationVariableFloat - ObjectReference|GetAnimationVariableFloat]](String ''asVariableName'')''' :*Fetches the value of a variable on the reference's animation graph (float version). :'''Int [[GetAnimationVariableInt - ObjectReference|GetAnimationVariableInt]](String ''asVariableName'')''' :*Fetches the value of a variable on the reference's animation graph (int version). :'''Form [[GetBaseObject - ObjectReference|GetBaseObject]]()''' :*Obtains this reference's base object. :'''Int [[GetCurrentDestructionStage - ObjectReference|GetCurrentDestructionStage]]()''' :*Gets the object's current stage of destruction. :'''Location [[GetCurrentLocation - ObjectReference|GetCurrentLocation]]()''' :*Obtains this reference's current location. :'''Scene [[GetCurrentScene - ObjectReference|GetCurrentScene]]()''' :*Obtains the scene that this reference is currently participating in, if any. :'''Float [[GetDistance - ObjectReference|GetDistance]](ObjectReference ''akOther'')''' :*Calculates the distance between this object and the passed in one. :'''Location [[GetEditorLocation - ObjectReference|GetEditorLocation]]()''' :*Obtains this reference's editor location. :'''Faction [[GetFactionOwner - ObjectReference|GetFactionOwner]]()''' :*Gets the faction that owns this reference. :'''Float [[GetHeadingAngle - ObjectReference|GetHeadingAngle]](ObjectReference ''akOther'')''' :*Gets the angle between this object's heading, and the direction the other object is in. :'''Float [[GetHeight - ObjectReference|GetHeight]]()''' :*Gets the height of this object :'''Int [[GetItemCount - ObjectReference|GetItemCount]](Form ''akItem'')''' :*Returns how many of the specified item is in this object's inventory. :'''Float [[GetItemHealthPercent - ObjectReference|GetItemHealthPercent]]()''' :*Returns the item health percent of this object (1.0 == 100%). :'''Key [[GetKey - ObjectReference|GetKey]]()''' :*Obtains the key that unlocks this object (if any). :'''Float [[GetLength - ObjectReference|GetLength]]()''' :*Obtains the length of this object. :'''ObjectReference [[GetLinkedRef - ObjectReference|GetLinkedRef]](Keyword ''apKeyword'')''' :*Returns our linked reference for the given Keyword, if any. :'''Int [[GetLockLevel - ObjectReference|GetLockLevel]]()''' :*Obtains the level of the lock on this object. :'''Float [[GetMass - ObjectReference|GetMass]]()''' :*Obtains this object's mass in Havok. :'''ObjectReference [[GetNthLinkedRef - ObjectReference|GetNthLinkedRef]](Int ''aiLinkedRef'')''' :*Obtains the nth linked ref from this object. :'''Int [[GetOpenState - ObjectReference|GetOpenState]]()''' :*Obtains this object's current "open state". :'''Cell [[GetParentCell - ObjectReference|GetParentCell]]()''' :*Obtains the cell this object is currently in. :'''Float [[GetPositionX - ObjectReference|GetPositionX]]()''' :*Returns this object's current X position. :'''Float [[GetPositionY - ObjectReference|GetPositionY]]()''' :*Returns this object's current Y position. :'''Float [[GetPositionZ - ObjectReference|GetPositionZ]]()''' :*Returns this object's current Z position. :'''Float [[GetScale - ObjectReference|GetScale]]()''' :*Get this object's current scale. :'''Int [[GetTriggerObjectCount - ObjectReference|GetTriggerObjectCount]]()''' :*Returns the number of objects inside this trigger volume. :'''VoiceType [[GetVoiceType - ObjectReference|GetVoiceType]]()''' :*Obtains the [[VoiceType Script|VoiceType]] for this actor or talking activator. :'''Float [[GetWidth - ObjectReference|GetWidth]]()''' :*Get the current width of the object. :'''Worldspace [[GetWorldSpace - ObjectReference|GetWorldSpace]]()''' :*Returns the worldspace this reference is in. :'''Bool [[HasEffectKeyword - ObjectReference|HasEffectKeyword]](Keyword ''akKeyword'')''' :*Returns if this reference has an active effect coming from a magic effect with the specified keyword attached :'''Bool [[HasNode - ObjectReference|HasNode]](String ''asNodeName'')''' :*Returns if this reference has the specified name node in its 3D. :'''Bool [[HasRefType - ObjectReference|HasRefType]](LocationRefType ''akRefType'')''' :*Returns if this reference has the specified [[LocationRefType Script|LocationRefType]] attached. :'''[[IgnoreFriendlyHits - ObjectReference|IgnoreFriendlyHits]](Bool ''abIgnore'')''' :*Flags this reference as ignoring (or not ignoring) friendly hits :'''[[InterruptCast - ObjectReference|InterruptCast]]()''' :*Interrupts any spellcasting this object may be doing. :'''Bool [[IsActivateChild - ObjectReference|IsActivateChild]](ObjectReference ''akChild'')''' :*Returns whether the passed in reference is an activate child of this reference. :'''Bool [[IsActivationBlocked - ObjectReference|IsActivationBlocked]]()''' :*Returns whether normal activation processing is currently blocked on this reference or not. :'''Bool [[Is3DLoaded - ObjectReference|Is3DLoaded]]()''' :*Checks to see if this reference's 3D data is currently loaded or not. :'''Bool [[IsDeleted - ObjectReference|IsDeleted]]()''' :*Checks to see if this object is currently flagged for delete. :'''Bool [[IsDisabled - ObjectReference|IsDisabled]]()''' :*Is this object currently disabled? :'''Bool [[IsEnabled - ObjectReference|IsEnabled]]()''' :*Is this object currently enabled? :'''Bool [[IsFurnitureInUse - ObjectReference|IsFurnitureInUse]](Bool ''abIgnoreReserved'')''' :*Is any furniture marker on this object in use? :'''Bool [[IsFurnitureMarkerInUse - ObjectReference|IsFurnitureMarkerInUse]](Int ''aiMarker'', Bool ''abIgnoreReserved'')''' :*Is the specified furniture marker on this object in use? :'''Bool [[IsIgnoringFriendlyHits - ObjectReference|IsIgnoringFriendlyHits]]()''' :*Is this object ignoring friendly hits? :'''Bool [[IsInDialogueWithPlayer - ObjectReference|IsInDialogueWithPlayer]]()''' :*Is this actor or talking activator currently talking to the player? :'''Bool [[IsInInterior - ObjectReference|IsInInterior]]()''' :*Returns true if the object is in an interior cell. :'''Bool [[IsInLocation - ObjectReference|IsInLocation]](Location ''akLocation'')''' :*Returns true if the object is currently in that location or a child of that location. :'''Bool [[IsLocked - ObjectReference|IsLocked]]()''' :*Is the lock on this object locked? :'''Bool [[IsMapMarkerVisible - ObjectReference|IsMapMarkerVisible]]()''' :*Is this map marker visible to the player? :'''Bool [[IsNearPlayer - ObjectReference|IsNearPlayer]]()''' :*A quick-and-dirty function to tell if this object is safe to enable or disable :'''[[KnockAreaEffect - ObjectReference|KnockAreaEffect]](Float ''afMagnitude'', Float ''afRadius'')''' :*Executes a knock effect to an area :'''[[Lock - ObjectReference|Lock]](Bool ''abLock'', Bool ''abAsOwner'')''' :*Locks or unlocks this object. :'''[[MoveTo - ObjectReference|MoveTo]](ObjectReference ''akTarget'', Float ''afXOffset'', Float ''afYOffset'', Float ''afZOffset'', Bool ''abMatchRotation'')''' :*Moves this object to the same location as the passed-in reference, offset by the specified amount. :'''Bool [[MoveToIfUnloaded - ObjectReference|MoveToIfUnloaded]](ObjectReference ''akTarget'', Float ''afXOffset'', Float ''afYOffset'', Float ''afZOffset'')''' :*Moves this object to the same location as the passed-in reference, offset by the specified amount, IF this object is not currently loaded. :'''[[MoveToInteractionLocation - ObjectReference|MoveToInteractionLocation]](ObjectReference ''akTarget'')''' :*Moves this object to the specified object's interaction location. :'''[[MoveToMyEditorLocation - ObjectReference|MoveToMyEditorLocation]]()''' :*Moves this object to its own editor location. :'''[[MoveToNode - ObjectReference|MoveToNode]](ObjectReference ''akTarget'', String ''asNodeName'')''' :*Moves this object to the position (and rotation) of the specified node on the specified object's 3D :'''Actor [[PlaceActorAtMe - ObjectReference|PlaceActorAtMe]](ActorBase ''akActorToPlace'', Int ''aiLevelMod'', EncounterZone ''akZone'')''' :*Create an actor at this object's location. :'''ObjectReference [[PlaceAtMe - ObjectReference|PlaceAtMe]](Form ''akFormToPlace'', Int ''aiCount'')''' :*Places x copies of the passed in form at this object's current position, returning the last one created. :'''Bool [[PlayAnimation - ObjectReference|PlayAnimation]](String ''asAnimation'')''' :*Plays the specified animation on this object, returning immediately. :'''Bool [[PlayAnimationAndWait - ObjectReference|PlayAnimationAndWait]](String ''asAnimation'', String ''asEventName'')''' :*Plays the specified animation on this object and waits for the specified event before returning. (latent) :'''Bool [[PlayGamebryoAnimation - ObjectReference|PlayGamebryoAnimation]](String ''asAnimation'', Bool ''abStartOver'', Float ''afEaseInTime'')''' :*Plays a legacy nif file based animation :'''Bool [[PlayImpactEffect - ObjectReference|PlayImpactEffect]](ImpactDataSet ''akImpactEffect'', String ''asNodeName'', Float ''afPickDirX'', Float ''afPickDirY'', Float ''afPickDirZ'', Float ''afPickLength'', Bool ''abApplyNodeRotation'', Bool ''abUseNodeLocalRotation'')''' :*Plays an impact effect. :'''Bool [[PlaySyncedAnimationAndWaitSS - ObjectReference|PlaySyncedAnimationAndWaitSS]](String ''asAnimation1'', String ''asEvent1'', ObjectReference ''akObj2'', String ''asAnimation2'', String ''asEvent2'')''' :*Plays two animations simultaneously, waiting for events from both. :'''Bool [[PlaySyncedAnimationSS - ObjectReference|PlaySyncedAnimationSS]](String ''asAnimation1'', ObjectReference ''akObj2'', String ''asAnimation2'')''' :*Plays two animations simultaneously. :'''[[PlayTerrainEffect - ObjectReference |PlayTerrainEffect]](String ''asEffectModelName'', String ''asAttachBoneName'')''' :*Plays a terrain effect. :'''[[ProcessTrapHit - ObjectReference|ProcessTrapHit]](ObjectReference ''akTrap'', Float ''afDamage'', Float ''afPushback'', Float ''afXVel'', Float ''afYVel'', Float ''afZVel'', Float ''afXPos'', Float ''afYPos'', Float ''afZPos'', Int ''aeMaterial'', Float ''afStagger'')''' :*Tells this object to handle the specified trap object hitting it. :'''[[PushActorAway - ObjectReference|PushActorAway]](Actor ''akActorToPush'', Int ''aiKnockbackDamage'')''' :*Pushes the other actor away from this object as if hit by the specified amount of knockback damage. :'''Bool [[RampRumble - ObjectReference|RampRumble]](Float ''power'', Float ''duration'', Float ''falloff'')''' :*Shakes cam/controller based on distance from player :'''[[RemoveAllInventoryEventFilters - ObjectReference|RemoveAllInventoryEventFilters]]()''' :*Remove all inventory event filters on this reference. :'''[[RemoveAllItems - ObjectReference|RemoveAllItems]](ObjectReference ''akTransferTo'', Bool ''abKeepOwnership'', Bool ''abSilent'')''' :*Removes all items from this container, optionall transferring them to another one. :'''[[RemoveInventoryEventFilter - ObjectReference|RemoveInventoryEventFilter]](Form ''akFilter'')''' :*Remove a specific inventory event filter. :'''[[RemoveItem - ObjectReference|RemoveItem]](Form ''akItemToRemove'', Int ''aiCount'', Bool ''abSilent'', ObjectReference ''akOtherContainer'')''' :*Removes the passed in item from this object's inventory. :'''[[Reset - ObjectReference|Reset]](ObjectReference ''akTarget'')''' :*Resets this object reference, optionally placing the object at the new target. :'''[[Say - ObjectReference|Say]](Topic ''akTopicToSay'', Actor ''akActorToSpeakAs'', Bool ''abSpeakInPlayersHead'')''' :*Causes this reference to speak a topic as if it were the specified actor. :'''[[SendStealAlarm - ObjectReference|SendStealAlarm]](Actor ''akThief'')''' :*Sends a steal alarm as if this reference had just been stolen by the actor. :'''[[SetActorCause - ObjectReference|SetActorCause]](Actor ''akActor'')''' :*Sets this actor as this object's actor cause. :'''[[SetActorOwner - ObjectReference|SetActorOwner]](ActorBase ''akActorBase'')''' :*Sets this actor base as this object's owner. :'''[[SetAngle - ObjectReference|SetAngle]](Float ''afXAngle'', Float ''afYAngle'', Float ''afZAngle'')''' :*Sets this object's rotation. Angles are in degrees. :'''[[SetAnimationVariableBool - ObjectReference|SetAnimationVariableBool]](String ''asVariableName'', Bool ''abNewValue'')''' :*Sets the value of a variable on the reference's animation graph (bool version). :'''[[SetAnimationVariableFloat - ObjectReference|SetAnimationVariableFloat]](String ''asVariableName'', Float ''afNewValue'')''' :*Sets the value of a variable on the reference's animation graph (float version). :'''[[SetAnimationVariableInt - ObjectReference|SetAnimationVariableInt]](String ''asVariableName'', Int ''aiNewValue'')''' :*Sets the value of a variable on the reference's animation graph (int version). :'''[[SetDestroyed - ObjectReference|SetDestroyed]](Bool ''abDestroyed'')''' :*Sets or clears this object's destroyed flag. :'''[[SetFactionOwner - ObjectReference|SetFactionOwner]](Faction ''akFaction'')''' :*Sets this faction as this object's owner. :'''[[SetLockLevel - ObjectReference|SetLockLevel]](Int ''aiLockLevel'')''' :*Sets the lock level on this object. :'''[[SetMotionType - ObjectReference|SetMotionType]](Int ''aiMotionType'', Bool ''abAllowActivate'')''' :*Sets the havok motion type on this object. :'''[[SetNoFavorAllowed - ObjectReference|SetNoFavorAllowed]](Bool ''abNoFavor'')''' :*Sets or clears this object's ability to be not used by a teammate for a favor :'''[[SetOpen - ObjectReference|SetOpen]](Bool ''abOpen'')''' :*Opens or closes this object. :'''[[SetPosition - ObjectReference|SetPosition]](Float ''afX'', Float ''afY'', Float ''afZ'')''' :*Sets this object's position. :'''[[SetScale - ObjectReference|SetScale]](Float ''afScale'')''' :*Set the current scale of the object :'''[[SplineTranslateTo - ObjectReference|SplineTranslateTo]](Float ''afX'', Float ''afY'', Float ''afZ'', Float ''afAngleX'', Float ''afAngleY'', Float ''afAngleZ'', Float ''afSplineCurve'', Float ''afSpeed'')''' :*Makes the object translate to the given pos/orient on a spline. :'''[[SplineTranslateToRef - ObjectReference|SplineTranslateToRef]](ObjectReference ''arTarget'', Float ''afTangentMagnitude'', Float ''afSpeed'', Float ''afMaxRotationSpeed'')''' :*Makes the reference translate to the target ref position/orient on a spline at the given speed :'''[[SplineTranslateToRefNode - ObjectReference|SplineTranslateToRefNode]](ObjectReference ''arTarget'', String ''arNodeName'', Float ''afTangentMagnitude'', Float ''afSpeed'', Float ''afMaxRotationSpeed'')''' :*Makes the reference translate to the target node's position/orient on a spline at the given speed :'''[[StopTranslation - ObjectReference|StopTranslation]]()''' :*Stops any translation on the object. :'''[[TetherToHorse - ObjectReference|TetherToHorse]](ObjectReference ''akHorse'')''' :*Tether a prisoner cart to the given horse. :'''[[TranslateTo - ObjectReference|TranslateTo]](Float ''afX'', Float ''afY'', Float ''afZ'', Float ''afAngleX'', Float ''afAngleY'', Float ''afAngleZ'', Float ''afSpeed'', Float ''afMaxRotationSpeed'')''' :*Makes the object translate to the given pos/orient. :'''[[TranslateToRef - ObjectReference|TranslateToRef]](ObjectReference ''arTarget'', Float ''afSpeed'', Float ''afMaxRotationSpeed'')''' :*Makes the reference translate to the target ref position/orient at the given speed :'''Bool [[WaitForAnimationEvent - ObjectReference|WaitForAnimationEvent]](String ''asEventName'')''' :*Waits for the animation graph to send the specified event.
Summary:
Please note that all contributions to the CreationKit Wiki are considered to be released under the Creative Commons Attribution-ShareAlike (see
CreationKit:Copyrights
for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource.
Do not submit copyrighted work without permission!
Cancel
Editing help
(opens in new window)
Navigation menu
Personal tools
Not logged in
Talk
Contributions
Create account
Log in
Namespaces
Page
Discussion
English
Views
Read
Edit
Edit source
View history
More
Search
Navigation
Landing page
Tutorials
Game Systems
Editor Reference
Scripting Reference
Recent changes
Help
Tools
What links here
Related changes
Special pages
Page information
Page values