Block ↔ Lua API Mapping

Lua API equivalent

Region():find(Asset.image("name"))

Searches for a template image in the given region.

Lua API equivalent

Region():findText("hedef") ya da Region():readText({ocrScript="latin", mScore=0.8})

OCR-searches for text or reads a region.

Lua API equivalent

Region():find(Asset.color("#RRGGBB"):mScore(score))

Searches for a specific color in the region.

Lua API equivalent

compare repeated Region():find(Asset.color("#RRGGBB")) positions

Tracks whether a color shifts position.

Lua API equivalent

(Visual Builder only: combines multiple IMAGE/TEXT/COLOR targets into one decision block)

Combines multiple IMAGE/TEXT/COLOR targets into one decision block.

Lua API equivalent

(Visual Builder only: locks onto one IMAGE/TEXT/COLOR match, then tracks nearest continuation until lost-frame limit)

Locks onto one image/text/color match and tracks the nearest continuation candidate until the lost-frame limit is reached.

Lua API equivalent

tonumber((Region():readText():match("(%d[%d.]*)")))

Extracts the first numeric value from an OCR read.

Lua API equivalent

local text = Region():readText(param); local r = AI.ask(prompt .. text, providerId)

Reads a region via OCR, then turns the text into a decision with AI.ask.

Lua API equivalent

Capture.regionToBase64(region, "jpeg", 60) + AI.askVision(prompt, image, providerId, "image/jpeg", nil, timeoutMs)

Turns a selected screen region into a true/false/unknown/error visual AI decision.

Lua API equivalent

click(Point(x, y), {repeatCount=1, holdMs=0}) ya da click(Region():find(...), param)

Taps a point or a match; supports repeat and hold parameters.

Lua API equivalent

swipe({GesturePoint(start, 0, 0), GesturePoint(end, 0, 300)})

Swipe between two points.

Lua API equivalent

wait(ms)

Pauses for a duration.

Lua API equivalent

Touch.down(point, finger); Touch.move(point, finger); Touch.up(finger)

Raw multi-finger touch control.

Lua API equivalent

Touch.up(finger)

Releases an active touch.

Lua API equivalent

Touch.dispatch({...}) (cok parmakli koordineli hareket)

Coordinates multiple fingers in a gesture.

Lua API equivalent

local ok = (a and b) or c

Combines compare conditions with AND/OR into one boolean result.

Lua API equivalent

if cond then ... else ... end

Runs the TRUE or FALSE branch based on a condition.

Lua API equivalent

if a == b then ... else ... end

Maps to the Lua if-else construct.

Lua API equivalent

while cond do ... end

Repeats while a condition holds.

Lua API equivalent

repeat ... until cond

Repeats until a condition holds (at least once).

Lua API equivalent

for i, v in ipairs(t) do ... end

Iterates over a collection.

Lua API equivalent

