UniBot - 게임 자동화의 새로운 기준

📱 입력 제어 (Input)

tap(x: int, y: int) → bool 화면의 특정 좌표를 탭합니다. ▼

매개변수

`x`	int	X 좌표
`y`	int	Y 좌표

예제 코드

# 화면 중앙 탭
tap(540, 960)

# 버튼 위치 탭
if match_template("button.png"):
    tap(result["center"][0], result["center"][1])

-- 화면 중앙 탭
tap(540, 960)

-- 버튼 위치 탭
local result = match_template("button.png")
if result then
    tap(result.center[1], result.center[2])
end

// 화면 중앙 탭
tap(540, 960);

// 버튼 위치 탭
const result = match_template("button.png");
if (result) {
    tap(result.center[0], result.center[1]);
}

double_tap(x: int, y: int, interval: int = 50) → bool 화면의 특정 좌표를 더블 탭합니다. ▼

매개변수

`x`	int	X 좌표
`y`	int	Y 좌표
`interval`	int	탭 간격 (ms), 기본값 50

예제 코드

# 50ms 간격으로 더블 탭
double_tap(540, 960, 50)

# 더블 점프 구현
double_tap(540, 1500, 100)

-- 50ms 간격으로 더블 탭
double_tap(540, 960, 50)

-- 더블 점프 구현
double_tap(540, 1500, 100)

// 50ms 간격으로 더블 탭
double_tap(540, 960, 50);

// 더블 점프 구현
double_tap(540, 1500, 100);

swipe(x1: int, y1: int, x2: int, y2: int, duration: int = 200) → bool 화면에서 스와이프합니다. ▼

매개변수

`x1, y1`	int	시작 좌표
`x2, y2`	int	끝 좌표
`duration`	int	이동 시간 (ms)

예제 코드

# 아래에서 위로 스와이프 (스크롤 업)
swipe(540, 1200, 540, 600, 300)

# 좌에서 우로 스와이프
swipe(100, 960, 900, 960, 200)

-- 아래에서 위로 스와이프
swipe(540, 1200, 540, 600, 300)

-- 좌에서 우로 스와이프
swipe(100, 960, 900, 960, 200)

// 아래에서 위로 스와이프
swipe(540, 1200, 540, 600, 300);

// 좌에서 우로 스와이프
swipe(100, 960, 900, 960, 200);

long_press(x: int, y: int, duration: int = 1000) → bool 화면의 특정 좌표를 길게 누릅니다. ▼

매개변수

`x`	int	X 좌표
`y`	int	Y 좌표
`duration`	int	누르는 시간 (ms)

예제 코드

# 2초간 길게 누르기
long_press(540, 960, 2000)

-- 2초간 길게 누르기
long_press(540, 960, 2000)

// 2초간 길게 누르기
long_press(540, 960, 2000);

key_press(key: str) → bool 키를 누릅니다. ▼

매개변수

key str 키 이름 (ENTER, BACK, HOME 등)

예제 코드

# 엔터 키 누르기
key_press("ENTER")

# 뒤로가기 버튼
key_press("BACK")

-- 엔터 키 누르기
key_press("ENTER")

-- 뒤로가기 버튼
key_press("BACK")

// 엔터 키 누르기
key_press("ENTER");

// 뒤로가기 버튼
key_press("BACK");

text_input(text: str) → bool 텍스트를 입력합니다. ▼

매개변수

text str 입력할 텍스트

예제 코드

# 텍스트 입력
text_input("Hello World")

# 채팅 메시지 전송
tap(100, 1800)  # 채팅창 열기
text_input("/판매 아이템명")
key_press("ENTER")

-- 텍스트 입력
text_input("Hello World")

-- 채팅 메시지 전송
tap(100, 1800)  -- 채팅창 열기
text_input("/판매 아이템명")
key_press("ENTER")

// 텍스트 입력
text_input("Hello World");

// 채팅 메시지 전송
tap(100, 1800);  // 채팅창 열기
text_input("/판매 아이템명");
key_press("ENTER");

🖼️ 이미지 매칭 (Image)

capture() → ndarray | None 현재 화면을 캡처합니다. ▼

예제 코드

# 화면 캡처
screen = capture()
if screen is not None:
    log(f"해상도: {screen.shape[1]}x{screen.shape[0]}")

-- 화면 캡처
local screen = capture()
if screen then
    log("캡처 성공")
end

// 화면 캡처
const screen = capture();
if (screen) {
    log("캡처 성공");
}

match_template(template: str, threshold: float = 0.8, roi: tuple = None) → dict | None 화면에서 템플릿 이미지를 찾습니다. ▼

