MAA를 처음 사용하는 경우 초보자 가이드를 읽어보세요.

경고

MAA가 업데이트 후 실행되지 않거나 MAA의 오류 창을 통해 여기에 도달했다면, 이는 대부분 실행 라이브러리가 업데이트되지 않은 문제 때문입니다.
가장 자주 발생하는 문제는 실행 라이브러리 문제이며, 많은 사람들이 문서를 읽지 않고 질문만 하기 때문에 공지 내용을 이걸로 교체했습니다.

MAA는 자체 포함 배포 방식을 채택하여 .NET 실행 환경이 내장되어 있으나, Visual C++ 실행 라이브러리는 여전히 필요합니다.

MAA 디렉토리에서 DependencySetup_依赖库安装.bat를 실행하거나, 터미널에서 아래 명령을 실행하거나,

winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements

아래 실행 라이브러리를 수동으로 다운로드하여 설치하여 문제를 해결하세요.

• Visual C++ 재배포 가능 패키지

소프트웨어 실행 불가능/크래시/오류 발생

다운로드/설치 문제

• 완전한 MAA 소프트웨어 패키지의 이름 형식은 "MAA-버전-플랫폼-아키텍처.zip"입니다. 다른 것들은 단독으로 사용할 수 없는 "구성 요소"이므로 주의 깊게 읽어보세요. 대부분의 경우, x64 아키텍처의 MAA를 사용해야 합니다. 즉, MAA-*-win-x64.zip을 다운로드해야 하며, MAA-*-win-arm64.zip이 아닙니다.
• 자동 업데이트 후 기능이 누락되었거나 작동하지 않는 경우, 업데이트 과정에서 문제가 발생했을 수 있습니다. 업데이트가 실패하면 MAA는 다음 시작 시 업데이트 실패 알림을 표시하고 자동 복구(전체 패키지를 다시 다운로드하여 다시 시작 후 설치)를 제안합니다. 해당 알림을 무시했다면 설치가 불완전한 상태일 수 있으니 전체 설치 패키지를 다시 다운로드하고 압축을 해제하세요. 압축 해제 후, 이전 MAA 폴더에 있는 config, data, debug 폴더를 새로 압축 해제된 MAA 폴더로 복사하여 기존 설정과 로그를 유지하세요. cache(캐시)와 achievement(클리어 스크린샷) 폴더는 필요에 따라 유지할 수 있습니다.

런타임 문제

웹 페이지 오른쪽 아래에 있는 위로 ↑ 화살표를 찾아 클릭하세요.

시스템 문제

• MAA는 32비트 운영 체제를 지원하지 않으며, Windows 7 / 8 / 8.1을 지원하지 않습니다.
• 아래의 런타임 설치는 모두 구성 요소 저장소(CBS, TrustedInstaller/TiWorker, WinSxS)에 의존합니다. 구성 요소 저장소가 손상되면 정상적으로 설치할 수 없습니다.

운영 체제를 다시 설치하는 것 이외에 다른 수정 방법을 제공할 수 없으며, 확장 기능이나 리스크가 표시되지 않은 "정리판" 운영 체제를 사용하는 것을 피하세요. 또는 아주 오래된 구버전 시스템 사용을 피하세요.

Windows N/KN 관련

Windows 8/8.1/10/11 N/KN(유럽/한국) 버전을 사용하는 경우, 미디어 기능 팩을 설치해야 합니다.

Windows 7 / 8 / 8.1 관련

MAA가 의존하는 실행 라이브러리 및 시스템 구성 요소가 Windows 10 이상을 요구하기 때문에, MAA는 Windows 7 / 8 / 8.1을 더 이상 지원하지 않습니다.

시작 시 ｢설치 파일 누락｣ 알림이 표시됨

MAA는 시작 시 설치 패키지에 포함된 파일 목록(filelist.txt)과 대조하여 설치 파일 누락 여부를 확인합니다. 이 알림이 표시되면 일부 파일이 보안 소프트웨어에 의해 차단·삭제되었거나 수동으로 삭제되어 해당 기능(미니게임 등의 작업)이 동작하지 않을 수 있습니다:

• 보안 소프트웨어가 원인이라면 해당 소프트웨어의 격리소에서 삭제된 파일을 복원하고, MAA 설치 폴더를 허용 목록에 추가해 주세요.
• 알림 창에서 자동 복구(전체 패키지를 다시 다운로드하고 재시작 후 복원)를 선택하거나, 알림 창의 안내에 따라 수동으로 재설치할 수도 있습니다.

