# Environment Specific Globals

Here’s a quick, no-nonsense rundown of global objects, functions, and properties you get in Matcha LuaVM (yeah, that’s the one with the extra restrictions, no shenanigans like getgenv or hookfunction). This is your toolbox—use it well.


# Global Objects

Name Type Description
game Instance The root of everything—think DataModel in Roblox.
workspace Instance All visible stuff in-game lives here.

# Instance Methods & Properties

Name / Signature Description
Instance.Name The name of this instance.
Instance:FindFirstChild(childName) Returns the first child with the name, or nil if not found.
Instance:FindFirstChildOfClass(className) Returns the first child of the given class, or nil.
Instance:GetService(serviceName) Gets a service by name (usually from game).
Instance:GetFullName() Full hierarchical name as a string.
Instance:GetChildren() Array with all direct children.
Instance:GetPlayers() Array with all player instances.
Instance:GetDescendants() Array with all descendants (children, grandkids, etc.).

# Key Global Functions

Signature Description
printl(...) Like print, but spicier. Dumps arguments to console.
wait(seconds) Halts script for the given time (returns actual waited).
setclipboard(text) Puts text on your clipboard.
messagebox(text) Pops up a message box. Returns user’s response.

# Input & Automation

Signature Description
isrbxactive() True if window is focused, false if not.
keypress(keyCode) Simulates key press.
keyrelease(keyCode) Simulates key release.
mouse1click() / mouse1press() / mouse1release() Left mouse click/press/release.
mouse2click() / mouse2press() / mouse2release() Right mouse click/press/release.
mousescroll(delta) Scrolls mouse wheel by delta.
mousemoverel(x, y) Moves mouse relative to its current position.
mousemoveabs(x, y) Moves mouse to absolute screen coords.

# Workspace & Camera

Property Description
Workspace.CurrentCamera The active camera instance.
Camera.FieldOfView Gets/Sets the camera’s FOV (number).

# Humanoid & Player Stuff

Property Description
Humanoid.WalkSpeed (number) Sets how fast the humanoid walks.
Humanoid.JumpPower (number) Sets jump power.
Humanoid.JumpHeight (number) Sets jump height.
Humanoid.Sit (boolean) Makes the character sit/stand.
Players.LocalPlayer The local player instance.
Player.Character The player’s character model.

# BasePart Stuff

Property Description
Part.Position (Vector3) 3D position of the part.
Part.CFrame (CFrame) 3D transformation matrix of the part.
Part.CanCollide (boolean) If true, part is solid.

# Userdata & Types

Name Description
Vector2(x, y) 2D vectors, often for screen positions.
Vector3(x, y, z) 3D vectors, world positions and such.
Color3(r, g, b) Color values (0-1 floats).

Metamethods

  • __index (getter): Supports <Vector3> BasePart.Position etc.
  • __newindex (setter): Set values for Vector3/CFrame properties.

# Utility

Signature Description
WorldToScreen(Vector3 pos) Converts 3D world coordinates to 2D screen XY.
iskeypressed(kc) True if key is currently held down.
ismouse1pressed() True if left mouse button is held.