매개변수

`template`	str	템플릿 이미지 경로
`threshold`	float	매칭 임계값 (0.0 ~ 1.0)
`roi`	tuple	검색 영역 (x, y, w, h)

반환값

{"center": (x, y), "rect": (x, y, w, h), "score": float} 또는 None

예제 코드

# 버튼 찾아서 클릭
result = match_template("templates/button.png", 0.85)
if result:
    tap(result["center"][0], result["center"][1])
    log(f"매칭 점수: {result['score']:.2f}")

# 특정 영역에서만 검색
result = match_template("icon.png", roi=(0, 0, 500, 500))

-- 버튼 찾아서 클릭
local result = match_template("templates/button.png", 0.85)
if result then
    tap(result.center[1], result.center[2])
    log("매칭 점수: " .. result.score)
end

// 버튼 찾아서 클릭
const result = match_template("templates/button.png", 0.85);
if (result) {
    tap(result.center[0], result.center[1]);
    log(`매칭 점수: ${result.score.toFixed(2)}`);
}

wait_template(template: str, timeout: float = 10.0, threshold: float = 0.8) → dict | None 템플릿이 나타날 때까지 대기합니다. ▼

매개변수

`template`	str	템플릿 이미지 경로
`timeout`	float	최대 대기 시간 (초)
`threshold`	float	매칭 임계값

예제 코드

# 로딩 화면 종료 대기
result = wait_template("main_screen.png", 30.0)
if result:
    log("로딩 완료!")
else:
    log("타임아웃 - 로딩 실패")

-- 로딩 화면 종료 대기
local result = wait_template("main_screen.png", 30.0)
if result then
    log("로딩 완료!")
else
    log("타임아웃 - 로딩 실패")
end

// 로딩 화면 종료 대기
const result = wait_template("main_screen.png", 30.0);
if (result) {
    log("로딩 완료!");
} else {
    log("타임아웃 - 로딩 실패");
}

match_and_tap(template: str, threshold: float = 0.8, offset: tuple = (0, 0)) → bool 템플릿을 찾아서 탭합니다. ▼

예제 코드

# 간단하게 버튼 클릭
match_and_tap("ok_button.png", 0.85)

# 오프셋 적용 (버튼 아래쪽 클릭)
match_and_tap("header.png", offset=(0, 50))

-- 간단하게 버튼 클릭
match_and_tap("ok_button.png", 0.85)

-- 오프셋 적용 (버튼 아래쪽 클릭)
match_and_tap("header.png", 0.8, {0, 50})

// 간단하게 버튼 클릭
match_and_tap("ok_button.png", 0.85);

// 오프셋 적용 (버튼 아래쪽 클릭)
match_and_tap("header.png", 0.8, [0, 50]);

get_pixel_color(x: int, y: int) → tuple | None 특정 좌표의 픽셀 색상을 가져옵니다. ▼

예제 코드

color = get_pixel_color(100, 200)
if color:
    r, g, b = color
    log(f"RGB: {r}, {g}, {b}")

local color = get_pixel_color(100, 200)
if color then
    local r, g, b = color[1], color[2], color[3]
    log("RGB: " .. r .. ", " .. g .. ", " .. b)
end

const color = get_pixel_color(100, 200);
if (color) {
    const [r, g, b] = color;
    log(`RGB: ${r}, ${g}, ${b}`);
}

check_pixel_color(x: int, y: int, color: tuple, tolerance: int = 20) → bool 픽셀 색상이 지정 색상과 일치하는지 확인합니다. ▼

예제 코드

# HP 바 빨간색 체크
if check_pixel_color(100, 50, (255, 0, 0), 30):
    log("HP 낮음 - 포션 사용!")
    match_and_tap("potion.png")

-- HP 바 빨간색 체크
if check_pixel_color(100, 50, {255, 0, 0}, 30) then
    log("HP 낮음 - 포션 사용!")
    match_and_tap("potion.png")
end

// HP 바 빨간색 체크
if (check_pixel_color(100, 50, [255, 0, 0], 30)) {
    log("HP 낮음 - 포션 사용!");
    match_and_tap("potion.png");
}

📝 OCR (문자 인식)

ocr_read(roi: tuple = None) → str 화면 영역에서 텍스트를 읽습니다. ▼

매개변수

roi tuple 읽을 영역 (x, y, w, h), None이면 전체 화면

예제 코드

# 특정 영역에서 텍스트 읽기
text = ocr_read((100, 200, 300, 50))
log(f"읽은 텍스트: {text}")