DLL 인젝션 문제

MAA 시작 시 호환성 경고가 표시되거나, 충돌·UI 렌더링 문제가 발생하는 것은 일반적으로 Nahimic 등 타사 소프트웨어가 MAA에 DLL을 주입했기 때문입니다. 다음 방법 중 하나로 해결할 수 있습니다:

방법 1: Windows 보안을 통해 DLL 인젝션 차단 (권장)

1. Windows 보안 → 앱 및 브라우저 제어 → Exploit Protection → Exploit Protection 설정 → 프로그램 설정 을 엽니다
2. 사용자 지정할 프로그램 추가 를 클릭하고, "프로그램 이름으로 추가" 를 선택하여 MAA.exe 를 입력합니다 (또는 "정확한 파일 경로 선택" 을 선택하여 MAA 설치 디렉터리의 MAA.exe 를 지정)
3. MAA 설정 목록에서 "확장 지점 사용 안 함" 을 찾아, "시스템 설정 재정의" 에 체크하고 켭니다
4. "적용" 을 클릭하여 저장한 뒤 MAA를 다시 시작합니다

이 설정은 시스템 수준에서 타사 소프트웨어가 MAA에 DLL을 주입하는 것을 차단하며, 다른 프로그램에는 영향을 주지 않습니다.

방법 2: 주입된 DLL 이름 바꾸기

1. 경고에 표시된 경로에서 해당 DLL 파일을 찾습니다 (파일 확장명이나 파일 자체가 보이지 않으면, 탐색기 상단의 보기 → 표시 에서 "파일 확장명" 과 "숨겨진 항목" 을 활성화하세요)
2. 파일을 우클릭 → 이름 바꾸기 하여 확장명 .dll 을 .dll1 등 무효한 확장명으로 변경합니다

경고

이 방법은 관련 소프트웨어에 문제를 일으킬 수 있습니다. 신중하게 사용하세요. 원인에 대한 자세한 내용은 관련 게시물과 blog을 참조하세요.

방법 3: 관련 소프트웨어 처리

관련 소프트웨어의 제외 목록에 MAA를 추가하거나, 관련 소프트웨어를 제거한 후 문제가 해결되었는지 확인하세요.

연결 오류

팁

사용 중인 에뮬레이터가 지원하는지, 확인하려면 다음 문서를 참조하세요. Windows 지원 목록

ADB 및 연결 주소 확인

연결 설정을 참조하세요.

에뮬레이터의 연결 포트

각 에뮬레이터의 포트들은 다음과 같습니다:

연결 포트

에뮬레이터	포트 기본값
MuMu 6/X	7555
MuMu	16384
NoxPlayer	62001
Memu	21503
BlueStacks	5555
LDPlayer 9	5555 / emulator-5554

이 외의 에뮬레이터를 사용할 경우에는, 다음 블로그를 참조하세요. Zhao Qingqing의 블로그。

기존 adb 프로세스 종료

MAA를 종료한 후 작업 관리자에서 세부 정보에서 adb라는 이름을 포함한 프로세스가 있는지 확인하세요.있다면 종료한 후 다시 연결을 시도하세요. (일반적으로 앞서 입력한 adb 파일과 동일한 이름을 갖습니다)

여러 adb를 올바르게 사용하기

adb 버전이 다를 경우, 새로 시작된 프로세스가 이전 프로세스를 종료합니다. 따라서 Android Studio, Alas, 휴대폰 도우미와 같은 여러 개의 adb를 동시에 실행할 때 버전이 같은지 확인하세요.

게임 가속기 피하기

일부 가속기는 가속을 시작하거나 중지한 후 MAA, ADB 및 에뮬레이터를 다시 연결해야 합니다.

UU 가속기와 MuMu를 동시에 사용할 경우 공식 문서를 참고하세요.

컴퓨터 다시 시작

재부팅은 97%의 문제를 해결합니다. (확신합니다)

에뮬레이터 변경

Windows 지원 목록을 참고하세요.

연결은 정상이지만, 조작이 안됨

일부 에뮬레이터들의 기본 adb 버전이 너무 오래되어 Minitouch 관련 작업을 지원하지 않습니다.

