Rose LuaVM

Running a script

Open the Script tab in the menu, paste your code, and press Execute. Anything your script prints — plus runtime errors with line numbers — shows up in the Script Output window, which you can open from the appbar.

Quick start

A box over every other player, with a kill switch on END.

local boxes = {}

while not iskeypressed("end") do
    local me = Players.LocalPlayer

    for _, plr in ipairs(Players:GetPlayers()) do
        if plr ~= me then
            local box = boxes[plr]
            if not box then
                box = Drawing.new("Square")
                box.Color = Color3.fromRGB(255, 80, 120)
                box.Thickness = 1
                boxes[plr] = box
            end

            local char = plr.Character
            local root = char and char:FindFirstChild("HumanoidRootPart")
            box.Visible = false

            if root then
                -- WorldToScreen always returns 2 values: (Vector2 or nil, boolean)
                local head, headOn = WorldToScreen(root.Position + Vector3.new(0, 3, 0))
                local feet, feetOn = WorldToScreen(root.Position - Vector3.new(0, 3.5, 0))

                if head and feet and (headOn or feetOn) then
                    local h = math.abs(feet.Y - head.Y)
                    local w = h * 0.5
                    box.Position = Vector2.new(head.X - w * 0.5, head.Y)
                    box.Size = Vector2.new(w, h)
                    box.Visible = true
                end
            end
        end
    end

    wait(0.03)
end

for _, box in pairs(boxes) do
    box:Remove()
end
print("Stopped.")

Environment

Three globals are kept up to date automatically, so they survive respawns and place teleports without re-caching. They are nil until the game resolves — always guard for that.

LocalPlayer, Character and Camera are not globals. Get them like this:

local lp     = Players.LocalPlayer
local char   = lp and lp.Character
local hum    = char and char:FindFirstChildOfClass("Humanoid")
local root   = char and char:FindFirstChild("HumanoidRootPart")
local camera = workspace.CurrentCamera

Instances have stable identity: two lookups of the same object give you the same value, so == works and you can use instances as table keys. getgenv() returns the globals table if you need state that persists across runs, and typeof(v) reports "Instance", "Vector3", "Vector2", "Color3", "CFrame" or "Drawing".

Compatibility helpers

A handful of extras from common script hubs that plain Lua does not ship with, added so more unmodified scripts run as-is.

Instances

Instance.new

Creates a real engine instance through the call gate (for example "Part", "Fire", "Smoke", "Sparkles", "PointLight", "ParticleEmitter"). Optional parent sets Parent in the same call. On failure it prints a short reason to Script Output and returns nil — not every class is creatable.

local root = Players.LocalPlayer.Character
    and Players.LocalPlayer.Character:FindFirstChild("HumanoidRootPart")
if not root then return end

local fire = Instance.new("Fire", root)
if fire then
    fire.Size = 8
    fire.Color = Color3.fromRGB(255, 80, 40)
    fire.SecondaryColor = Color3.fromRGB(255, 200, 60)
end

Methods

Readable properties

Every instance has Name, ClassName and Parent. Any other string key falls back to FindFirstChild, which is why char.HumanoidRootPart works.

Writable properties

Types

Four core userdata types exist: Vector3, Vector2, Color3, CFrame. There is no UDim2, Ray, Rect or BrickColor. Enum and TweenInfo are available as globals — see Services.

Operators

• Vector3 supports +, -, unary -, ==, and * / / by a number. There is no component-wise Vector3 * Vector3.
• Vector2 supports +, -, ==, and * / / by a number.
• CFrame supports * with a Vector3 or another CFrame. Anything else throws.
• Color3 has no arithmetic; use :Lerp().

Drawing

Coordinates are overlay pixels — the same space returned by WorldToScreen, GetScreenSize and getmousepos. Shapes render behind the Rose menu.

Shared properties

Per-type properties

Screen

WorldToScreen

• First value — the overlay-pixel Vector2, or nil when the point is behind the camera.
• Second value — true only when the point lands inside the visible area.

local pos, onScreen = WorldToScreen(root.Position)
if pos and onScreen then
    -- pos.X and pos.Y are overlay pixels
end

GetScreenSize

Overlay size in pixels. Returns zeros before the overlay is ready, so check for > 0 before dividing by it.

Input

Key names

"left", "right", "middle", "space", "shift", "ctrl", "alt", "tab", "escape", "home", "end", "insert", "delete", and single letters or digits like "a" or "1".

Timing

For frame loops prefer RunService.Heartbeat:Connect (see Services). For engine events that are still stubs (PlayerAdded, ChildAdded, remotes), poll with wait() — details in Signals.

Services

These globals are executor-side facades. They look like Roblox services but are driven by Rose’s Lua worker (~240 Hz when scripts are active), not by the game’s own scheduler.

Enum

