MaaXYZ/MaaFramework

어떤 프로젝트인가요?

핵심 기능

• 01이미지 인식으로 UI 요소를 찾고 시뮬레이션된 입력으로 조작합니다.
• 02로우코드 파이프라인 프로토콜로 자동화 작업을 정의합니다.
• 03여러 언어의 공식 바인딩과 통합 API를 제공합니다.
• 04Windows, Linux, macOS, Android에서 실행됩니다.
• 05ProjectInterface 프로토콜을 통해 재사용 가능한 프로젝트 패키징을 지원합니다.

활용 사례

• API가 없는 게임이나 애플리케이션에서 반복 작업을 자동화합니다.
• 소스 수준의 훅을 사용할 수 없는 소프트웨어에서 블랙박스 UI 테스트를 실행합니다.
• 다른 사용자가 GUI나 CLI로 실행할 수 있는 재사용 가능한 자동화 프로젝트를 만듭니다.

빠른 시작

1. 1

   docs 폴더에서 빠른 시작 가이드를 엽니다

2. 2

   언어 바인딩(Python, Node, Go, Rust, C#)을 선택하고 README에 안내된 패키지 레지스트리에서 설치합니다

사용 전 알아둘 점

• !LGPL-3.0 라이선스가 적용됩니다. 카피레프트 라이선스 조건은 라이브러리를 수정할 때 적용됩니다.

토픽

자주 묻는 질문

MaaFramework은(는) 무엇인가요?

Windows, Linux, macOS, Android에서 이미지 인식 기반 자동화와 블랙박스 테스트 도구를 만들기 위한 LGPL-3.0 C++ 프레임워크입니다. MaaFramework는 이미지 인식으로 화면의 대상을 찾아 시뮬레이션된 입력으로 인터페이스를 조작하는 블랙박스 자동화 테스트 프레임워크입니다. C++로 작성되었으며, 모든 상호작용을 직접 코드로 작성하는 대신 인식 및 동작 단계의 파이프라인으로 작업을 정의할 수 있도록 설계되었습니다.

MaaFramework은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

MaaFramework은(는) LGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

MaaFramework은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. MaaFramework의 마지막 커밋은 2026년 10월 19일입니다.

MaaFramework은(는) 어디에 사용할 수 있나요?

API가 없는 게임이나 애플리케이션에서 반복 작업을 자동화합니다. 소스 수준의 훅을 사용할 수 없는 소프트웨어에서 블랙박스 UI 테스트를 실행합니다. 다른 사용자가 GUI나 CLI로 실행할 수 있는 재사용 가능한 자동화 프로젝트를 만듭니다.

MaaFramework는 어떻게 설치하나요?

docs 폴더에서 빠른 시작 가이드를 엽니다 언어 바인딩(Python, Node, Go, Rust, C#)을 선택하고 README에 안내된 패키지 레지스트리에서 설치합니다

MaaFramework은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/MaaXYZ/MaaFramework