Cross-Reference

Block ↔ Lua API Mapping

Side-by-side reference between Visual Builder blocks and their closest Lua API equivalents. Search by either the block name or the Lua call signature; the bridge works both ways.

App evidence

Mappings are paired with real block screens

The English app reference screenshots below show how the most critical block/API mappings appear in the user interface.

Clean image block to Lua API mapping — Block to Lua API: from visual block to code equivalent
The clean screenshot shows how template, Region, and match-score fields in the block card connect to the Lua call in the table.

Clean dialog block to Lua API mapping — Block to Lua API: dialog form surface
The clean screenshot explains how text, input, and setting fields in the dialog block become a Setting.builder chain.

Visual search mapping

The Region + Asset relationship in the IMAGE row is paired with the current visual block card.

Action mapping

The CLICK block and quickTap equivalent show the same tap-on-match flow with app context.

Dialog and settings surface

The DIALOG row maps Setting.builder to the block surface with text, input, and setting fields.

Network request mapping

HTTP REQUEST shows how method, header, and body fields map to the Lua Request chain.

Realtime connection

WEBSOCKET connects the open/listen API surface to the Visual Builder block model.

IMAGESearch

Lua API equivalent

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

Searches for a template image in the given region.

TEXTSearch

Lua API equivalent

Region():findText("hedef") ya da Region():readText({profile="latin_score"})

OCR-searches for text or reads a region.

COLORSearch

Lua API equivalent

Region():findColor(0xRRGGBB, tolerans)

Searches for a specific color in the region.

MOVING COLORSearch

Lua API equivalent

Region():trackColor(0xRRGGBB)

Tracks whether a color shifts position.

MULTI DETECTIONSearch

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.

TRACK TARGETSearch

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.

OCR VALUESearch

Lua API equivalent

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

Extracts the first numeric value from an OCR read.

AI DECISIONSearch

Lua API equivalent

(Visual Builder önerisi: AI yorumlama bloklarla yapılır)

No direct Lua API; AI interpretation lives in the Visual Builder layer.

CLICKAction

Lua API equivalent

quickTap(point) ya da quickTap(region:find(...))

Performs a single tap.

SWIPEAction

Lua API equivalent

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

Swipe between two points.

WAIT (DELAY)Action

Lua API equivalent

wait(ms)

Pauses for a duration.

TOUCHTouch

Lua API equivalent

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

Raw multi-finger touch control.

TOUCH BREAKTouch

Lua API equivalent

Touch.up(finger)

Releases an active touch.

MULTI GESTURETouch

Lua API equivalent

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

Coordinates multiple fingers in a gesture.

COMPARE (IF)Flow

Lua API equivalent

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

Maps to the Lua if-else construct.

WHILEFlow

Lua API equivalent

while cond do ... end

Repeats while a condition holds.

REPEAT UNTILFlow

Lua API equivalent

repeat ... until cond

Repeats until a condition holds (at least once).

FOR EACHFlow

Lua API equivalent

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

Iterates over a collection.

SWITCH CASEFlow

Lua API equivalent

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

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

BREAKFlow

Lua API equivalent

break

Exits the enclosing loop.

CONTINUEFlow

Lua API equivalent

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

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

TRY/CATCHFlow

Lua API equivalent

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

Error catching via pcall.

RETURNFlow

Lua API equivalent

return value

Returns a value from the enclosing function.

GROUPFlow

Lua API equivalent

local function name() ... end

A callable block group (function).

GROUP CALLFlow

Lua API equivalent

name(arg1, arg2)

Calls a defined group.

ASSERTFlow

Lua API equivalent

assert(cond, "message")

Stops the script with an error if a condition fails.

COMMENTFlow

Lua API equivalent

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

Inline note that does not execute.

REPLAYFlow

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.

SMART REPLAYFlow

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.

ERROR HANDLERFlow

Lua API equivalent

pcall + Events.on("error", cb) (sandboxli ortamda)

Catches scenario errors globally.

DIALOGSystem

Lua API equivalent

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

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

SYSTEMSystem

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.

LOGSystem

Lua API equivalent

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

Writes a message to console or overlay.

NOTIFY/TOASTSystem

Lua API equivalent

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

Shows a toast or notification.

PLAY SOUNDSystem

Lua API equivalent

System.playSound(asset)

Plays a sound asset.

PANEL CONTROLSystem

Lua API equivalent

Hud:show("text") veya Hud:hide()

Controls the on-screen overlay panel.

HUD OVERLAYSystem

Lua API equivalent

Hud:show("text") / Hud:update("text")

Writes text/state into the on-screen HUD.

SET VARIABLEData

Lua API equivalent

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

Sets a variable (script-scoped or persistent).

