order: 8 icon: iconoir:code-brackets
전용 VSCode 확장 프로그램 가이드
이 확장 프로그램은 MaaAssistantArknights/MaaFramework에 대해 다음과 같은 기능들을 포함한 편리한 개발 기능들을 제공합니다:
template 미리보기,next 점프,작업 참조(Task Reference)등을 포함한 tasks.json 지원- 이미지 캡처/자르기
자세한 내용은 마켓플레이스 또는 저장소를 방문하여 확인할 수 있습니다.
설치
VSCode 확장 프로그램 목록에서 Maa를 검색하여 직접 설치하는 것을 권장합니다.
::: tip
처음 사용할 때 확장 프로그램은 사전 설정된 버전의 리소스를 자동으로 다운로드합니다.
명령 팔레트에서 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 프로젝트 전용)
제어판을 통해 컨트롤러를 스캔 및 선택하고, 리소스를 선택하고, 작업을 추가 및 관리하고, 작업을 실행할 수 있습니다.
스크린샷 캡처 및 자르기 / 빠른 인식
VSCode 명령 팔레트에서 Maa: 스크린샷 도구 열기(Maa: open crop tool)를 검색하고 실행하여 스크린샷 / 자르기(Screenshots / Crop) 패널을 열 수 있습니다.
Ctrl+Shift+P(MacOS의 경우Command+Shift+P)를 사용하여 명령 팔레트를 엽니다.
- 컨트롤러를 선택하고 연결한 후
스크린샷(Screencap)버튼을 사용하여 직접 스크린샷을 얻을 수 있습니다. 업로드(Upload)버튼을 사용하여 수동으로 이미지를 업로드할 수 있습니다.Ctrl키를 누른 상태에서 자를 영역을 선택합니다.- 휠을 사용하여 확대/축소할 수 있습니다.
- 자르기가 완료되면
다운로드(Download)버튼을 사용하여 활성 리소스의 최상위 이미지 디렉터리에 자르기 결과를 자동으로 저장할 수 있습니다. 복사(Copy)버튼을 사용하여 ROI를 배열 형태로 클립보드에 복사할 수 있습니다.도구(Tool)버튼을 누르면 인식 도구 패널이 열리며, 현재 이미지에 대해 직접 인식 테스트를 수행할 수 있습니다.
::: warning
OCR 인식 결과가 비어 있다면 OCR 모델이 올바르게 구성되었는지 확인하세요.
MAA의 경우, 확장 프로그램에서 사용되는 모델을 자동으로 관리하므로 올바른 리소스만 선택하면 됩니다.
:::
로그 보기 기능
MaaFramework 로그
VSCode 명령 팔레트에서 Maa: maa 로그 열기(Maa: open maa log)를 검색하고 실행하여 디버깅 중에 생성된 maa.log 로그를 볼 수 있습니다.
Maa Pipeline Support 확장 로그
VSCode 명령 팔레트에서 Maa: 확장 로그 열기(Maa: open extension log)를 검색하고 실행하여 디버깅 중에 생성된 mse.log 로그를 볼 수 있습니다.
하단 상태 표시줄
MaaSupport [확장 버전]
클릭하여 제어판으로 포커스를 이동합니다.
MaaFramework [MaaFw 버전]
클릭하여 확장 프로그램에서 사용하는 MaaFramework 버전을 전환합니다. 선택할 수 있는 버전은 현재 확장 프로그램이 지원하는 버전으로 제한되며, 필요한 버전이 목록에 없으면 확장 프로그램 버전을 변경하는 것을 고려하세요.