# 전체 화면에서 읽기
full_text = ocr_read()

-- 특정 영역에서 텍스트 읽기
local text = ocr_read({100, 200, 300, 50})
log("읽은 텍스트: " .. text)

-- 전체 화면에서 읽기
local full_text = ocr_read()

// 특정 영역에서 텍스트 읽기
const text = ocr_read([100, 200, 300, 50]);
log(`읽은 텍스트: ${text}`);

// 전체 화면에서 읽기
const fullText = ocr_read();

ocr_find(text: str, roi: tuple = None) → dict | None 화면에서 특정 텍스트를 찾습니다. ▼

반환값

{"text": str, "center": (x, y), "rect": (x, y, w, h)} 또는 None

예제 코드

# "확인" 버튼 찾아서 클릭
result = ocr_find("확인")
if result:
    tap(result["center"][0], result["center"][1])

-- "확인" 버튼 찾아서 클릭
local result = ocr_find("확인")
if result then
    tap(result.center[1], result.center[2])
end

// "확인" 버튼 찾아서 클릭
const result = ocr_find("확인");
if (result) {
    tap(result.center[0], result.center[1]);
}

ocr_tap_text(text: str, roi: tuple = None) → bool 화면에서 텍스트를 찾아서 탭합니다. ▼

예제 코드

# "시작하기" 버튼 클릭
ocr_tap_text("시작하기")

# 메뉴 항목 클릭
ocr_tap_text("설정")

-- "시작하기" 버튼 클릭
ocr_tap_text("시작하기")

-- 메뉴 항목 클릭
ocr_tap_text("설정")

// "시작하기" 버튼 클릭
ocr_tap_text("시작하기");

// 메뉴 항목 클릭
ocr_tap_text("설정");

ocr_read_number(roi: tuple = None) → int | None 화면 영역에서 숫자를 읽습니다. ▼

예제 코드

# HP 수치 읽기
hp = ocr_read_number((50, 100, 100, 30))
if hp and hp < 50:
    log("HP 낮음! 포션 사용")
    match_and_tap("potion.png")

-- HP 수치 읽기
local hp = ocr_read_number({50, 100, 100, 30})
if hp and hp < 50 then
    log("HP 낮음! 포션 사용")
    match_and_tap("potion.png")
end

// HP 수치 읽기
const hp = ocr_read_number([50, 100, 100, 30]);
if (hp && hp < 50) {
    log("HP 낮음! 포션 사용");
    match_and_tap("potion.png");
}

📊 변수 관리 (Variable)

get_var(name: str, default: Any = None) → Any 변수 값을 가져옵니다. ▼

예제 코드

# 카운터 가져오기 (없으면 0)
count = get_var("loop_count", 0)
log(f"현재 카운트: {count}")

-- 카운터 가져오기 (없으면 0)
local count = get_var("loop_count", 0)
log("현재 카운트: " .. count)

// 카운터 가져오기 (없으면 0)
const count = get_var("loop_count", 0);
log(`현재 카운트: ${count}`);

set_var(name: str, value: Any) → None 변수 값을 설정합니다. ▼

예제 코드

# 카운터 증가
count = get_var("loop_count", 0)
set_var("loop_count", count + 1)

# 상태 저장
set_var("last_status", "success")

-- 카운터 증가
local count = get_var("loop_count", 0)
set_var("loop_count", count + 1)

-- 상태 저장
set_var("last_status", "success")

// 카운터 증가
const count = get_var("loop_count", 0);
set_var("loop_count", count + 1);

// 상태 저장
set_var("last_status", "success");

list_vars() → dict 모든 변수 목록을 가져옵니다. ▼

예제 코드

# 모든 변수 출력
all_vars = list_vars()
for name, value in all_vars.items():
    log(f"{name} = {value}")

-- 모든 변수 출력
local all_vars = list_vars()
for name, value in pairs(all_vars) do
    log(name .. " = " .. tostring(value))
end

// 모든 변수 출력
const allVars = list_vars();
for (const [name, value] of Object.entries(allVars)) {
    log(`${name} = ${value}`);
}

🔧 유틸리티 (Utility)

wait(seconds: float) → None 지정된 시간만큼 대기합니다. ▼

예제 코드

# 1.5초 대기
wait(1.5)

# 로딩 대기
tap(start_button_x, start_button_y)
wait(3.0)  # 로딩 완료까지 대기

-- 1.5초 대기
wait(1.5)

-- 로딩 대기
tap(start_button_x, start_button_y)
wait(3.0)  -- 로딩 완료까지 대기

// 1.5초 대기
wait(1.5);