MATH EVALData

Lua API equivalent

local r = expression  (Lua doğrudan matematik)

Computes an arithmetic or variable-based expression.

STRING OPData

Lua API equivalent

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

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

REGEX MATCHData

Lua API equivalent

s:match("pattern") veya string.gmatch(s, "pat")

Regex / Lua pattern matching.

RANDOM NUMBERData

Lua API equivalent

math.random(min, max)

Generates a random number.

DATE/TIMEData

Lua API equivalent

os.date("*t") / System.currentTime()

Reads current date or timestamp.

TIME SPANData

Lua API equivalent

System.currentTime() - startMs

Computes elapsed time between two moments.

STOPWATCHData

Lua API equivalent

local t0 = System.currentTime(); ... local dt = System.currentTime() - t0

Measures elapsed time.

SLEEP UNTILData

Lua API equivalent

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

Waits until a deadline.

KV GETData

Lua API equivalent

KV.get("key")

Reads from the persistent key/value store.

KV SETData

Lua API equivalent

KV.set("key", value)

Writes to the persistent key/value store.

CLIPBOARD READData

Lua API equivalent

Clipboard.get()

Reads the system clipboard.

CLIPBOARD WRITEData

Lua API equivalent

Clipboard.set("text")

Writes to the system clipboard.

FILE READData

Lua API equivalent

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

Sandboxed file read.

FILE WRITEData

Lua API equivalent

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

Sandboxed file write.

FILE DELETEData

Lua API equivalent

File.delete("path")

Deletes a sandboxed file or folder.

JSON PARSEData

Lua API equivalent

JSON.parse("...")

Parses JSON text into a Lua table.

COLLECTIONData

Lua API equivalent

local list = {1, 2, 3}; table.insert(list, 4)

Manages an ordered list/array.

MAPData

Lua API equivalent

local m = {key = "value"}; m.key

Manages a key/value map.

HTTP GETAdvanced

Lua API equivalent

Request.get(url)

Sends a GET request.

HTTP POSTAdvanced

Lua API equivalent

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

Sends a POST request.

HTTP PUTAdvanced

Lua API equivalent

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

Sends a PUT request.

HTTP REQUESTAdvanced

Lua API equivalent

Request.method(method, url):setHeader(...):setBody(...):send()

Fully parameterized HTTP request.

WEBSOCKETAdvanced

Lua API equivalent

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

Opens a WebSocket and listens for messages.

TIMER INTERVALAdvanced

Lua API equivalent

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

Periodic timer.

CUSTOM CODEAdvanced

Lua API equivalent

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

Embeds a raw Lua block inside the visual chain.

