이 확장 프로그램은 MaaAssistantArknights/MaaFramework에 대해 다음과 같은 기능들을 포함한 편리한 개발 기능들을 제공합니다:

• template 미리보기, next 점프, 작업 참조(Task Reference) 등을 포함한 tasks.json 지원
• 이미지 캡처/자르기

자세한 내용은 마켓플레이스 또는 저장소를 방문하여 확인할 수 있습니다.

설치

VS Code 확장 프로그램 목록에서 Maa를 검색하여 직접 설치하는 것을 권장합니다.

팁

처음 사용할 때 확장 프로그램은 사전 설정된 버전의 리소스를 자동으로 다운로드합니다. 명령 팔레트에서 Maa: 선택된 다운로드 소스(Maa: select fetch registry)를 검색하여 다운로드 소스(npm / cnpm)를 전환할 수 있습니다.

기능

제어판

전용 제어판이 왼쪽에 추가되었으며, 아이콘은 입니다.

확장 프로그램의 대부분의 기능은 interface.json 구성을 기반으로 합니다. 제어판 상단에서 활성화할 interface.json을 선택할 수 있습니다.

확장 프로그램에는 Maa 호환 모드가 있습니다. 열린 폴더 내에 src/MaaCore 폴더가 감지되면 자동으로 활성화됩니다.

의미론적 리소스 분석

제어판의 리소스(Resource) 드롭다운을 전환하여 예상되는 리소스를 선택하세요. 확장 프로그램은 해당 경로를 기반으로 인덱싱 및 진단을 수행합니다.

편집하려는 json 파일에 플러그인 힌트가 표시되지 않는 경우, 활성화된 리소스에 해당 파일이 포함되어 있는지 확인하세요.

작업 정의(task defs)란 작업 객체의 키 속성을 의미합니다.

작업 참조(task refs)란 다른 작업 객체에서 작업 이름을 값으로 가질 수 있는 속성(예: next)을 의미합니다.

작업 정의/참조 조회

확장 프로그램은 정의로 이동(Jump to definition), 참조로 이동(Jump to references), 작업 정의 보기(View task definition)를 지원합니다.

Maa 호환 모드를 켜면 템플릿 작업을 파싱할 수 있어, 기본 클래스와 연동하여 작업 정의 및 참조를 조회할 수 있습니다. 작업 정의에 마우스를 올리면 동일한 이름의 이미지를 볼 수 있습니다.

Ctrl+T 단축키를 사용하여 작업 정의를 빠르게 조회하고 이동할 수 있습니다.

이미지 조회/열기

이 확장 프로그램은 이미지 열기를 지원합니다.

Maa 호환 모드를 켜면 이미지 경로에 대한 재귀적 검색을 허용합니다.

작업 자동 완성

확장 프로그램은 알려진 모든 작업을 기반으로 자동 완성을 지원합니다.

Maa 호환 모드를 켜면 @를 입력하여 완성을 트리거할 수 있습니다.

이미지 경로 자동 완성

확장 프로그램은 알려진 모든 이미지 경로를 기반으로 자동 완성을 지원합니다.

Maa 호환 모드를 켜면 이미지 경로에 대한 재귀적 검색을 허용합니다.

작업/이미지 경로 유효성 검사

확장 프로그램은 모든 작업을 정기적으로 스캔하고 분석하는 기능을 지원합니다.

• 중복된 작업 정의가 있는지 확인
• 알 수 없는 작업 참조가 있는지 확인
• 알 수 없는 이미지 참조가 있는지 확인
• 단일 작업 내에 중복된 작업 참조가 있는지 확인

다중 경로 리소스 지원

확장 프로그램은 리소스가 여러 경로를 포함하는 것을 지원하며, 지정된 순서대로 논리적 덮어쓰기를 수행합니다. 즉, 나중에 로드된 콘텐츠가 이전에 로드된 콘텐츠를 참조할 수 있습니다.

작업 계산 / 작업 목록 표현식 (Maa 전용)

제어판을 통해 실제 확장된 작업 내용과 각 항목의 출처를 계산할 수 있으며, 작업 목록 표현식의 확장 결과도 계산할 수 있습니다.

MaaPiCli 기능 (MaaFramework 프로젝트 전용)

제어판을 통해 컨트롤러를 스캔 및 선택하고, 리소스를 선택하고, 작업을 추가 및 관리하고, 작업을 실행할 수 있습니다.

스크린샷 캡처 및 자르기 / 빠른 인식

VS Code 명령 팔레트에서 Maa: 스크린샷 도구 열기(Maa: open crop tool)를 검색하고 실행하여 스크린샷 / 자르기(Screenshots / Crop) 패널을 열 수 있습니다.

Ctrl+Shift+P (MacOS의 경우 Command+Shift+P)를 사용하여 명령 팔레트를 엽니다.

• 컨트롤러를 선택하고 연결한 후 스크린샷(Screencap) 버튼을 사용하여 직접 스크린샷을 얻을 수 있습니다.
• 업로드(Upload) 버튼을 사용하여 수동으로 이미지를 업로드할 수 있습니다.
• Ctrl 키를 누른 상태에서 자를 영역을 선택합니다.
• 휠을 사용하여 확대/축소할 수 있습니다.
• 자르기가 완료되면 다운로드(Download) 버튼을 사용하여 활성 리소스의 최상위 이미지 디렉터리에 자르기 결과를 자동으로 저장할 수 있습니다.
• 복사(Copy) 버튼을 사용하여 ROI를 배열 형태로 클립보드에 복사할 수 있습니다.
• 도구(Tool) 버튼을 누르면 인식 도구 패널이 열리며, 현재 이미지에 대해 직접 인식 테스트를 수행할 수 있습니다.

경고

OCR 인식 결과가 비어 있다면 OCR 모델이 올바르게 구성되었는지 확인하세요.

MAA의 경우, 확장 프로그램에서 사용되는 모델을 자동으로 관리하므로 올바른 리소스만 선택하면 됩니다.

로그 보기 기능

MaaFramework 로그

VS Code 명령 팔레트에서 Maa: maa 로그 열기(Maa: open maa log)를 검색하고 실행하여 디버깅 중에 생성된 maa.log 로그를 볼 수 있습니다.

Maa Pipeline Support 확장 로그

VS Code 명령 팔레트에서 Maa: 확장 로그 열기(Maa: open extension log)를 검색하고 실행하여 디버깅 중에 생성된 mse.log 로그를 볼 수 있습니다.

하단 상태 표시줄

MaaSupport [확장 버전]

클릭하여 제어판으로 포커스를 이동합니다.

MaaFramework [MaaFw 버전]

클릭하여 확장 프로그램에서 사용하는 MaaFramework 버전을 전환합니다. 선택할 수 있는 버전은 현재 확장 프로그램이 지원하는 버전으로 제한되며, 필요한 버전이 목록에 없으면 확장 프로그램 버전을 변경하는 것을 고려하세요.