okya for MapleStory
한국어
English한국어日本語简体中文繁體中文EspañolPortuguêsไทยTiếng Việt
가이드 메뉴⌄
홈›제품 가이드

01 · 제품 소개

로컬 데스크톱 자동화

메이플스토리 클래식 자동사냥 도구

okya for MapleStory는 화면 이미지 인식과 로컬 키 입력을 사용해 반복 사냥, 파밍, 레벨업을 자동화합니다. 캐릭터와 몬스터 템플릿을 직접 만들고 맵에 맞는 전략을 선택할 수 있습니다.

지원 플랫폼
Windows 10/11 · Apple Silicon Mac
게임 화면
1366 × 768
처리 방식
로컬 화면 인식

반복 사냥을 위한 설정형 메이플스토리 도구#

데스크톱 클라이언트는 계정 비밀번호를 요구하지 않고 화면에 보이는 게임 창을 읽습니다. 캐릭터, 선택한 몬스터, 미니맵 위치와 HP/MP 영역을 인식한 뒤 저장한 전략과 키 설정을 실행합니다. 템플릿과 일반 설정은 기기에 로컬로 저장됩니다.

데스크톱 클라이언트의 자동화 기능#

먼저 최소 구성으로 인식을 확인한 후 실행 로그를 보면서 선택 기능을 하나씩 활성화하세요.

캐릭터·몬스터 인식

캐릭터와 대상 몬스터의 좌우 방향 이미지 템플릿을 만들어 화면에 보이는 대상을 찾습니다.

사냥 및 파밍 경로

제자리 공격, 두 지점 순찰, 맵 편집기로 직접 만든 다층 맵 경로를 선택할 수 있습니다.

자동 물약 및 버프

HP/MP 기준값, 물약 키와 재사용 간격, 최대 5개의 시간 기반 버프 슬롯을 설정합니다.

줍기 및 전투 제어

공격, 점프, 아이템 줍기, 방향 전환과 전략별 동작 간격을 한 화면에서 구성합니다.

실행 로그와 시작 점검

전략 실행 전에 게임 창, 미니맵, 캐릭터, 몬스터, HP/MP 인식 결과를 확인합니다.

로컬 프로필과 경로

설정, 사용자 템플릿과 맵 경로 파일을 로컬에 저장해 반복 테스트하고 조정할 수 있습니다.

시작 전 준비 사항#

  • 64비트 Windows 10/11 또는 Apple Silicon(M 시리즈) Mac
  • 미니맵을 표시한 1366 × 768 메이플스토리 화면
  • macOS의 손쉬운 사용 및 화면 및 시스템 오디오 녹음 권한
  • 유효한 라이선스와 최초 활성화를 위한 네트워크 연결
  • 실제로 사용할 운영체제와 게임 환경에서 캡처한 템플릿

메이플스토리 클래식 자동사냥 FAQ#

Windows와 macOS를 모두 지원하나요?+

현재 클라이언트는 64비트 Windows 10/11과 Apple Silicon Mac을 지원합니다. Intel Mac용 패키지는 제공하지 않습니다.

왜 1366 × 768이 필요한가요?+

게임 창, 미니맵, HP/MP 인식 영역이 1366 × 768 화면에 맞춰져 있어 다른 해상도에서는 시작 점검에 실패할 수 있습니다.

메이플스토리 계정 비밀번호가 필요한가요?+

필요하지 않습니다. 화면과 로컬 키 설정으로 작동합니다. 계정 비밀번호나 license.dat 파일을 고객 지원에 보내지 마세요.

처음에는 어떤 전략을 사용해야 하나요?+

몬스터 템플릿 1개와 제자리 공격으로 시작하고 선택 기능은 끄세요. 인식이 안정되면 물약, 버프, 줍기 또는 경로 이동을 추가합니다.

Windows와 Mac에서 템플릿을 공유할 수 있나요?+

설정과 경로 파일은 백업할 수 있지만 렌더링 차이가 있을 수 있으므로 대상 시스템에서 캐릭터와 몬스터 템플릿을 다시 만드는 것을 권장합니다.