Block	Lua API equivalent	Note
`IMAGE` Search	Region():find(Asset.image("name"))	Searches for a template image in the given region.
`TEXT` Search	Region():findText("hedef") ya da Region():readText({profile="latin_score"})	OCR-searches for text or reads a region.
`COLOR` Search	Region():findColor(0xRRGGBB, tolerans)	Searches for a specific color in the region.
`MOVING COLOR` Search	Region():trackColor(0xRRGGBB)	Tracks whether a color shifts position.
`MULTI DETECTION` Search	(Visual Builder only: combines multiple IMAGE/TEXT/COLOR targets into one decision block)	Combines multiple IMAGE/TEXT/COLOR targets into one decision block.
`TRACK TARGET` Search	(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.
`OCR VALUE` Search	tonumber((Region():readText():match("(%d[%d.]*)")))	Extracts the first numeric value from an OCR read.
`AI DECISION` Search	(Visual Builder önerisi: AI yorumlama bloklarla yapılır)	No direct Lua API; AI interpretation lives in the Visual Builder layer.
`CLICK` Action	quickTap(point) ya da quickTap(region:find(...))	Performs a single tap.
`SWIPE` Action	swipe({GesturePoint(start, 0, 0), GesturePoint(end, 0, 300)})	Swipe between two points.
`WAIT (DELAY)` Action	wait(ms)	Pauses for a duration.
`TOUCH` Touch	Touch.down(point, finger); Touch.move(point, finger); Touch.up(finger)	Raw multi-finger touch control.
`TOUCH BREAK` Touch	Touch.up(finger)	Releases an active touch.
`MULTI GESTURE` Touch	Touch.dispatch({...}) (cok parmakli koordineli hareket)	Coordinates multiple fingers in a gesture.
`COMPARE (IF)` Flow	if a == b then ... else ... end	Maps to the Lua if-else construct.
`WHILE` Flow	while cond do ... end	Repeats while a condition holds.
`REPEAT UNTIL` Flow	repeat ... until cond	Repeats until a condition holds (at least once).
`FOR EACH` Flow	for i, v in ipairs(t) do ... end	Iterates over a collection.
`SWITCH CASE` Flow	if/elseif zinciri (Lua'da native switch yok)	Lua has no native switch; equivalent via if/elseif chain.
`BREAK` Flow	break	Exits the enclosing loop.
`CONTINUE` Flow	goto continue / ::continue:: (Lua'da continue keyword'u yoktur)	Lua has no continue keyword; emulated via goto + label.
`TRY/CATCH` Flow	local ok, err = pcall(function() ... end)	Error catching via pcall.
`RETURN` Flow	return value	Returns a value from the enclosing function.
`GROUP` Flow	local function name() ... end	A callable block group (function).
`GROUP CALL` Flow	name(arg1, arg2)	Calls a defined group.
`ASSERT` Flow	assert(cond, "message")	Stops the script with an error if a condition fails.
`COMMENT` Flow	-- single-line veya --[[ block ]]	Inline note that does not execute.
`REPLAY` Flow	(Visual Builder önerisi: kayıtlı aksiyon zincirini yeniden yürütür)	No direct Lua API; record/replay lives in the Visual Builder layer.
`SMART REPLAY` Flow	(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.
`ERROR HANDLER` Flow	pcall + Events.on("error", cb) (sandboxli ortamda)	Catches scenario errors globally.
`DIALOG` System	Setting.builder():addText(...):addInput(...):show()	Shows a dynamic dialog with text, input, and setting fields.
`SYSTEM` System	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.
`LOG` System	System.log("text") veya toast("text")	Writes a message to console or overlay.
`NOTIFY/TOAST` System	toast("text") veya System.noti("title", "body")	Shows a toast or notification.
`PLAY SOUND` System	System.playSound(asset)	Plays a sound asset.
`PANEL CONTROL` System	Hud:show("text") veya Hud:hide()	Controls the on-screen overlay panel.
`HUD OVERLAY` System	Hud:show("text") / Hud:update("text")	Writes text/state into the on-screen HUD.
`SET VARIABLE` Data	local x = value (script-scoped) veya KV.set("name", value) (kalici)	Sets a variable (script-scoped or persistent).
`MATH EVAL` Data	local r = expression (Lua doğrudan matematik)	Computes an arithmetic or variable-based expression.
`STRING OP` Data	string.upper / string.sub / string.format ...	String operations (lower, upper, replace, etc.).
`REGEX MATCH` Data	s:match("pattern") veya string.gmatch(s, "pat")	Regex / Lua pattern matching.
`RANDOM NUMBER` Data	math.random(min, max)	Generates a random number.
`DATE/TIME` Data	os.date("*t") / System.currentTime()	Reads current date or timestamp.
`TIME SPAN` Data	System.currentTime() - startMs	Computes elapsed time between two moments.
`STOPWATCH` Data	local t0 = System.currentTime(); ... local dt = System.currentTime() - t0	Measures elapsed time.
`SLEEP UNTIL` Data	while System.currentTime() < deadline do wait(50) end	Waits until a deadline.
`KV GET` Data	KV.get("key")	Reads from the persistent key/value store.
`KV SET` Data	KV.set("key", value)	Writes to the persistent key/value store.
`CLIPBOARD READ` Data	Clipboard.get()	Reads the system clipboard.
`CLIPBOARD WRITE` Data	Clipboard.set("text")	Writes to the system clipboard.
`FILE READ` Data	File.read("path") (sandbox sınırları içinde)	Sandboxed file read.
`FILE WRITE` Data	File.write("path", "content")	Sandboxed file write.
`FILE DELETE` Data	File.delete("path")	Deletes a sandboxed file or folder.
`JSON PARSE` Data	JSON.parse("...")	Parses JSON text into a Lua table.
`COLLECTION` Data	local list = {1, 2, 3}; table.insert(list, 4)	Manages an ordered list/array.
`MAP` Data	local m = {key = "value"}; m.key	Manages a key/value map.
`HTTP GET` Advanced	Request.get(url)	Sends a GET request.
`HTTP POST` Advanced	Request.post(url):setBody(body):send()	Sends a POST request.
`HTTP PUT` Advanced	Request.put(url):setBody(body):send()	Sends a PUT request.
`HTTP REQUEST` Advanced	Request.method(method, url):setHeader(...):setBody(...):send()	Fully parameterized HTTP request.
`WEBSOCKET` Advanced	WebSocket.open(url); WebSocket.on("message", cb)	Opens a WebSocket and listens for messages.
`TIMER INTERVAL` Advanced	Async.every(ms, function() ... end)	Periodic timer.
`CUSTOM CODE` Advanced	(Lua scripti doğrudan çalıştırır)	Embeds a raw Lua block inside the visual chain.