자동지휘 프로토콜
약 763 단어약 3 분
resource/copilot/*.json 파일의 사용법 및 각 필드 설명
팁
JSON 파일은 주석을 지원하지 않으므로, 텍스트 내의 주석은 예시용입니다. 직접 복사하여 사용하지 마세요.
전체 필드 목록
{
"stage_name": "暴君", // 스테이지명, 필수. 스테이지 중문명, code, stageId, levelId 등 유일성만 보장되면 가능
"opers": [
// 특정 오퍼레이터 지정
{
"name": "重岳", // 오퍼레이터명
"role": "guard", // 오퍼레이터 직업. 선택 사항, 동명 오퍼레이터 구분에 사용. 영문 직업명 입력, 대소문자 구분 없음
"skill": 3, // 스킬 번호. 선택 사항, 기본값 0, 범위 [0, 3]
"skill_usage": 2, // 스킬 사용법. 선택 사항, 기본값 0
// 0 - 자동 사용 안 함 ("actions" 필드에 의존)
// 1 - 쿨타임 찰 때마다 사용 (예: 쏜즈 3스킬, 머틀 1스킬 등)
// 2 - X회 사용 (예: 마운틴 2스킬 1회 전환, 총웨 3스킬 5회 사용 등, "skill_times" 필드로 설정)
// 3 - 자동 판단 (구현 예정)
// 완전 자동 시전 스킬(패시브 등)인 경우 0 입력
"skill_times": 5, // 스킬 사용 횟수. 선택 사항, 기본값 1
"requirements": {
// 육성 상태 요구, 자동 편성 시 검증. 선택 사항, 기본값 비어 있음
"elite": 2, // 정예화 단계. 선택 사항, 기본값 -1 (요구 없음)
"level": 90, // 오퍼레이터 레벨. 선택 사항, 기본값 -1 (요구 없음)
"skill_level": 10, // 스킬 레벨. 선택 사항, 기본값 -1 (요구 없음)
"module": 1, // 모듈 번호. 선택 사항, 기본값 -1 (요구 없음), 0은 모듈 미사용, 1-5는 χ, γ, α, Δ, β 모듈에 해당
"module_level": 3, // 모듈 레벨. 아직 미지원
"potential": 1 // 잠재(돌파) 요구. 아직 미지원
}
}
],
"groups": [
{
"name": "任意正常群奶", // 그룹명, 필수
// 임의로 이름을 지으면 되며, 아래 deploy의 name과 일치하면 됨
"opers": [
// 오퍼레이터 중 하나 선택, 순서 없음, 육성 상태 높은 것 우선 선택, 사용법은 위 opers 필드와 동일
{
"name": "夜莺",
"skill": 3,
"skill_usage": 2 // 특정 시점인 경우, 오퍼레이터마다 스킬 쿨타임이 다를 수 있으니 주의
},
{
"name": "白面鸮",
"skill": 2,
"skill_usage": 2
}
]
}
],
"actions": [
// 전투 중 조작. 순서가 있으며, 이전 동작이 완료되어야 다음 동작 실행. 필수
{
"type": "部署", // 조작 유형, 선택 사항, 기본값 "Deploy"
// "Deploy" | "Skill" | "Retreat" | "SpeedUp" | "BulletTime" | "SkillUsage" | "Output" | "SkillDaemon" | "MoveCamera" | "ResetStopwatch" | "Click" | "Swipe" | "SetUnitLocation"
// "部署" | "技能" | "撤退" | "二倍速" | "子弹时间" | "技能用法" | "打印" | "摆完挂机" | "移动镜头" | "重置全局计时器" | "点击" | "滑动" | "设置单位坐标"
// 중/영문 모두 가능, 효과 동일
// "Deploy"인 경우, 코스트가 부족하면 코스트가 모일 때까지 계속 대기 (timeout 제외)
// "Skill"인 경우, 스킬 쿨타임이 안 찼으면 쿨타임 찰 때까지 계속 대기 (timeout 제외)
// "二倍速"은 토글 방식임. 한 번 쓰면 2배속, 다시 쓰면 1배속으로 돌아옴
// "子弹时间"은 임의의 오퍼레이터를 클릭한 후 1/5 속도로 만드는 것. 다른 action을 수행하면 정상 속도로 복구됨
// "name" 또는 "location" 중 하나 필수. 어떤 오퍼레이터를 눌러 저속 모드에 진입할지 지정. 전장 또는 대기열 오퍼레이터 모두 가능 (자동 판단)
// 만약 다음 동작이 "Skill" / "Retreat"라면, 다음 동작과 동일한 "name" 또는 "location"을 입력해야 함
// 만약 다음 동작이 "Deploy"라면, 아무나 적어도 됨 (단 대기열에 있는 오퍼레이터는 누르면 인식이 가려질 수 있으므로 피하는 게 좋음)
// "打印" 화면에는 이 단계가 표시되지 않으며, doc 내용만 출력됨 (설명 표시 용도)
// "摆完挂机" "스킬 재사용 대기시간 완료 시 사용" 설정된 스킬만 사용하며, 전투 종료까지 아무것도 하지 않음
// "移动镜头" "인도자의 시련" 모드에서 사용, distance 필드 필요
// "重置全局计时器" 전역 타이머 리셋, "elapsed_time" 조건 참고
// "Click" "rect"로 지정한 픽셀 영역 또는 "location"으로 지정한 전장 칸을 인식 없이 직접 클릭. 빈 칸도 클릭 가능
// "rect"와 "location" 중 하나는 반드시 지정해야 함. 모두 비워 두면 파싱 오류로 작업 파일 로드에 실패함. 둘 다 지정하면 "rect"가 우선됨 (로그에 경고 출력)
// "Swipe" "begin" 사각형에서 "end" 사각형으로 스와이프. 하위 레벨 스와이프 명령을 직접 전송. 둘 중 하나라도 없으면 작업 파일 로드에 실패함
// "SetUnitLocation" 전장 유닛의 칸 좌표 설정. "name"과 "location" 모두 필수. 하나라도 없거나 값이 잘못된 경우("name"은 비어 있지 않은 문자열, "location"은 [x, y] 2요소 숫자 배열이어야 함) 작업 파일 로드에 실패함
// 게임에 어떠한 조작도 하지 않으며 MAA 내부의 유닛 위치 기록만 갱신함
// 오퍼레이터가 이동한 후 위치를 수정하여, 이후 "name"으로 지정하는 "Skill" / "Retreat" / "SkillUsage" 동작이 새 칸에 적용되도록 함
// 필드 위 장치·시설 등 오퍼레이터가 아닌 유닛을 등록하는 용도로도 사용 가능. "SkillUsage" 및 "SkillDaemon"과 조합하여 장치 스킬 자동 사용 가능
// 해당 "name"이 이미 필드에 있으면 위치를 갱신하고, 없으면 새 유닛으로 등록함 ("role"은 선택 사항, 기본값은 직업 구분 없음)
// 현재 아래 5개 조건은 AND 관계임 (&&)
"kills": 0, // 킬 수 조건, 도달 못하면 계속 대기. 선택 사항, 기본값 0 (즉시 실행)
"costs": 50, // 코스트 조건, 도달 못하면 계속 대기. 선택 사항, 기본값 0 (즉시 실행)
// 코스트는 잠재 등의 영향을 받으므로 정확하지 않을 수 있음. 타임라인이 엄격하지 않은 전투에 적합
// 그렇지 않으면 아래 cost_changes 사용 권장
// 또한 코스트가 두 자리 수일 때만 인식이 비교적 정확함. 세 자리 수는 인식 오류 가능성 있음. 비추천
"cost_changes": 5, // 코스트 변화량 조건, 도달 못하면 계속 대기. 선택 사항, 기본값 0 (즉시 실행)
// 이 action을 실행하기 시작한 시점부터 계산 (즉 이전 action이 끝난 시점의 코스트 기준)
// 음수 지원 (제이 등 코스트 지속 소모 오퍼레이터로 인해 코스트가 줄어드는 경우)
// 또한 코스트가 두 자리 수일 때만 인식이 비교적 정확함. 세 자리 수는 인식 오류 가능성 있음. 비추천
"cooling": 2, // 쿨타임 중인 오퍼레이터 수 조건, 도달 못하면 계속 대기. 선택 사항, 기본값 -1 (인식 안 함)
"elapsed_time": 1000, // 밀리초(ms) 단위 전역 타이머 조건, 도달 못하면 계속 대기. 선택 사항, 기본값 0 (즉시 실행)
// 이전 type:ResetStopwatch action이 실행된 시점부터 계산됨
// 사용 전 반드시 type:ResetStopwatch action을 실행하여 타이머를 초기화해야 함. 안 그러면 멈춤
// TODO: 기타 조건
// TODO: "condition_type": 0, // 실행 조건 간 관계, 선택 사항, 기본값 0
// // 0 - AND; 1 - OR
"name": "棘刺", // 오퍼레이터명 또는 그룹명. type이 "Deploy"일 때 필수, "Skill" | "Retreat"일 때 선택, "SetUnitLocation"일 때 필수
"role": "guard", // 오퍼레이터 직업. 선택 사항, 동명 오퍼레이터 구분에 사용. 영문 직업명 입력, 대소문자 구분 없음
"location": [
5,
5
], // 오퍼레이터 배치 위치
// type "Deploy" 시 필수
// type "Skill" | "Retreat" 시 선택
// "Skill": 필드 위 자동 장치 등에 추천 (name 없이 location으로 스킬 발동). 일반 오퍼레이터는 name 권장
// "Retreat": 동명의 소환물이 여러 개일 때 추천 (name 없이 location으로 퇴각). 일반 오퍼레이터는 name 권장
// type "Skill" | "Retreat" | "SkillUsage" 시 name과 location을 모두 지정하면 location이 우선됨
// type이 "SetUnitLocation"인 경우 필수. 해당 "name" 유닛의 위치를 이 칸으로 설정. 좌표는 [0, 0]을 포함한 모든 유효한 칸 가능
// 좌표 정보는 https://map.ark-nights.com/areas 에서 확인 가능. 설정에서 "좌표 표시"를 "MAA"로 선택하면 MAA 좌표 확인 가능
// type이 "Click"인 경우 "rect"와 "location" 중 하나는 반드시 지정. 해당 칸을 직접 클릭. 좌표는 [0, 0]을 포함한 모든 유효한 칸 가능
"rect": [
100,
100,
50,
50
], // type이 "Click"인 경우 "rect"와 "location" 중 하나는 반드시 지정. 둘 다 지정하면 "rect" 우선. 720p 기준 픽셀 사각형 [x, y, w, h]
// 클릭 지점은 영역 내에서 무작위로 선택되며, 현재 해상도에 맞게 자동 조정됨
"direction": "左", // 배치 방향. type "Deploy" 시 필수
// "Left" | "Right" | "Up" | "Down" | "None"
// "左" | "右" | "上" | "下" | "无"
// 중/영문 모두 가능, 효과 동일
// "skip_if_not_ready": false, 더 이상 사용되지 않습니다. 대신 "timeout": 0을 사용하십시오.
"skill_usage": 1, // 스킬 용법 수정. type "SkillUsage" 시 필수
// 예: 머틀 배치 직후에는 몹을 잡아야 해서 스킬을 안 쓰다가, 중반부터 자동으로 스킬을 써야 할 때
// 해당 시점에 1로 설정하면 됨
"skill_times": 5, // 스킬 사용 횟수. 선택 사항, 기본값 1
"pre_delay": 0, // 전행 딜레이. 선택 사항, 기본값 0, 단위 ms
// 현재 action의 모든 조건이 충족된 후 타이머 시작, 종료 후 type 동작 실행
"post_delay": 0, // 후행 딜레이. 선택 사항, 기본값 0, 단위 ms
// 현재 action의 type 동작 완료 후 타이머 시작, 종료 후 다음 action 진행
"timeout": 999999999, // 타임아웃. type "Skill" 시 선택. 기본값 -1, 제한 없음, 단위 ms
// 조건 및 pre_delay 완료 후 타이머 시작, 타임아웃 시 현재 동작 포기하고 다음 동작 실행; 0이면 한 번만 확인
"distance": [
4.5,
0
], // type "MoveCamera" 시 필수
// [ x 이동 칸수, y 이동 칸수 ], 소수 가능, 음수 가능
// x 양수면 카메라 우측 이동, y 양수면 카메라 위쪽 이동
// 예: "distance": [-1, 1], "location": [5, 6]이면 실제로는 [6, 7]에 배치됨
// 주의: x > +2 인 경우 강제로 화면 전환을 기다리며, 전환 후 동작 완료. 그 외에는 즉시 실행 및 완료
"keep_kills": false, // 카메라 이동 시 킬 수를 초기화하지 않을지. 선택 사항, 기본값 false; true인 경우 현재 웨이브 종료를 기다리지 않고 킬 수도 초기화하지 않음, 같은 웨이브 내에서 카메라를 이동하는 경우에 사용
"begin": [
100,
100,
50,
50
], // type "Swipe" 시 필수. 스와이프 시작 사각형. 720p 기준 픽셀 사각형 [x, y, w, h]. 시작점은 영역 내에서 무작위로 선택되며 현재 해상도에 맞게 자동 조정됨
"end": [
400,
400,
50,
50
], // type "Swipe" 시 필수. 스와이프 종료 사각형. 720p 기준 픽셀 사각형 [x, y, w, h]. 종료점은 영역 내에서 무작위로 선택되며 현재 해상도에 맞게 자동 조정됨
"duration": 200, // 스와이프 지속 시간. 선택 사항, 기본값 0, 단위 ms
"extra_swipe": 1, // 메인 스와이프 종료 후 추가되는 보상 스와이프 방향. 선택 사항, 기본값 0 (비활성화)
// 0은 비활성화, 1/2/3/4는 각각 위/아래/왼쪽/오른쪽
// 메인 스와이프가 끝난 후 지정 방향으로 짧은 보상 스와이프가 추가되며, 손을 뗀 후 메인 스와이프 방향의 관성을 상쇄함
// 예: 리스트를 좌우로 스와이프한 후 수직 방향의 짧은 스와이프를 추가하면, 손을 뗀 후 리스트가 계속 밀리는 것을 방지할 수 있음
"slope_in": 10, // 스와이프 시작 기울기. 선택 사항, 기본값 10. ×10 정수로 저장되며 10은 1.0을 의미
"slope_out": 10, // 스와이프 종료 기울기. 선택 사항, 기본값 10. ×10 정수로 저장되며 10은 1.0을 의미
"with_pause": false, // 스와이프 시 일시정지 작업을 동반할지 (일시정지 상태에서 스와이프해야 하는 경우). 선택 사항, 기본값 false. 일부 터치 모드에서만 지원
"high_resolution_swipe_fix": false, // 고해상도 스와이프 보정 활성화 여부. 선택 사항, 기본값 false. 대부분의 경우 켤 필요 없음: 이 보정은 Unity 스와이프 방식을 사용하지 않는 화면(현재는 메인 스테이지 내비게이션의 챕터 스와이프만 해당)을 위한 것으로, 자동 전투 중 스와이프와는 무관함
// duration·extra_swipe·slope_in·slope_out은 tasks.json의 Swipe 작업 special_params의 첫 4개 요소와
// 값 의미가 동일하여 참조할 수 있음. high_resolution_swipe_fix는 tasks.json의 독립 작업 필드인
// highResolutionSwipeFix에 해당. with_pause는 본 스키마 고유 매개변수로 tasks.json에 대응 필드가 없음
// (스와이프 시 일시정지 동반 여부는 전역 설정으로 결정되며 작업 단위로는 지정할 수 없음)
"doc": "下棘刺了！", // 설명, 선택 사항. 인터페이스에 표시됨, 실제 기능 없음
"doc_color": "orange" // 설명 글자색, 선택 사항, 기본값 회색. 인터페이스에 표시됨, 실제 기능 없음
},
// 예시 1
{
"name": "任意正常群奶",
"location": [
5,
6
],
"direction": "右"
},
// 예시 2
{
"name": "史尔特尔",
"location": [
4,
5
],
"direction": "左",
"doc": "你史尔特尔奶奶来啦！",
"doc_color": "red"
},
// 예시 3
{
"type": "二倍速"
}
],
"minimum_required": "v4.0", // MAA 최소 요구 버전, 필수
"doc": {
// 설명, 선택 사항
"title": "低练度高成功率作业",
"title_color": "dark",
"details": "对练度要求很低balabala……", // 여기에 작성자명, 공략 영상 링크 등을 적으세요
"details_color": "dark"
},
"difficulty": 0 // 작업 난이도, 선택 사항, 기본값 0
// 0: 기본, 미설정
// 1: 일반 모드 지원
// 2: 하드 모드 지원
// 3: 일반, 하드 모드 지원
}