ObjectValue
CreatorHub

A container object for a reference to another instance.

Memory category	Instances

Member index 3

History		Member
553		Value: Instance
462		Changed(value: Instance)
553		changed(value: Instance)
63 members inherited from Instance
553		Archivable: bool
553		Attributes: string
553		AttributesReplicate: string
553		AttributesSerialize: BinaryString
635		Capabilities: SecurityCapabilities
553		DataCost: int
619		DefinesCapabilities: bool
553		HistoryId: UniqueId
553		Name: string
553		Parent: Instance
553		PropertyStatusStudio: PropertyStatus
553		RobloxLocked: bool
635		Sandboxed: bool
616		SourceAssetId: int64
553		Tags: BinaryString
616		UniqueId: UniqueId
553		archivable: bool
553		numExpectedDirectChildren: int
576		AddTag(tag: string): null
573		ClearAllChildren(): null
462		Clone(): Instance
573		Destroy(): null
486		FindFirstAncestor(name: string): Instance
486		FindFirstAncestorOfClass(className: string): Instance
486		FindFirstAncestorWhichIsA(className: string): Instance
486		FindFirstChild(name: string, recursive: bool = false): Instance
486		FindFirstChildOfClass(className: string): Instance
486		FindFirstChildWhichIsA(className: string, recursive: bool = false): Instance
486		FindFirstDescendant(name: string): Instance
563		GetActor(): Actor
486		GetAttribute(attribute: string): Variant
462		GetAttributeChangedSignal(attribute: string): RBXScriptSignal
631		GetAttributes(): Dictionary
486		GetChildren(): Objects
462		GetDebugId(scopeLength: int = 4): string
486		GetDescendants(): Array
486		GetFullName(): string
641		GetStyled(name: string): Variant
576		GetTags(): Array
576		HasTag(tag: string): bool
486		IsAncestorOf(descendant: Instance): bool
486		IsDescendantOf(ancestor: Instance): bool
580		IsPropertyModified(name: string): bool
573		Remove(): null
576		RemoveTag(tag: string): null
580		ResetPropertyToDefault(name: string): null
573		SetAttribute(attribute: string, value: Variant): null
462		WaitForChild(childName: string, timeOut: double): Instance
553		children(): Objects
553		clone(): Instance
573		destroy(): null
553		findFirstChild(name: string, recursive: bool = false): Instance
553		getChildren(): Objects
553		isDescendantOf(ancestor: Instance): bool
573		remove(): null
462		AncestryChanged(child: Instance, parent: Instance)
462		AttributeChanged(attribute: string)
462		ChildAdded(child: Instance)
462		ChildRemoved(child: Instance)
462		DescendantAdded(descendant: Instance)
462		DescendantRemoving(descendant: Instance)
500		Destroying()
553		childAdded(child: Instance)
6 members inherited from Object
647		ClassName: string
647		className: string
647		GetPropertyChangedSignal(property: string): RBXScriptSignal
647		IsA(className: string): bool
647		isA(className: string): bool
647		Changed(property: string)

Description

A ObjectValue is an object whose purpose is to store a single reference to another object. If this object is duplicated within studio and the value refers to an object also being copied, then the new ObjectValue will point to the copied object instead of the original. Otherwise, the same value is kept. Copying and pasting this object will clear the value field.

The value of this can be set within studio like other reference-type fields (such as Model.PrimaryPart): click the field within the Properties window, then click the object you wish to set it to within the game view or Explorer window. You can clear the field (set it to nil) by clicking the X that appears when you click the field.

Like all "-Value" objects, this single value is stored in the Value property. The Changed event for this (and other objects like it) will fire with the new value being stored in the object, instead of a string representing the property being changed.

History 12
Hide member changes

553 Change PreferredDescriptor of changed from to Changed
553 Change Default of Value from to
486 Change ThreadSafety of Value from ReadOnly to ReadSafe
462 Change ThreadSafety of changed from to Unsafe
462 Change ThreadSafety of Changed from to Unsafe
462 Change ThreadSafety of Value from to ReadOnly
335 Change Superclass of ObjectValue from Instance to ValueBase
329 Change ValueType of Value from Object to Instance
50 Add changed
47 Add Changed
47 Add Value
47 Add ObjectValue

Members 3

Changed
CreatorHub

Parameters (1)
value	Instance

This event fires whenever the ObjectValue.Value property is changed. It will run with the new value being stored in the argument object, instead of a string representing the property being changed.

This event, like other changed events, can be used to track when an ObjectValue changes and to track the different values that it may change to.

For instance, this even may be useful in games that rely on ObjectValues to track game states and values, such as RPG targeting systems.

Equivalent changed events exist for similar objects, such as NumberValue and StringValue, depending on what object type best suits the need.

Thread safety	Unsafe

History 2

462 Change ThreadSafety of Changed from to Unsafe
47 Add Changed

Value
CreatorHub

Type		Default
Instance

Holds a reference to an instance.

Thread safety	ReadSafe
Category	Data
Loaded/Saved	true

History 5

553 Change Default of Value from to
486 Change ThreadSafety of Value from ReadOnly to ReadSafe
462 Change ThreadSafety of Value from to ReadOnly
329 Change ValueType of Value from Object to Instance
47 Add Value

changed
CreatorHub

Parameters (1)
value	Instance

It exists only for backward compatibility, and should not be used for new work. Changed should be used instead.

Thread safety	Unsafe

History 3

553 Change PreferredDescriptor of changed from to Changed
462 Change ThreadSafety of changed from to Unsafe
50 Add changed

Tags: [Deprecated]

Reference API Roblox

Engine API

Website

Related