관리자 권한으로 MAA를 실행하고, MAA 설정 - 연결 설정 - 강제 ADB 교체를 클릭하세요. (에뮬레이터를 닫고 MAA를 다시 시작한 후 작업을 권장합니다. 그렇지 않으면 실패할 수 있습니다)

에뮬레이터를 업데이트하면 adb 파일이 다시 덮어씌워질 수 있습니다. 업데이트 후 문제가 그대로라면 다시 시도하세요.

이러한 조치로도 문제가 해결되지 않는 경우, 연결 설정 - 터치 모드를 Minitouch에서 MaaTouch로 변경하여 다시 시도하세요. ADB Input 작업은 최후의 수단으로 사용해야 합니다.

연결은 정상이지만 작업이 버벅거리거나 이상 또는 빈번한 오류가 발생합니다

• UI 위치 조절을 사용하는 경우 0으로 설정하세요.
• 국가 별 클라이언트를 플레이하는 경우 먼저 설정 - 실행 설정 - 클라이언트 종류에서 클라이언트 버전을 선택하세요. 해외 클라이언트의 경우 일부 기능이 완전히 호환되지 않을 수 있으므로 해당 해외 클라이언트 사용 설명서를 참조하세요.
• 통합 전략 기능을 사용할 경우, 사용자 설명서를 참조하고 통합 전략 - 테마에서 올바른 테마를 선택하세요
• 자동지휘가 자주 일시 정지되고 오퍼레이터가 배치되지 않으면 설정 - 실행 설정에서 일시정지 후 배치를 비활성화하세요.
• 자동 편성 시 오퍼레이터를 제대로 인식하지 못할 경우, 해당 오퍼레이터의 즐겨찾기를 해제하세요.
• ADB Input 터치 모드 작업이 느린 것은 정상입니다. 자동지휘 기능이 필요한 경우 다른 모드로 전환해 보세요.
• MuMu 에뮬레이터를 사용하는 경우, 메모리 사용 정책을 리소스 사용량 최소화로 설정하지 마세요.

스크린샷 촬영이 오래 걸리거나 오랜 시간이 걸립니다

• MAA는 현재 RawByNc, RawWithGzip, Encode 세 가지 방법으로 스크린샷을 지원하며 평균 스크린샷 시간이 400/800보다 클 때 한 번의 메시지를 출력합니다. (한 번의 작업에서 한 번만 메시지를 출력합니다)
• 설정 - 연결 설정에서 최근 30회 스크린샷 시간의 최소/평균/최대값을 표시하며 10회마다 스크린샷이 새로 고침됩니다.
• 자동지휘 기능은 스크린샷 시간에 크게 영향을 받습니다.
• 이 시간은 MAA와 관련이 없으며 컴퓨터 성능, 현재 사용률 또는 에뮬레이터에 따라 달라집니다. 백그라운드를 정리하거나 에뮬레이터를 변경하거나 컴퓨터 구성을 업그레이드하는 등의 조치를 취해보세요.

관리자 권한 관련 문제

MAA는 Windows UAC 관리자 권한 없이 모든 기능을 실행할 수 있어야 합니다. 현재 관리자 권한과 관련된 기능은 다음과 같습니다:

1. 자동 연결 감지：목표 에뮬레이터가 관리자 권한으로 실행될 때 관리자 권한이 필요합니다.
2. 완료 후 의 에뮬레이터를 종료：목표 에뮬레이터가 관리자 권한으로 실행될 때 관리자 권한이 필요합니다.
3. 부팅 시 MAA 자동 시작：관리자 권한으로 실행할 경우 부팅 시 자동 시작을 설정할 수 없습니다.
4. MAA가 관리자 권한이 필요한 경로에 잘못 압축된 경우, 예: C:\ 또는 C:\Program Files\와 같은 경로.

UAC가 비활성화된 시스템에서는 "우클릭하여 관리자 권한으로 실행을 선택하지 않아도 관리자 권한으로 실행되는" 문제가 발생할 수 있다는 보고가 있습니다. 예상치 못한 권한 상승을 방지하기 위해 UAC를 활성화하는 것이 좋습니다.

중간에 다운로드 중 "로그인"/"인증" 메시지가 표시됩니다

브라우저 / IDM / FDM 등의 다운로드 관리자를 사용하여 파일을 다운로드하세요. Xunlei(썬더)를 사용하지 마세요!

편집하기