봇 경로를 직접 만들 수 있나요?+

네. 브라우저 맵 편집기에서 발판, 노드, 이동 동작을 지정하고 JSON 경로를 내보내 데스크톱 클라이언트에 불러올 수 있습니다. 같은 맵과 해상도에서 제작하고 테스트하세요.

02

사용 안내

게임 화면#

설치, 권한 및 라이선스 활성화#

운영체제에 맞는 패키지를 설치하고 플랫폼 점검을 마친 뒤 전략을 설정하세요.

Windows

64비트 ZIP 전체를 고정 폴더에 압축 해제하고 ZIP 미리보기 안에서는 실행하지 마세요. 프로그램을 관리자 권한으로 실행하세요.

Apple Silicon Mac

처음 열기 전에 앱을 응용 프로그램으로 옮기고 손쉬운 사용과 화면 및 시스템 오디오 녹화를 허용하세요. 완전히 종료한 뒤 다시 실행해야 합니다. Intel Mac은 지원 대상이 아닙니다.

macOS 권한 확인

손쉬운 사용은 키 입력을, 화면 및 시스템 오디오 녹화는 게임 창·캐릭터·미니맵·HP/MP 읽기를 허용합니다. Terminal, Python, 이전 빌드나 폴더가 아닌 응용 프로그램의 정식 앱을 두 목록에 추가하고 켠 뒤 Command-Q로 완전히 종료하고 다시 실행하세요.

활성화와 로컬 데이터

앞뒤 공백 없이 전체 라이선스를 입력하고 온라인 활성화 완료를 기다리세요. macOS 키체인 창에는 라이선스가 아니라 Mac 로그인 암호를 입력합니다. 데이터는 Windows의 %LOCALAPPDATA%\Okya\, macOS의 ~/Library/Application Support/Okya/에 있습니다. config.json, templates, maps만 백업하고 license.dat는 옮기지 마세요.

안정적인 인식 템플릿 만들기#

실제로 사용할 운영체제와 게임 환경에서 좌우 방향을 각각 캡처하세요.

캐릭터(고정 20 × 20 px)

프로필을 만들고 이름을 지정하세요. 왼쪽을 볼 때 머리 위쪽의 안정적인 영역을 캡처하고, 오른쪽에서도 정확히 같은 신체 부위를 선택합니다. 두 미리보기에 캐릭터만 포함됐는지 확인한 뒤 저장하고 선택하세요.

몬스터(고정 10 × 10 px)

동작과 프레임 수가 적은 몬스터를 우선하세요. 안정된 프레임에서 머리 위, 뿔, 눈 주변처럼 동일한 특징 부위를 좌우로 캡처합니다. 처음에는 한 종류, 일반적으로 1~3종이 안정적입니다.

좋은 샘플과 나쁜 샘플

좋은 쌍은 좌우 위치가 같고 대상만 포함합니다. 바닥, 발판 가장자리, 배경, 이름, 데미지, 채팅, 펫, 스킬 효과 또는 다른 몬스터가 포함되면 다시 캡처하세요.

다시 캡처해야 하는 경우

게임 해상도, 화면 배율, 외형, 효과, 게임 클라이언트 또는 OS가 바뀌면 모든 템플릿을 다시 캡처하세요. 템플릿은 실제 실행 해상도와 정확히 일치해야 하며 Windows와 macOS의 픽셀 렌더링도 다를 수 있습니다.

첫 실행 설정 순서#

