README.md

MetaInstance

This module allows you to easily edit instances in Luau!

Made by hello_123991

Installation

You can just copy the code from MetaInstance.lua and put it into a new file named "MetaInstance.lua". Then in order to use it, just enter the following:

local MetaInstance = require("MetaInstance")

Here is a quick example of using this:

local Part = MetaInstance.new("Part")

Part.Parent(workspace)
	.Color(Color3.fromRGB(255,0,255))
	.Position(Vector3.new(0, 5, 0))
	.Anchored(true)
	.On("Touched")(function(t)
		Part.Tweener.Position {
			Value = Vector3.new(math.random(1, 25), math.random(1, 25), math.random(1, 25)),
			Duration = 3,
			Style = "Sine"
		}
		.Size{
			Value = Vector3.new(5, 5, 5),
			Duration = 1,
			Style = "Bounce"
		}
		.Then("Color") {
			Value = Color3.fromRGB(math.random(1, 255), math.random(1, 255), math.random(1, 255)),
			Duration = 5,
			Style = "Sine"
		}
	end)

Creating a MetaInstance

You can do this easily by entering the following:

MetaInstance.new(<Instance | string> object)

If you want to start with a new object, you would enter the following:

MetaInstance.new("ClassName")

If you want to use an object that is already created, you would enter the following:

MetaInstance.new(path.to.object)

Changing Properties

You can change properties quickly by entering the following:

<Object>.Property1(<any> Value1)
.Property2(<any> Value2)
.Property3(<any> Value3)
...

Connections

You can add connections (like MouseButton1Click, Touched, etc.) by entering the following:

<Object>.On(<string> connection)

Changed Connections

You can execute code when a specific property changes by using On[Property]Changed. (Not case-sensitive.)

Example:

<Object>.OnTextChanged(function()
	print("Text Changed!")
end)

You can execute code when any property of the object changes by entering the following:

<Object>.OnChanged(<function> func)

Tweener

This module comes with its own tween system! You can use this feature by entering the following:

<Object>.Tweener.Property1 {
	Value = <any>,
	Duration = <number>,
	Style = <string | EnumItem>,
	Direction = <string | EnumItem>,
	RepeatCount = <number>,
	Reverses = <boolean>,
	DelayTime = <number>
}

*Value and Duration are required

You can tween multiple properties by entering the following:

<Object>.Tweener.Property1 {
	Value = <any>,
	Duration = <number>,
	Style = <string | EnumItem>,
	Direction = <string | EnumItem>,
	RepeatCount = <number>,
	Reverses = <boolean>,
	DelayTime = <number>
}
.Property2 {
	Value = <any>,
	Duration = <number>,
	Style = <string | EnumItem>,
	Direction = <string | EnumItem>,
	RepeatCount = <number>,
	Reverses = <boolean>,
	DelayTime = <number>
}

You can do a tween after the first tween is completed by entering the following:

<Object>.Property1 {
	Value = <any>,
	Duration = <number>,
	Style = <string | EnumItem>,
	Direction = <string | EnumItem>,
	RepeatCount = <number>,
	Reverses = <boolean>,
	DelayTime = <number>
}
.Then(<string> Property2) {
	Value = <any>,
	Duration = <number>,
	Style = <string | EnumItem>,
	Direction = <string | EnumItem>,
	RepeatCount = <number>,
	Reverses = <boolean>,
	DelayTime = <number>
}

Misc

Clones

You can clone an object by entering the following:

<Object>:Clone(<void>) -- Now will be changing properties for the clone and not the actual object

Here is an example:

MetaInstance.new("Part")
.Name("Part1")
.Color(Color3.fromRGB(255, 0, 255))
:Clone()
.Name("Clone1")
.Color(Color3.fromRGB(0, 255, 0))

Children

You can get the children of your object by using

<Object>.Children

You can get the descendants of your object by using

<Object>.Descendants

Attributes

You can get and set attributes of your object.

Getting

You can get an attribute of your object by doing

<Object>.Attribute("AttributeName")

You can get all of your object's attributes by entering the following:

<Object>.Attributes

Setting

You can set an attribute of your object by entering the following:

<Object>.SetAttribute("AttributeName", "Value")

You can set multiple attributes of your object at once by entering the following:

<Object>.SetAttributes{
	"AttributeName1" = "Value1",
	"AttributeName2" = "Value2"
}

Instance

You can get the in-game instance by using

<Object>.Instance

Notes

By the way, none of this is case-sensitive! There is no difference from doing

<Object>.Parent(workspace)

vs

<Object>.PaReNt(workspace)

This is very new so there there may be many bugs! Let me know any suggestions as well!