Instance (Table)

Up one category:
Scripting

Instance

In ROBLOX, an Instance is an object in a ROBLOX game. ROBLOX Lua has a global table called Instance for changing how objects in the game behave. The Instance table offers several functions in order to create/manipulate ROBLOX created objects. It is best known for the Instance.new() function.

Creating Instances

Creating new objects is simpler than one would guess. You can find a list of object types (called classes) in the Class Reference. To create a new Instance, you use the Instance.new() function and pass one argument - a string that refers to what class you wish to make.

print(Instance.new("Part"))

Will result in:

Part

By default, objects created with Instance.new() retain their default properties (such as new bricks being 2 by 4 studs large). Because of this, the Parent property of created objects is nil and must be set for the object to be functional in the game.

You can pass a second argument to Instance.new to set the Parent of the object created:

Instance.new("Part", workspace)

Creates a Part and sets its parent to Workspace.

Functions

Function	Description
Instance.new(val[, parent])	Returns a new object of the class named by val. The parent argument is optional; if it is supplied the object will be parented to it, if not then the object's parent will be set to nil