다음 순서는 실제 데스크톱 클라이언트와 최초 사용 가이드를 기준으로 작성되었습니다.

  1. 1

    64비트 Windows 또는 Apple Silicon Mac에 맞는 패키지를 설치합니다. macOS에서는 권한을 주기 전에 앱을 응용 프로그램 폴더로 옮깁니다.

  2. 2

    게임을 1366 × 768 창 모드 또는 테두리 없는 창 모드로 설정하고, 주 모니터에서 미니맵과 HP/MP 영역을 모두 표시합니다.

  3. 3

    라이선스를 활성화하고 실제 게임 서버를 선택해 올바른 미니맵 색상과 HP/MP 인식 영역을 사용합니다.

  4. 4

    캐릭터와 대상 몬스터의 좌우 방향 템플릿을 각각 캡처합니다. 운영체제, 배율, 외형 또는 클라이언트가 바뀌면 다시 캡처하세요.

  5. 5

    첫 테스트는 제자리 공격을 선택하고 캐릭터, 몬스터 1종, 공격 키와 점프 키만 설정합니다.

  6. 6

    전략을 시작하고 실행 로그를 확인합니다. 캐릭터와 미니맵 인식이 모두 성공한 뒤 물약, 버프, 줍기를 켭니다.

모드, 전투 및 선택 기능 설정#

한 번에 한 항목만 바꾸고 저장한 뒤 로그에서 확인하세요.

게임 화면과 기본 설정

주 화면에서 1366 × 768 창 또는 테두리 없는 창을 사용하고 미니맵을 펼치며 HP/MP를 기본 위치에 둡니다. 실제 서버, 저장한 캐릭터와 몬스터 한 종류를 선택하고 거짓말 탐지기 경고음도 시험하세요.

진단 모드

인식 전용으로 게임 창, 캐릭터, 몬스터, 미니맵과 HP/MP를 확인하세요. 이동 전용으로 순찰이나 경로를 검증하고 두 점검이 정상일 때만 전체 실행을 사용합니다.

전투와 이동

공격과 점프 키를 게임 단축키와 일치시키세요. 다른 발판의 몬스터를 쫓지 않도록 가로·세로 범위는 보수적으로 시작합니다.

물약, 버프 및 줍기

HP/MP는 50% 기준과 약 1초 대기부터 시험하고 0.1초 미만으로 설정하지 마세요. 최대 5개 버프는 한 슬롯부터 검증합니다. 줍기는 0.45초가 안정적인 시작값이며 최소 0.05초입니다. 너무 빠르면 전투를 방해합니다.

첫 전체 실행

대상 맵에서 미니맵과 HP/MP를 확인하고 서버, 해상도, 캐릭터, 몬스터, 전략과 키를 저장하세요. 안전한 위치에서 시작하고 앱이 게임으로 포커스를 돌릴 때까지 기다리며 전환하지 마세요. 로그에서 모든 시작 점검이 통과해야 실제 실행 상태입니다.

30초 시작 전 점검

올바른 맵과 안전 위치, 주 화면의 1366 × 768, 펼친 미니맵, 올바른 서버·프로필·몬스터·전략, 모든 키, 충분한 소모품과 빈 공간, 들리는 경고음을 확인하세요.

세 가지 맵 전략#

맵 구조에 맞는 전략을 선택하세요. 새 설정에서는 선택 기능을 끈 상태로 이동부터 테스트하는 것이 좋습니다.

제자리 공격

첫 테스트와 고정 발판에 적합합니다. 시작 미니맵 위치를 기록하고 밀림이나 이탈이 발생하면 원위치 복귀를 시도할 수 있습니다.

두 지점 순찰

미니맵의 수평 A/B 좌표 사이를 이동하며 끝 지점 대기 시간과 끝 지점에서만 공격할지를 설정합니다.

사용자 정의 경로 순찰

맵 편집기에서 만든 노드, 발판, 동작 경로를 따라 이동합니다. 경로는 현재 맵과 일치해야 합니다.

사용자 지정 봇 경로 만들기#

맵 편집기에서 특정 맵을 봇이 어떻게 이동할지 정의할 수 있습니다. 데스크톱 클라이언트에서 실제로 사용할 맵과 게임 화면을 기준으로 제작하세요.

