Roblox Engine API Expander v2

[010DevX101 (DevX)]

Roblox Engine API Expander v2

Overview

This is a completely reworked version of the original API expander I made some time ago, you can still find the old one in this thread.

Hello everyone! While developing on Roblox Studio, I stumbled upon an issue when trying to use methods in instances which I believed should be there by default, methods such as WaitForChildWhichIsA or GetChildrenOfClass. These methods don’t exist by default and I believe they should be there without any extra steps.

That’s why I decided to make this simple module. As its title says, it expands the methods provided by the Engine API, specifically methods that can be used on all kinds of instances, adding the methods mentioned before and more.

Features

• WaitForChildWhichIsA method.
• GetDescendantsWhichAre method.
• GetDescendantsOfClass method.
• GetChildrenOfClass method.
• GetChildrenWhichAre method.

• FindFirstSibling method.
• IsSiblingOf method.
• FindFirstSiblingWhichIsA method.
• FindFirstSiblingOfClass method.
• GetSiblings method.
• .SiblingRemoved signal.
• .SiblingAdded signal.

Now you can directly call methods from instances instead of having to pass the instance as a parameter:

local Instances = require(script.Parent.Parent)
local workspace = Instances:Register(workspace)
print(workspace:GetChildrenWhichAre("ModuleScript"))

The source code can be found open source on GitHub and can be simply imported into Roblox Studio using the following model .

Feel free to contribute by making a pull request in the GitHub repository.

Any feedback is appreciated, I hope this module is useful and solves the following issue.

[SkidXXE (Bagel)]

these should be in the engine already, crazy how sometimes ppl gotta make new features themselves lol

[shadowflame63 (MiniiMann)]

I tried to make a pull request but I’m not familiar with GitHub so I’ll just mention it here.

I recently came across an engine feature request called ‘API to get humanoid from basepart’ and came up with these API ideas:

API to get humanoid from basepart

Now that you mention it, this is a bit odd. We have a way to look down hierarchy: Instance:FindFirstChild() A way to look down recursively: Instance:FindFirstChild(name, true) & Instance:FindFirstDescendant() (Not enabled as of now) A way to look up: Instance.Parent And a way to look up recursively: Instance:FindFirstAncestor() But we don’t have dedicated API for looking on the same plane of hierarchy. Now it’s not too difficult to make these as custom functions, plus FindFirstChild & Find…

If you want, you can take this and incorporate it into your module since I think it ties in pretty well.

[batteryday]

@010DevX101

• FindFirstDescendant method (Should only be used if FindFirstDescendant gets disabled).
• GetDescendants method (Should only be used if GetDescendants gets disabled).

These two already exist in Roblox API

• FindFirstChild(name,true)
• GetDescendants()

[010DevX101 (DevX)]

I know but sometimes some methods get disabled for some reason, that’s why I provide an alternative if they are disabled. From what I know FindFirstDescendant is fully disabled now so FindFirstChild recursive should be used instead.

[010DevX101 (DevX)]

Thanks for the feedback, I’ll add it soon.

[010DevX101 (DevX)]

Update

Added Dependencies

• Added GoodSignal for custom RBXScriptSignals.

Bug Fixes

• Fixed bug when HTTP requests are disabled.

Added Methods

• Added FindFirstSibing method.
• Added IsSiblingOf method.
• Added FindFirstSiblingWhichIsA method.
• Added FindFirstSiblingOfClass method.
• Added GetSiblings method.

[GameInspectors]

@010DevX101

GetDescendants method (Should only be used if GetDescendants gets disabled).

It internally uses GetDescendants so it won’t work if GetDescendants gets disabled

[010DevX101 (DevX)]

Mb, that was meant to call the GetDescendants function recursively. I should call GetChildren recursively instead.

[GameInspectors]

Not to mention, FindFirstDescendant is more of a wrapper of FindFirstChild

[010DevX101 (DevX)]

Update

Added Examples

• Added examples for .SiblingAdded and .SiblingRemoved.

Removed Methods

• Removed FindFirstDescendant, use FindFirstChild recursively instead.
• Removed GetDescendants

[2jammers (james)]

Why would GetDescendants be disabled if it used widely by everyone?

[010DevX101 (DevX)]

FindFirstDescendant got deprecated and it was widely used by everyone

[2jammers (james)]

FindFirstDescendant was always disabled in the first place.

[010DevX101 (DevX)]

I don’t remember tho, I’ve used FindFirstDescendant in the past and it wasn’t disabled.

[2jammers (james)]

Always been disabled from the start. That’s not how versioning works if you think that GetDescendants will be removed. That’s like saying ffc will be removed because something is disabled.

[010DevX101 (DevX)]

And that is why I removed the GetDescendants function I made.

[GameInspectors]

It is completely up to the user to use the latest version or the older version so I don’t see why it’s a problem, You aren’t being forced to use the latest version unless you are using a package which this model isn’t

[shadowflame63 (MiniiMann)]

Awesome to see you added all the Sibling functions, and sorry I didn’t reply to your private message, I’ve only just noticed it.

If you wanted, you could add GetSiblingsOfClass & GetSiblingsWhichAre since you have them for Children and Descendants.

Also, there’s a typo with FindFirstSibling missing an L. It’s not in the code though, only your post and GitHub page.

[010DevX101 (DevX)]

My bad, didn’t notice the Sibling part.