ObjectValue
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.
Code Samples
This code sample creates an ObjectValue in the Workspace which holds a reference to an object in the workspace named "Baseplate".
local objectValue = Instance.new("ObjectValue")
objectValue.Name = "MyBaseplateReference"
objectValue.Value = workspace:FindFirstChild("Baseplate")
objectValue.Parent = workspaceSummary
Properties
Holds a reference to an instance.
Events
Fired whenever the ObjectValue.Value is changed.
Properties
Methods
Events
Changed
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.
Parameters
The value after the change.
Code Samples
This example prints the path to the newly reference instance when the ObjectValue's value property is changed.
local objectValue = script.Parent.ObjectValue
local part = script.Parent.Part
local function printObject(object)
print(object:GetFullName())
end
objectValue.Changed:Connect(printObject)
objectValue.Value = part