// 로딩 대기
tap(start_button_x, start_button_y);
wait(3.0);  // 로딩 완료까지 대기

wait_random(min_sec: float, max_sec: float) → float 랜덤 시간만큼 대기합니다. ▼

예제 코드

# 0.5~1.5초 사이 랜덤 대기 (자연스러운 동작)
actual = wait_random(0.5, 1.5)
log(f"실제 대기: {actual:.2f}초")

-- 0.5~1.5초 사이 랜덤 대기 (자연스러운 동작)
local actual = wait_random(0.5, 1.5)
log(string.format("실제 대기: %.2f초", actual))

// 0.5~1.5초 사이 랜덤 대기 (자연스러운 동작)
const actual = wait_random(0.5, 1.5);
log(`실제 대기: ${actual.toFixed(2)}초`);

log(message: str, level: str = 'info') → None 로그 메시지를 출력합니다. ▼

레벨

info, warning, error, debug

예제 코드

log("작업 시작!", "info")
log("경고: HP 낮음", "warning")
log("오류 발생", "error")

log("작업 시작!", "info")
log("경고: HP 낮음", "warning")
log("오류 발생", "error")

log("작업 시작!", "info");
log("경고: HP 낮음", "warning");
log("오류 발생", "error");

notify(title: str, message: str) → bool Windows 알림을 전송합니다. ▼

예제 코드

# 중요 알림 전송
notify("경고", "HP가 50% 이하입니다!")

# 작업 완료 알림
notify("완료", "자동화 작업이 끝났습니다.")

-- 중요 알림 전송
notify("경고", "HP가 50% 이하입니다!")

-- 작업 완료 알림
notify("완료", "자동화 작업이 끝났습니다.")

// 중요 알림 전송
notify("경고", "HP가 50% 이하입니다!");

// 작업 완료 알림
notify("완료", "자동화 작업이 끝났습니다.");

screenshot(filename: str = None) → str 스크린샷을 저장합니다. ▼

예제 코드

# 에러 발생 시 스크린샷 저장
try:
    do_something()
except:
    path = screenshot("error_screen.png")
    log(f"에러 스크린샷: {path}")

-- 에러 발생 시 스크린샷 저장
local ok, err = pcall(do_something)
if not ok then
    local path = screenshot("error_screen.png")
    log("에러 스크린샷: " .. path)
end

// 에러 발생 시 스크린샷 저장
try {
    do_something();
} catch (e) {
    const path = screenshot("error_screen.png");
    log(`에러 스크린샷: ${path}`);
}

📲 디바이스 제어 (Device)

get_screen_size() → tuple 화면 해상도를 가져옵니다. ▼

예제 코드

width, height = get_screen_size()
log(f"해상도: {width}x{height}")

# 화면 중앙 좌표 계산
center_x, center_y = width // 2, height // 2

local size = get_screen_size()
log("해상도: " .. size[1] .. "x" .. size[2])

-- 화면 중앙 좌표 계산
local center_x = math.floor(size[1] / 2)
local center_y = math.floor(size[2] / 2)

const [width, height] = get_screen_size();
log(`해상도: ${width}x${height}`);

// 화면 중앙 좌표 계산
const centerX = Math.floor(width / 2);
const centerY = Math.floor(height / 2);

get_current_app() → str | None 현재 실행 중인 앱 패키지명을 가져옵니다. ▼

예제 코드

app = get_current_app()
if app == "com.nexon.maplem":
    log("메이플스토리M 실행 중")
else:
    start_app("com.nexon.maplem")

local app = get_current_app()
if app == "com.nexon.maplem" then
    log("메이플스토리M 실행 중")
else
    start_app("com.nexon.maplem")
end

const app = get_current_app();
if (app === "com.nexon.maplem") {
    log("메이플스토리M 실행 중");
} else {
    start_app("com.nexon.maplem");
}

start_app(package: str) → bool 앱을 시작합니다. ▼

예제 코드

# 게임 시작
start_app("com.nexon.maplem")
wait(10)  # 로딩 대기

-- 게임 시작
start_app("com.nexon.maplem")
wait(10)  -- 로딩 대기

// 게임 시작
start_app("com.nexon.maplem");
wait(10);  // 로딩 대기

stop_app(package: str) → bool 앱을 종료합니다. ▼

예제 코드

# 게임 강제 종료 후 재시작
stop_app("com.nexon.maplem")
wait(2)
start_app("com.nexon.maplem")

-- 게임 강제 종료 후 재시작
stop_app("com.nexon.maplem")
wait(2)
start_app("com.nexon.maplem")