Nested tables of { Name, Value } items: Enum.KeyCode (letters, digits, Space, Return, modifiers, F1–F12), Enum.UserInputType, Enum.EasingStyle, Enum.EasingDirection, Enum.PlaybackState.

RunService

local conn = RunService.Heartbeat:Connect(function(dt)
    -- runs each worker tick while connected
end)
-- later: conn:Disconnect()

UserInputService

TweenService / TweenInfo

Tweens number or Vector3 properties that the Instance bridge can write. Supports :Play(), :Cancel() and a live Completed signal. Easing covers Linear, Sine, Back, Quad, Quart, Quint and Cubic; other styles fall back toward linear. Repeat / reverse / delay fields are accepted but not fully driven yet.

Signals

Signals are userdata with :Connect / :Once / :Wait / :Fire. Connections expose :Disconnect() and .Connected.

Live (executor-driven)

• RunService.Heartbeat, Stepped, RenderStepped
• UserInputService.InputBegan / InputEnded
• BindableEvent.Event + bindable:Fire(...)
• instance:GetPropertyChangedSignal(prop) (polled each tick)
• Tween Completed

local be = Instance.new("BindableEvent")
be.Event:Connect(function(msg)
    print("got", msg)
end)
be:Fire("hello")

Stubs (never fire)

These exist so pasted scripts do not crash, but callbacks never run and :Wait() returns immediately: ChildAdded / ChildRemoved, DescendantAdded / DescendantRemoving, PlayerAdded / PlayerRemoving, CharacterAdded / CharacterRemoving, Remote OnClientEvent, ProximityPrompt.Triggered.

There is no real remote firing. For stub events, poll with wait().

bit32

Luau-compatible 32-bit bitwise library on unsigned integers: band, bor, bxor, bnot, lshift, rshift, arshift, lrotate, rrotate, extract, replace.

local flags = bit32.bor(0x01, 0x04)
print(bit32.band(flags, 0x04) ~= 0) -- true

getgc

Walks the in-game Luau heap (ScriptContext), not the executor VM. Needs a live place with a resolvable ScriptContext — lobby / menu may return an error string instead of data.

Rose API

The Rose global drives the cheat's own features from Lua. Field names are case-insensitive.

AimPart

0 Head · 1 HumanoidRootPart · 2 UpperTorso · 3 LowerTorso · 4 Left Hand · 5 Right Hand · 6 Left Upper Arm · 7 Right Upper Arm · 8 Left Upper Leg · 9 Right Upper Leg · 10 Left Foot · 11 Right Foot

Rose.GetTarget()

Returns nil, or a table with name, address and source ("aimbot" or "silent") describing whoever the cheat is currently aiming at.

HTTP & Files

HTTP

