Skip to content

ObjectValue

Supported Class Values

A container object for a reference to another instance.

Description

Stores 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 points to the copied object instead of the original. Otherwise, the same value is kept. Copying and pasting this object clears the value field.

Like all ValueBase objects, this single value is stored in the Value property. The Changed event fires with the new value being stored in the object, instead of a string representing the property being changed.

If streaming is enabled, the Value property is nil until the referenced object streams in, at which point the Changed event fires.

Inheritance

Object → Instance → ValueBase → ObjectValue

Nova inheritance: Instance → ObjectValue

Properties

Value Supported Property Holds a reference to an instance.
Value: Object

Holds a reference to an instance.

Roblox reference signature
Value: Instance

Roblox documentation

Events

Changed Supported Event Fires whenever the ObjectValue.Value is changed.
Changed(Instance value)

Fires whenever the ObjectValue.Value is changed.

Fires whenever the ObjectValue.Value changes. It runs with the new value being stored in the argument object, instead of a string representing the property being changed.

Listening for the Changed signal can be useful in games that use ObjectValues to track game state, such as an RPG targeting system.

Roblox reference signature
Changed(value: Instance)

Roblox documentation

changed Supported Event Deprecated
changed(Instance value)

No description available.

Roblox reference signature
changed(value: Instance)
Nova behaviour: Nova keeps this legacy member for compatibility. Roblox's modern deprecation wording may describe later Roblox behaviour; verify it against Nova before relying on the copied text.

Roblox documentation

Inherited members

Inherited from Instance: 8 properties, 36 methods, 7 events. They are documented on the base class page.

Roblox reference: ObjectValue

Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.