// 게임 강제 종료 후 재시작
stop_app("com.nexon.maplem");
wait(2);
start_app("com.nexon.maplem");

⚙️ 매크로 제어 (Control)

pause_macro() → None 매크로 실행을 일시 중지합니다. ▼

예제 코드

# HP 위험 시 일시 중지
hp = ocr_read_number((50, 100, 100, 30))
if hp and hp < 10:
    notify("경고", "HP 위험! 수동 개입 필요")
    pause_macro()

-- HP 위험 시 일시 중지
local hp = ocr_read_number({50, 100, 100, 30})
if hp and hp < 10 then
    notify("경고", "HP 위험! 수동 개입 필요")
    pause_macro()
end

// HP 위험 시 일시 중지
const hp = ocr_read_number([50, 100, 100, 30]);
if (hp && hp < 10) {
    notify("경고", "HP 위험! 수동 개입 필요");
    pause_macro();
}

stop_macro() → None 매크로 실행을 완전히 중지합니다. ▼

예제 코드

# 오류 횟수 초과 시 중지
error_count = get_var("error_count", 0)
if error_count > 10:
    log("오류 횟수 초과, 매크로 중지", "error")
    stop_macro()

-- 오류 횟수 초과 시 중지
local error_count = get_var("error_count", 0)
if error_count > 10 then
    log("오류 횟수 초과, 매크로 중지", "error")
    stop_macro()
end

// 오류 횟수 초과 시 중지
const errorCount = get_var("error_count", 0);
if (errorCount > 10) {
    log("오류 횟수 초과, 매크로 중지", "error");
    stop_macro();
}

call_sequence(name: str) → bool 다른 시퀀스를 호출합니다. ▼

예제 코드

# HP 낮으면 회복 시퀀스 호출
hp = ocr_read_number((50, 100, 100, 30))
if hp and hp < 50:
    call_sequence("heal_routine")

# 보스 발견 시 보스 시퀀스 호출
if match_template("boss_icon.png"):
    call_sequence("boss_battle")

-- HP 낮으면 회복 시퀀스 호출
local hp = ocr_read_number({50, 100, 100, 30})
if hp and hp < 50 then
    call_sequence("heal_routine")
end

-- 보스 발견 시 보스 시퀀스 호출
if match_template("boss_icon.png") then
    call_sequence("boss_battle")
end

// HP 낮으면 회복 시퀀스 호출
const hp = ocr_read_number([50, 100, 100, 30]);
if (hp && hp < 50) {
    call_sequence("heal_routine");
}

// 보스 발견 시 보스 시퀀스 호출
if (match_template("boss_icon.png")) {
    call_sequence("boss_battle");
}

게임 자동화의새로운 기준.

눈으로 보듯 화면을 인식.

프리셋을 공유하고 함께 성장.

코딩 없이 복잡한 로직을.

모든 에뮬레이터. 하나의 도구.

직접 눈으로 확인하세요

메인 화면

자동화 규칙

블록 에디터

규칙 편집기

녹화 기능

스케줄 관리

숫자로 보는 UniBot

프리미엄으로 더 강력하게.

월간

💎 연간 (추천)

무료 vs 프리미엄

🚀 빠른 시작 가이드

다운로드 및 실행

에뮬레이터 연결

자동화 시작

📚 더 알아보기

이미지 매칭

OCR 텍스트 인식

시퀀스 매크로

스케줄 예약

🔧 스크립트 API 문서

📱 입력 제어 (Input)

매개변수

예제 코드

매개변수

예제 코드

매개변수

예제 코드

매개변수

예제 코드

매개변수

예제 코드

매개변수

예제 코드

🖼️ 이미지 매칭 (Image)

예제 코드

매개변수

반환값

예제 코드

매개변수

예제 코드

예제 코드

예제 코드

예제 코드

📝 OCR (문자 인식)

매개변수

예제 코드

반환값

예제 코드

예제 코드

예제 코드

📊 변수 관리 (Variable)

예제 코드

예제 코드

예제 코드

🔧 유틸리티 (Utility)

예제 코드

예제 코드

레벨

예제 코드

예제 코드

예제 코드

📲 디바이스 제어 (Device)

예제 코드

예제 코드

예제 코드

예제 코드

⚙️ 매크로 제어 (Control)

예제 코드

예제 코드

예제 코드

자주 묻는 질문

지금 바로 시작하세요.

이용약관

게임 자동화의
새로운 기준.

눈으로 보듯
화면을 인식.

프리셋을 공유하고
함께 성장.

코딩 없이
복잡한 로직을.

모든 에뮬레이터.
하나의 도구.