세 단계로 맵 경로 만들기

  1. 1
    실제 사용하는 맵 가져오기

    데스크톱 클라이언트에서 사용할 것과 같은 맵, 해상도, 창 모드, 미니맵 배치로 게임을 실행한 뒤 현재 화면을 캡처합니다. 맵 편집기에서 맵 가져오기를 선택하세요. 공략 사이트 이미지, 크기가 조정된 이미지, 다른 기기의 스크린샷은 좌표가 맞지 않을 수 있으므로 사용하지 마세요.

  2. 2
    왼쪽 위 미니맵 영역 자르기

    자르기를 선택하고 보이는 미니맵의 왼쪽 위와 오른쪽 아래를 차례로 클릭한 뒤 자르기를 저장합니다. 이동 가능한 발판, 밧줄, 사다리, 포털은 모두 포함하고 게임 화면, 채팅, 퀘스트 알림 등 미니맵 밖의 UI는 제외하세요. 저장 전에 데스크톱 클라이언트가 인식할 미니맵과 같은 영역인지 확인합니다.

  3. 3
    노드를 놓고 경로 설정하기

    노드 도구로 방향 전환 지점, 착지 위치, 밧줄·사다리 입구, 포털에 점을 놓습니다. 필요하면 발판을 표시하고 인접한 노드를 연결한 뒤 걷기, 점프, 오르기, 아래 점프 또는 텔레포트 동작을 지정하세요. 경로를 내보내 같은 맵의 데스크톱 클라이언트에 불러오고, 전투와 줍기를 켜기 전에 이동만 먼저 테스트합니다.

올바른 순서로 문제 해결하기#

실행 로그에서 가장 먼저 실패한 시작 점검부터 해결하세요.

게임 창을 찾지 못함

주 화면에서 1366 × 768 창 또는 테두리 없는 창 모드를 사용하세요. macOS에서는 화면 녹화 권한을 확인하고 앱을 다시 시작합니다.

인식 실패

가림을 제거하고 서버와 템플릿을 확인한 뒤 미니맵을 펼치고 좌우 템플릿을 다시 만드세요. 몬스터 한 종류로 시험합니다.

HP/MP가 0.0%로 표시됨

자동 회복을 먼저 끄고 서버, 1366 × 768, 기본 게임 UI, 창 위치와 화면 녹화 권한을 확인한 뒤 다시 시험하세요.

몬스터 누락 또는 오인식

한 종류만 선택하고 안정된 프레임에서 좌우를 다시 캡처하며 고유한 영역을 사용하세요. 배경이 포함됐거나 다른 OS에서 복사한 템플릿은 삭제하고 다시 만드세요.

인식되지만 키 입력이 없음

게임에 포커스를 돌리고 단축키와 macOS 손쉬운 사용을 확인하세요. Windows에서는 프로그램을 관리자 권한으로 실행하세요.

macOS가 권한을 계속 요청함

이전 빌드, 테스트 빌드, Python, Terminal 또는 같은 이름의 폴더 항목을 삭제하세요. 응용 프로그램의 현재 앱을 두 권한에 다시 추가하고 켠 뒤 Command-Q로 종료하고 다시 실행합니다.

순찰이 경계를 넘음

A/B 지점을 안전한 안쪽으로 옮기고 이동 전용으로 검증하세요. 감지 간격과 관성 때문에 잠시 넘어갈 수 있습니다.

업데이트, 백업 및 지원#

검증한 설정은 보존하되 기기에 묶인 라이선스나 민감 정보는 이동하지 마세요.

업데이트 전

전략을 중지하고 앱을 종료한 뒤 config.json, templates, maps를 백업하세요. 업데이트 후 버전, 서버, 템플릿, 키와 전략을 점검합니다.

다른 컴퓨터로 이동

일반 설정과 경로는 검토 후 옮길 수 있지만 license.dat는 옮기지 마세요. 새 기기에서 활성화, 권한 설정과 템플릿 재생성을 진행합니다.

지원 문의

버전, OS와 칩, 서버, 해상도, 창 모드, 전략, 주요 설정과 첫 실패까지의 로그를 보내고 라이선스, 기기 ID와 계정명은 제거하세요.