roblox-utils

Game-agnostic Roblox exploit scripting utility library and reference guide.

Battle-tested patterns extracted from real automation projects. Works across executors (MacSploit, Synapse, Fluxus, etc.) and any Roblox game.

Files

File	Description
roblox-utils.lua	All-in-one Lua utility library — drop into any project
roblox-scripting-guide.md	Comprehensive reference guide with patterns and pitfalls

What's Included

Utility Library (roblox-utils.lua)

Interaction

• clickButton(btn) — 4-method cross-executor GUI clicking (getconnections → firesignal → mousemoveabs → VIM)
• pressKey(keyCode) / pressE() — VIM key simulation
• clickWorldPart(part) — aim camera + click a 3D part
• scrollAt(x, y, direction, scrolls) — VIM mouse wheel

Movement

• safeTeleport(hrp, targetCFrame, speed) — stepped walk at walking speed (anti-cheat safe)
• desyncPause() / desyncResume() / toggleDesync() — server position desync system

Interact Menu (_interactUI)

• getInteractButtons() — snapshot all visible menu buttons
• menuHasButton(term) — check if a button exists
• clickMenuButton(terms) — click first matching button
• waitForMenuChange(prev, timeout) — verify menu advanced
• scrollInteractMenu(direction, scrolls) — scroll the menu
• closeInteractMenu() — dismiss via back button or Backspace
• findListFrame(actionName) — find _ListFrame (I_*) selection menus
• clickListFrameItem(listFrame, itemName) — select an item from a list menu

GUI

• createDumpGui(title, content, opts) — full dump window (drag, resize, copy, scroll, close)
• debugLog(msg) — multi-target logging (executor console + Roblox output + GUI panel)
• setStatus(feature, text, color) — update feature status labels

Game State

• findUIByText(parent, text) — search GUI by text content
• waitForChild(parent, name, timeout) — wait for instance to appear
• readBarPercentage(fill) — read stat bar fill percentage
• isHoldingTool() / discardHeldItem() — held item detection
• getPlayerPlot() / isOnPlot(maxDist) — player plot helpers
• findByKeywords(parent, keywords, classFilter) — keyword-based object search
• dumpTree(buf, inst, depth, maxDepth) — instance tree dumper
• isGuiVisible(desc, root) — parent-chain visibility check

Lifecycle

• toggleAntiAfk() — VirtualUser anti-AFK
• startPopupCloser(parentName, keywords) — auto-close popup frames
• protectGui(gui) — executor GUI protection
• unloadScript(gui) — clean disconnect + destroy

Usage

Concatenation (recommended): prepend roblox-utils.lua before your script. All functions are local but share scope.

Global export: uncomment the _G.RUtils = { ... } block at the bottom to access functions globally.

Disclaimer

Using exploit scripts violates Roblox Terms of Service. Use at your own risk.