request / http_request take a table; Url is required (http:// or https://). Timeout is in seconds (clamped 1–30, default 10). On transport success the result has Success = true, StatusCode, Body and StatusMessage = "OK" — including non-2xx HTTP codes. On transport failure only Success = false and StatusMessage are set.

HttpGet / HttpService:GetAsync return the body string on 2xx, otherwise they raise a Lua error. JSON helpers cover nil / bool / number / string and tables as arrays or string-key objects (depth ≤ 32).

Files

All file access is sandboxed to the scripts folder next to the executable. Paths that try to escape it are rejected.

Output

print and warn take any number of values and send them to the Script Output window, colour-coded by level along with any uncaught errors. The standard string, table, math, utf8 and coroutine libraries are available, plus the compatibility helpers above; os, io and require are not.

Scripts

Helpers for enumerating in-game scripts and reading bytecode. These are best-effort on an external build — expect empty results when the place locks scripts down. Caps: 8 000 scripts / 120 000 nodes walked; bytecode size ≤ 16 MB.

Examples

Complete, runnable scripts. Press END to stop any of them.

1 · ESP with box, name and health bar

The full pattern: a re-run guard, a per-player drawing cache, correct WorldToScreen handling, and cleanup on exit.

-- Re-running the script shuts the previous instance down automatically.
local G = getgenv()
G.ROSE_ESP_VERSION = (G.ROSE_ESP_VERSION or 0) + 1
local myVersion = G.ROSE_ESP_VERSION

local cache = {}

local function makeEntry()
    local box = Drawing.new("Square")
    box.Thickness = 1
    box.Color = Color3.fromRGB(255, 80, 120)
    box.Visible = false

    local label = Drawing.new("Text")
    label.Size = 13
    label.Center = true
    label.Outline = true
    label.ZIndex = 2
    label.Visible = false

    local hp = Drawing.new("Line")
    hp.Thickness = 3
    hp.Visible = false

    return { box = box, label = label, hp = hp }
end

local function hide(e)
    e.box.Visible = false
    e.label.Visible = false
    e.hp.Visible = false
end

local function destroy(e)
    e.box:Remove()
    e.label:Remove()
    e.hp:Remove()
end

print("ESP running. Press END to stop.")

while myVersion == G.ROSE_ESP_VERSION do
    if iskeypressed("end") then break end

    local seen = {}
    local me = Players and Players.LocalPlayer or nil
    local list = Players and Players:GetPlayers() or {}

    for i = 1, #list do
        local plr = list[i]
        if plr ~= me then
            local e = cache[plr]
            if not e then
                e = makeEntry()
                cache[plr] = e
            end
            seen[plr] = true

            local char = plr.Character
            local root = char and char:FindFirstChild("HumanoidRootPart")

            if root then
                local pos = root.Position
                local head = WorldToScreen(pos + Vector3.new(0, 3, 0))
                local feet, feetOn = WorldToScreen(pos - Vector3.new(0, 3.5, 0))

                if head and feet then
                    local height = math.abs(feet.Y - head.Y)
                    local width  = height * 0.5
                    local left   = head.X - width * 0.5

                    e.box.Position = Vector2.new(left, head.Y)
                    e.box.Size     = Vector2.new(width, height)
                    e.box.Visible  = true

                    e.label.Text     = plr.Name
                    e.label.Position = Vector2.new(head.X, head.Y - 15)
                    e.label.Visible  = true

                    local hum = char:FindFirstChildOfClass("Humanoid")
                    if hum and hum.MaxHealth > 0 then
                        local frac = math.max(0, math.min(1, hum.Health / hum.MaxHealth))
                        local barX = left - 5
                        e.hp.From    = Vector2.new(barX, head.Y + height)
                        e.hp.To      = Vector2.new(barX, head.Y + height - height * frac)
                        e.hp.Color   = Color3.fromHSV(frac * 0.33, 1, 1)
                        e.hp.Visible = true
                    else
                        e.hp.Visible = false
                    end
                else
                    hide(e)
                end
            else
                hide(e)
            end
        end
    end

    -- Drop players who left the server.
    for plr, e in pairs(cache) do
        if not seen[plr] then
            destroy(e)
            cache[plr] = nil
        end
    end

    wait(0.03)
end

for plr, e in pairs(cache) do
    destroy(e)
    cache[plr] = nil
end
print("ESP stopped.")

2 · Feature loop with a keybind toggle

Drives the built-in aimbot and speed through the Rose table, with proper edge detection.

local G = getgenv()
G.ROSE_FEATURES_VERSION = (G.ROSE_FEATURES_VERSION or 0) + 1
local myVersion = G.ROSE_FEATURES_VERSION

local aimOn, lastToggle, lastTarget = false, false, nil

print("F = toggle aimbot | SHIFT = speed | END = quit")

while myVersion == G.ROSE_FEATURES_VERSION do
    if iskeypressed("end") then break end

    -- Edge detection: iskeypressed reports state, not events.
    local down = iskeypressed("F")
    if down and not lastToggle then
        aimOn = not aimOn
        Rose.Aimbot.Enabled = aimOn
        Rose.Aimbot.FOV     = 140
        Rose.Aimbot.AimPart = 0      -- 0 = Head
        Rose.Aimbot.Sticky  = true
        Rose.Aimbot.DrawFOV = aimOn
        print("Aimbot:", aimOn and "ON" or "OFF")
    end
    lastToggle = down

    -- Only while Roblox is focused, since iskeypressed is system-wide.
    if isrbxactive() and iskeypressed("shift") then
        Rose.Movement.WalkSpeed      = true
        Rose.Movement.WalkSpeedValue = 220
    else
        Rose.Movement.WalkSpeed = false
    end

    local t = Rose.GetTarget()
    local name = t and t.name or nil
    if name ~= lastTarget then
        lastTarget = name
        if name then
            print(string.format("Target [%s]: %s", t.source, name))
        end
    end

    wait(0.05)
end

Rose.Aimbot.Enabled = false
Rose.Aimbot.DrawFOV = false
Rose.Movement.WalkSpeed = false
print("Features off.")

3 · Persistent config

local FILE = "myconfig.txt"

local function saveConfig(fov, espOn)
    writefile(FILE, string.format("%d|%s", fov, tostring(espOn)))
    print("Saved to scripts/" .. FILE)
end

local function loadConfig()
    if not isfile(FILE) then return nil end
    local ok, raw = pcall(readfile, FILE)   -- readfile throws on failure
    if not ok then
        warn("Could not read config:", raw)
        return nil
    end
    local fov, esp = string.match(raw, "^(%d+)|(%a+)$")
    if not fov then
        warn("Corrupt config, ignoring.")
        return nil
    end
    return tonumber(fov), esp == "true"
end

local fov, espOn = loadConfig()
if fov then
    print("Loaded config:", fov, espOn)
else
    fov, espOn = 130, true
    saveConfig(fov, espOn)
end

Rose.Aimbot.FOV = fov
Rose.ESP.Master = espOn
Rose.ESP.Box    = espOn
Rose.ESP.Name   = espOn

for _, name in ipairs(listfiles()) do
    print("file:", name)
end