New Instances

Fusion provides a New function when you're hydrating newly-made instances. It creates a new instance, applies some default properties, then hydrates it with a property table.

local message = scope:Value("Hello there!")

local ui = scope:New "TextLabel" {
    Name = "Greeting",
    Parent = PlayerGui.ScreenGui,

    Text = message
}

print(ui.Name) --> Greeting
print(ui.Text) --> Hello there!

message:set("Goodbye friend!")
task.wait() -- important: changes are applied on the next frame!
print(ui.Text) --> Goodbye friend!

Usage¶

The New function is called in two parts. First, call the function with the type of instance, then pass in the property table:

local instance = scope:New("Part")({
    Parent = workspace,
    Color = Color3.new(1, 0, 0)
})

If you're using curly braces {} for your properties, and quotes '' "" for your class type, the extra parentheses () are optional:

-- This only works when you're using curly braces {} and quotes '' ""!
local instance = scope:New "Part" {
    Parent = workspace,
    Color = Color3.new(1, 0, 0)
}

By design, New works just like Hydrate - it will apply properties the same way. See the Hydrate tutorial to learn more.

Default Properties¶

When you create an instance using Instance.new(), Roblox will give it some default properties. However, these tend to be outdated and aren't useful for most people, leading to repetitive boilerplate needed to disable features that nobody wants to use.

The New function will apply some of it's own default properties to fix this. For example, by default borders on UI are disabled, automatic colouring is turned off and default content is removed.

Showing the difference between a text label made with Instance.new and Fusion's New function.

For a complete list, take a look at Fusion's default properties file.