if/elseif zinciri (Lua'da native switch yok)

Lua has no native switch; equivalent via if/elseif chain.

Lua API equivalent

break

Exits the enclosing loop.

Lua API equivalent

goto continue / ::continue:: (Lua'da continue keyword'u yoktur)

Lua has no continue keyword; emulated via goto + label.

Lua API equivalent

local ok, err = pcall(function() ... end)

Error catching via pcall.

Lua API equivalent

return value

Returns a value from the enclosing function.

Lua API equivalent

local function name() ... end

A callable block group (function).

Lua API equivalent

name(arg1, arg2)

Calls a defined group.

Lua API equivalent

(Visual Builder only: mutates group event-state gates before GROUP_CALL)

Controls group Event key gates with enable, disable, toggle, reset, or enable_only before group calls.

Lua API equivalent

Macro.run(target, params) ya da sonuc = Macro.runWait(target, params, timeoutMs)

Starts another saved macro; in wait mode it stores the outcome in a variable.

Lua API equivalent

assert(cond, "message")

Stops the script with an error if a condition fails.

Lua API equivalent

-- single-line  veya  --[[ block ]]

Inline note that does not execute.

Lua API equivalent

(Visual Builder önerisi: kayıtlı aksiyon zincirini yeniden yürütür)

No direct Lua API; record/replay lives in the Visual Builder layer.

Lua API equivalent

(Visual Builder önerisi: görsel anchor doğrulanırsa kayıtlı aksiyon zincirini yürütür)

No direct Lua API; anchor-gated replay lives in the Visual Builder layer.

Lua API equivalent

local ok, err = pcall(function() ... end); if not ok then System.log("Error: " .. tostring(err)) end

Wraps the enclosed steps in pcall, catching and logging any error.

Lua API equivalent

Metrics.summary(); Metrics.enable(); Metrics.disable(); Metrics.reset()

Manages runtime metrics with summary, enable, disable, and reset actions.

Lua API equivalent

Setting.builder():addText(...):addInput(...):show()

Shows a dynamic dialog with text, input, and setting fields.

Lua API equivalent

System.* (currentTime, schedule, log, noti, sendIntent, vb.)

Safe wrapper over system calls; Send Intent emits System.sendIntent(action, package?) and still passes runtime allowlist policy.

Lua API equivalent

System.log("text") veya toast("text")

Writes a message to console or overlay.

Lua API equivalent

toast("text") veya System.noti("title", "body")

Shows a toast or notification.

Lua API equivalent

Request(url):setContentType("application/json"):setBody(JSON.stringify({content=mesaj})):post()  (Discord/Telegram/Generic preset)

Sends a notification to a Discord, Telegram, or generic webhook over HTTPS POST; built on the HTTP_POST infrastructure with no new Lua API.

Lua API equivalent

System.playMedia(asset)

Plays a sound asset.

Lua API equivalent

local hud = Hud(x,y,w,h,false); hud:setText("text"); hud:show(); hud:hidden(true)

Controls the on-screen overlay panel.

Lua API equivalent

local hud = Hud(x,y,w,h,false); hud:setText("text"); hud:show(); hud:setText("updated")

Writes text/state into the on-screen HUD.

Lua API equivalent

local list = {"a", "b", "c"}

Stores line- or comma-separated values as a list variable.

Lua API equivalent

local x = value (script-scoped) veya KV.set("name", value) (kalici)

Sets a variable (script-scoped or persistent).

Lua API equivalent

local r = expression  (Lua doğrudan matematik)

Computes an arithmetic or variable-based expression.

Lua API equivalent

string.upper / string.sub / string.format ...

String operations (lower, upper, replace, etc.).

Lua API equivalent

Regex.match("h.*o", "hello") veya Regex.matchAll(pattern, s)

Matches with Java-syntax regex (not Lua patterns).

Lua API equivalent

math.random(min, max)

Generates a random number.

Lua API equivalent

DateTime.nowMs() veya DateTime.format(DateTime.now(), "yyyy-MM-dd")

Reads current date or timestamp.

Lua API equivalent

TimeSpan.fromSeconds(5) veya TimeSpan.fromMs(endMs - startMs)

Computes elapsed time between two moments.

Lua API equivalent

local sw = Stopwatch(); sw:start(); ... local dt = sw:elapsedMs()

Measures elapsed time.

Lua API equivalent

while System.currentTime() < deadline do wait(50) end

Waits until a deadline.

Lua API equivalent

KV.get("key")

Reads from the persistent key/value store.

Lua API equivalent

KV.set("key", value)

Writes to the persistent key/value store.

Lua API equivalent

Clipboard.get()

Reads the system clipboard.

Lua API equivalent

Clipboard.copy("text")

Writes to the system clipboard.

Lua API equivalent

File.read("path") (sandbox sınırları içinde)

Sandboxed file read.

Lua API equivalent

File.write("path", "content")

Sandboxed file write.

Lua API equivalent

File.delete("path")

Deletes a sandboxed file or folder.

Lua API equivalent

JSON.parse("...")

Parses JSON text into a Lua table.

Lua API equivalent

Collection.put("items", "id", {name="value"}); Collection.list("items")

Manages an ordered document collection.

Lua API equivalent

local m = Map(); m:put("key", "value"); m:get("key")

Manages a key/value map.

Lua API equivalent

Request.get(url)

Sends a GET request.

Lua API equivalent

Request(url):setBody(body):post()

Sends a POST request.

Lua API equivalent

Request(url):setBody(body):put()

Sends a PUT request.

Lua API equivalent

Request(url):setHeader(...):setBody(...):post()

Fully parameterized HTTP request.

Lua API equivalent

WebSocket.connect(url); WebSocket.on("message", cb)

Opens a WebSocket and listens for messages.

Lua API equivalent

Async.every(ms, function() ... end)

Periodic timer.

Lua API equivalent

(Lua scripti doğrudan çalıştırır)

Embeds a raw Lua block inside the visual chain.