Attributes — sticky notes on objects

Sometimes you need to attach your own data to an object: "this part is a coin," "this NPC is friendly," "this door is locked." That's attributes — sticky notes that make objects describe themselves.

#Writing and reading attributes

Two methods do everything:

part:SetAttribute("IsCoin", true)
part:SetAttribute("Value", 10)

print(part:GetAttribute("IsCoin")) --> true
print(part:GetAttribute("Value")) --> 10

SetAttribute(name, value) sticks data on the object; GetAttribute(name) reads it back. The value can be a number, string, boolean, or more. It survives as long as the object does.

#Attributes beat name checks

The old way to identify a part was checking its name:

if part.Name == "Coin1" then  -- breaks with 50 coins

Names can't describe 50 coins individually. Attributes can — and one check handles all of them:

local coin = workspace:WaitForChild("Coin")
if coin:GetAttribute("IsCoin") then
    print("It's a coin worth " .. coin:GetAttribute("Value"))
end

Any script that meets a part can look at its attributes and know what to do with it — no hardcoded name list, no magic strings.

#Building with attributes

Attributes really shine when you generate objects in a loop — each one carries its own data:

for i = 1, 5 do
    local coin = Instance.new("Part")
    coin.Size = Vector3.new(1, 1, 1)
    coin.Anchored = true
    coin:SetAttribute("IsCoin", true)
    coin:SetAttribute("Value", 10 * i)
    coin.Parent = workspace
end

Five coins, five different values, one attribute check to handle them all. The coin's worth travels with the coin.

-- lock the door

#Common mistakes

• Using name checks instead of attributes. if part.Name == "Coin1" breaks the moment you have 50 coins. GetAttribute("IsCoin") works for all of them.
• Forgetting you set it. Attribute data lives on the object — re-create the object and the attributes are gone.
• Expecting attributes to do logic. They store data; your scripts do the deciding. An attribute is a fact, not a behavior.

Next: giving the world a voice — sounds.