통합 문서

약 2624 단어약 9 분

인터페이스 소개

`AsstAppendTask`

인터페이스 원형

AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* params);

반환 값

AsstTaskId
추가 성공 시 해당 작업 ID 반환, 이후 작업 파라미터 설정에 사용 가능;
추가 실패 시 0 반환

파라미터 설명

handleRequiredAsstHandle

인스턴스 핸들

typeRequiredconst char*

작업 유형

paramsRequiredconst char*

작업 파라미터, json string

작업 유형 목록

StartUp
시작 및 깨우기

enableOptionalboolean

true

본 작업 활성화 여부

client_typeRequiredstring

start_game_enabledOptionalboolean

false

클라이언트 자동 실행 여부

account_nameOptionalstring

계정 전환, 기본값은 전환하지 않음
로그인된 계정으로만 전환 가능하며, 로그인 이름으로 검색하므로 입력 내용이 로그인된 모든 계정 중 유일해야 함
공식 서버: 123****4567인 경우 123****4567, 4567, 123, 3****4567 입력 가능
Bilibili 서버: 张三인 경우 张三, 张, 三 입력 가능
번체 중국어 서버: 계정은 Email 형식이며(예: ab****01@gmail.com), 별표가 없는 평문 부분(예: 01@gmail) 입력을 권장합니다

Example

{
   "enable": true,
   "client_type": "Official",
   "start_game_enabled": true,
   "account_name": "123****4567"
}

CloseDown
게임 종료

enableOptionalboolean

true

본 작업 활성화 여부

client_typeRequiredstring

Example

{
   "enable": true,
   "client_type": "Official"
}

Fight
이성 사용 작전

enableOptionalboolean

true

본 작업 활성화 여부

stageOptionalstring

스테이지명, 기본값은 비어 있음(현재/지난 스테이지 인식). 실행 중 설정 불가
"1-7", "S3-2" 등 모든 메인 스토리 스테이지 지원
스테이지명 끝에 -NORMAL/-HARD를 추가해 난이도 전환 가능 (10-14장은 표준/재앙, 15장 이후는 일반/험지)
섬멸 작전의 경우 반드시 "Annihilation" 입력
현재 진행 중인 SideStory의 뒤쪽 3개 스테이지는 반드시 전체 스테이지 번호를 입력해야 함

medicineOptionalnumber

0

이성 회복제 최대 사용 개수

medicine_expire_daysOptionalnumber

0

지정된 일수 이내에 만료되는 이성 회복제를 사용합니다. 0은 만료 임박 이성 회복제를 사용하지 않음을 의미합니다.

expiring_medicineOptionalDeprecatednumber

0

v6.8.0부터 폐기됨. 대신 medicine_expire_days를 사용하세요.

stoneOptionalnumber

0

오리지늄 최대 사용 개수

timesOptionalnumber

2147483647

전투 횟수

seriesOptionalnumber

1

연속 전투 횟수, -1~10
-1: 전환 비활성화
0: 현재 사용 가능한 최대 횟수로 자동 전환. 만약 현재 이성이 최대 횟수 미만이면 사용 가능한 최소 횟수 선택
1~10: 지정된 연속 전투 횟수

서버 차이

입력 검증은 리소스에 FightSeries-OldMethodFlag가 있는지에 따라 달라집니다:

새 목록(중국 서버 2026/8/1 이후 주 리소스, 해당 flag 없음): -1~10 허용
이전 목록(해외 리소스에 해당 flag 있음): -1~6만 허용, 더 큰 값은 거부

해외 서버는 약 반년 후 따를 예정이며, 그때 상한은 리소스에 맞춰 10이 됩니다. Windows GUI의 연속 전투 드롭다운은 현재 고정으로 10까지 제공합니다. 해외에서 수동으로 7~10을 선택하면 작업 전달 시 Core에서 거부됩니다.

dropsOptionalobject

지정 드랍 수량, 기본값은 지정 안 함. key는 item_id, value는 수량. key는 resource/item_index.json 파일 참조
예: { "30011": 10, "30062": 5 }
위 조건들은 OR 관계이므로, 어느 하나라도 도달하면 작업 중지

report_to_penguinOptionalboolean

false

펭귄 물류(Penguin Stats) 데이터 전송 여부

penguin_idOptionalstring

펭귄 물류 전송 ID, 기본값 비어 있음. report_to_penguin이 true일 때만 유효

serverOptionalstring

CN

서버, 드랍 인식 및 업로드에 영향
옵션: CN | US | JP | KR

client_typeOptionalstring

DrGrandetOptionalboolean

false

이성 절약 모드, 오리지늄 사용 가능성이 있을 때만 유효
오리지늄 사용 확인 창에서 대기하다가, 현재 1이성이 회복되면 즉시 오리지늄을 사용

Example

{
   "enable": true,
   "stage": "1-7",
   "medicine": 1,
   "medicine_expire_days": 2,
   "stone": 0,
   "times": 10,
   "series": 0,
   "drops": {
      "30011": 10
   },
   "report_to_penguin": true,
   "penguin_id": "123456",
   "report_to_yituliu": true,
   "yituliu_id": "123456",
   "server": "CN",
   "client_type": "Official",
   "DrGrandet": false
}

일부 소수 자원 스테이지명도 지원합니다.

Recruit
공개 모집

enableOptionalboolean

true

본 작업 활성화 여부

refreshOptionalboolean

false

3성 태그 새로고침 여부

selectRequiredarray<number>

클릭할 태그 등급

confirmRequiredarray<number>

확인 클릭할 태그 등급. 공모 계산만 할 경우 빈 배열로 설정 가능

first_tagsOptionalarray<string>

우선 태그, 태그 등급이 3일 때만 유효. 기본값 비어 있음
태그 등급이 3일 때, 여기에 있는 태그(존재하는 경우)를 가능한 많이 선택하며, 강제 선택이므로 "3성 태그 선택 안 함" 설정을 무시함

extra_tags_modeOptionalnumber

0

추가 태그 선택 모드
0 - 기본 동작
1 - 충돌 가능성 무시하고 태그 3개 선택
2 - 충돌 가능성 무시하고 가능한 많은 고성급 태그 조합 동시 선택

timesOptionalnumber

0

모집 횟수. 공모 계산만 할 경우 0으로 설정 가능

set_timeOptionalboolean

true

모집 시간 설정 여부. times가 0일 때만 유효

expediteOptionalboolean

false

즉시 완료 허가증 사용 여부

expedite_timesOptionalnumber

즉시 완료 사용 횟수, expedite가 true일 때만 유효. 현재 버전에서는 적용되지 않으며, 가속은 횟수 제한 없이 times 상한까지 계속됨

skip_robotOptionalboolean

true

폐기 예정이며 구형 파라미터 호환용으로만 유지됩니다.
preserve_tags가 없고 이 값이 true이면 支援机械 인식 시에만 건너뜁니다. 元素는 더 이상 구형 1★ 태그로 취급하지 않습니다.

preserve_tagsOptionalarray<string>

현재 공개모집 슬롯을 유지한 채 이번 모집을 건너뛸 Tag 이름 목록입니다. 기본값은 빈 배열입니다.
지정한 Tag 중 하나라도 인식되면 MAA는 해당 슬롯을 유지하고 이번 모집을 건너뜁니다.

recruitment_timeOptionalobject

태그 등급(3 이상)과 대응하는 희망 모집 시간(분 단위), 기본값은 모두 540(즉 09:00:00)
예: { "3": 540, "4": 540 }

report_to_penguinOptionalboolean

false

펭귄 물류 데이터 전송 여부

penguin_idOptionalstring

펭귄 물류 전송 ID, 기본값 비어 있음. report_to_penguin이 true일 때만 유효

report_to_yituliuOptionalboolean

false

Yituliu 데이터 전송 여부

yituliu_idOptionalstring

Yituliu 전송 ID, 기본값 비어 있음. report_to_yituliu가 true일 때만 유효

serverOptionalstring

CN

서버, 업로드에 영향
옵션: CN | US | JP | KR

Example

{
   "enable": true,
   "refresh": true,
   "select": [5, 4],
   "confirm": [4, 3],
   "first_tags": ["高级资深干员"],
   "extra_tags_mode": 1,
   "times": 4,
   "set_time": true,
   "expedite": false,
   "expedite_times": 0,
   "preserve_tags": ["支援机械"],
   "recruitment_time": {
      "3": 540,
      "4": 540
   },
   "report_to_penguin": false,
   "penguin_id": "123456",
   "report_to_yituliu": false,
   "yituliu_id": "123456",
   "server": "CN"
}

Infrast
기반시설 교대

enableOptionalboolean

true

본 작업 활성화 여부

modeOptionalnumber

0

교대 작업 모드
0 - Default: 기본 교대 모드. 시설 내 및 시설 간을 포함한 효율적인 오퍼레이터 조합을 자동으로 계산합니다
10000 - Custom: 사용자 정의 교대 모드, 사용자 설정 로드. 기반시설 스케줄링 프로토콜 참고
20000 - Rotation: 원터치 로테이션 모드. 제어 센터, 발전소, 숙소, 사무실은 건너뛰고, 나머지 시설은 교대하지 않지만 기본 조작(드론 사용, 응접실 로직 등)은 유지

facilityRequiredarray<string>

dronesOptionalstring

\_NotUse

thresholdOptionalnumber

0.3

컨디션 임계값, 범위 [0, 1.0]
mode = 10000일 때 이 필드는 "autofill"에 대해서만 유효
mode = 20000일 때 이 필드는 무효

replenishOptionalboolean

false

무역소 "오리지늄 조각" 자동 보충 여부

dorm_notstationed_enabledOptionalboolean

false

작업 오퍼레이터 숙소 "미배치" 옵션 활성화 여부

dorm_trust_enabledOptionalboolean

false

숙소 남은 자리에 신뢰도 미만 오퍼레이터 배치 여부

fiammetta_targetsOptionalarray<string>

["清流", "可露希尔", "但书"]

피아메타 회복 대상 목록. 교대 시작 시 목록에서 현재 컨디션이 가장 낮은 대상 오퍼레이터가 피아메타와 함께 숙소에 배치되어 컨디션을 교환합니다. mode = 0이면서 fiammetta_recovery_enabled가 true일 때만 유효합니다.
옵션: 清流 | 可露希尔 | 但书 | 巫恋 | 龙舌兰 | 歌蕾蒂娅 (옵션 외 또는 중복 항목은 무시됨)

fiammetta_recovery_enabledOptionalboolean

false

교대 시작 시 피아메타로 회복 대상의 컨디션을 회복할지 여부입니다. 비활성화 시 교대가 숙소 준비 단계를 건너뜁니다. mode = 0일 때만 유효합니다.

use_pinus_sylvestrisOptionalboolean

false

｢피누스 실베스트리스｣ 시설 간 연계 활성화 여부. mode = 0일 때만 유효합니다.

use_perception_informationOptionalboolean

false

｢감지 정보｣ 시설 간 연계 활성화 여부. ｢속세의 번뇌｣보다 우선순위가 높습니다. mode = 0일 때만 유효합니다.

use_worldly_plightOptionalboolean

false

｢속세의 번뇌｣ 시설 간 연계 활성화 여부. mode = 0일 때만 유효합니다.

use_abyssal_hunterOptionalboolean

false

｢어비설 헌터｣ 시설 간 연계 활성화 여부. mode = 0일 때만 유효하며, ｢피누스 실베스트리스｣와 동시에 활성화하면 두 연계는 동시에 교대에 참여하지 않습니다.

reception_message_boardOptionalboolean

true

응접실 게시판 크레딧 수령 여부

reception_clue_exchangeOptionalboolean

true

단서 교환 수행 여부

reception_send_clueOptionalboolean

true

단서 보내기 여부

filenameRequiredstring

사용자 정의 설정 경로. 실행 중 설정 불가

mode = 10000일 때만 유효

plan_indexRequirednumber

설정 내 사용할 플랜 번호. 실행 중 설정 불가

mode = 10000일 때만 유효

continue_trainingOptionalboolean

false

훈련실에서 완료되지 않은 특화 훈련을 계속할지 여부

Example

{
   "enable": true,
   "mode": 0,
   "facility": ["Mfg", "Trade", "Reception"],
   "drones": "PureGold",
   "threshold": 0.3,
   "replenish": true,
   "dorm_notstationed_enabled": false,
   "dorm_trust_enabled": true,
   "reception_message_board": true,
   "reception_clue_exchange": true,
   "reception_send_clue": true,
   "filename": "schedules/base.json",
   "plan_index": 1
}

Mall
크레딧 수령 및 상점 구매
먼저 buy_first 목록 순서대로 구매하고, 그 다음 blacklist를 제외하고 왼쪽에서 오른쪽으로 구매하며, 크레딧이 넘칠 경우 블랙리스트를 무시하고 넘치지 않을 때까지 구매

enableOptionalboolean

true

본 작업 활성화 여부

visit_friendsOptionalboolean

true

친구 기반시설을 방문하여 크레딧 획득 여부

shoppingOptionalboolean

true

크레딧 상점 구매 수행 여부

buy_firstOptionalarray<string>

[]

우선 구매 목록. 상품명, 예: "채용 허가증", "용문폐" 등

blacklistOptionalarray<string>

[]

구매 블랙리스트. 상품명, 예: "즉시 완료 허가증", "가구 부품" 등

force_shopping_if_credit_fullOptionalboolean

false

크레딧 넘침 시 블랙리스트 무시 여부

only_buy_discountOptionalboolean

false

할인 상품만 구매 여부, 2차 구매(목록 순서 외)에만 적용

reserve_max_creditOptionalboolean

false

크레딧이 300 미만일 때 구매 중지 여부, 2차 구매에만 적용

credit_fightOptionalboolean

false

다음 날 더 많은 크레딧을 얻기 위해 지원을 빌려 OF-1 스테이지를 1회 클리어할지 여부

formation_indexOptionalnumber

0

OF-1 플레이 시 사용할 편성 슬롯 번호
0~4의 정수, 0은 현재 편성, 1~4는 제1~4 편성

Example

{
   "enable": true,
   "visit_friends": true,
   "shopping": true,
   "buy_first": ["招聘许可", "龙门币"],
   "blacklist": ["家具零件"],
   "force_shopping_if_credit_full": false,
   "only_buy_discount": true,
   "reserve_max_credit": false,
   "credit_fight": false,
   "formation_index": 0
}

Award
각종 보상 수령

enableOptionalboolean

true

본 작업 활성화 여부

awardOptionalboolean

true

일일/주간 임무 보상 수령

mailOptionalboolean

false

모든 우편 보상 수령

recruitOptionalboolean

false

한정 헤드헌팅 매일 무료 단차 수령

orundumOptionalboolean

false

합성옥 추첨(LUCKY WALL 등) 보상 수령

miningOptionalboolean

false

한정 채굴 허가(합성옥 채굴) 보상 수령

specialaccessOptionalboolean

false

5주년 등 이벤트 월정액 보상 수령

signineventOptionalboolean

false

기간 한정 출석 이벤트 보상 수령 (가로형 레이아웃만 지원)

Example

{
   "enable": true,
   "award": true,
   "mail": true,
   "recruit": true,
   "orundum": false,
   "mining": true,
   "specialaccess": false,
   "signinevent": false
}

SwitchTheme
게임 메인 화면 테마 전환

enableOptionalboolean

true

본 작업 활성화 여부

themesRequiredstring[]

후보 테마 이름 목록으로, 게임 내 테마 목록에 표시되는 이름과 일치해야 합니다. 여러 개를 입력하면 실행할 때마다 무작위로 하나가 선택되며, 빈 배열이면 작업을 건너뜁니다.

Example

{
   "enable": true,
   "themes": ["夜间", "银凇"]
}

Roguelike
통합 전략 무한 반복

enableOptionalboolean

true

본 작업 활성화 여부

themeOptionalstring

Phantom

테마
Phantom - 팬텀 & 크림슨 솔리테어
Mizuki - 미즈키 & 카이룰라 아버
Sami - 탐험가의 은빛 서리 끝자락
Sarkaz - 살카즈의 영겁 기담
JieGarden - 쉐이의 기이한 계원
BlackFlow - 블랙 플로우

modeOptionalnumber

0

모드
0 - 점수/보상 포인트 파밍, 가능한 안정적으로 많은 층수 도달
1 - 오리지늄 각뿔 파밍, 1층 투자 후 퇴각
2 - 제거됨 기존 모드 0과 1 겸용, 현재 버전에서는 입력 시 거부됨
3 - 미개방 입력 시 거부됨
4 - 스타트 리세마라, 난이도 0으로 3층 도달 후 재시작, 지정 난이도에서 스타트 보상 확인. 전기주전자나 희망이 아니면 난이도 0으로 돌아가 반복; Phantom 테마는 난이도 전환 없이 현재 난이도에서 반복
5 - 붕괴 패러다임 파밍; Sami 테마 전용; 전투 중 적을 흘려 붕괴치를 빠르게 누적, 첫 붕괴 패러다임이 expected_collapsal_paradigms 목록에 있으면 정지, 아니면 재시작
6 - 월간 소대 보상 파밍, 모드 적응 외엔 모드 0과 동일
7 - 심층 조사 보상 파밍, 모드 적응 외엔 모드 0과 동일
10001 - 1층 빠른 클리어. Sarkaz 테마 전용
20001 - 상락(常樂) 노드 파밍. 1층 진입 후 필요한 노드가 없으면 재시작. JieGarden 테마 전용이며 find_playTime_target 필요
30001 - 포대기 동물 파밍, BlackFlow 테마 전용

squadOptionalstring

指挥分队

시작 분대명

rolesOptionalstring

取长补短

시작 모집 조합

core_charOptionalstring

시작 오퍼레이터명. 단일 오퍼레이터 중문명만 지원(서버 무관); 비워두거나 ""이면 육성도에 따라 자동 선택. core_char_list의 1순위와 동등하며, 구버전 호출자 호환을 위해서만 유지됨

core_char_listOptionalarray<object>

시작 오퍼레이터 목록. 각 항목은 { "name": 오퍼레이터명, "use_support": 지원 유닛 사용 여부 }이며, 오퍼레이터명은 마찬가지로 중문명만 지원(서버 무관). 배열 순서대로 시작 시 1·2·3번째 모집에 대응하며, 세 순위의 오퍼레이터는 서로 다른 직업이어야 함. 모집은 앞쪽 몇 페이지만 탐색하므로 희망 소모가 낮은 오퍼레이터는 목록 뒤쪽에 있어 찾지 못할 수 있음. 특정 순위에서 오퍼레이터를 모집하지 못한 경우(보유·지원 유닛 모두 등장하지 않은 경우) 해당 회차는 기본 우선순위로 모집되므로, 희망 소모가 높은 오퍼레이터를 앞쪽에 배치하는 것을 권장함. core_char와 함께 전달되면 이 필드가 우선됨

use_supportOptionalboolean

false

시작 오퍼레이터를 지원 유닛으로 빌릴지 여부. core_char_list 1순위의 지원 유닛 사용 플래그와 동등하며, 구버전 호출자 호환을 위해서만 유지됨

use_nonfriend_supportOptionalboolean

false

친구가 아닌 지원 유닛 사용 가능 여부. 지원 유닛을 사용하는 모든 시작 순위에 적용되는 전역 스위치

starts_countOptionalnumber

2147483647

탐색 시작 횟수. 도달 시 자동 정지

difficultyOptionalnumber

-1

지정 난이도 등급, -1는 미지정. 미해금 시 현재 해금된 최고 난이도 선택

stop_at_final_bossOptionalboolean

false

5층 보스 노드 앞에서 정지할지 여부. Phantom 제외 테마에만 적용

stop_at_max_levelOptionalboolean

false

통합 전략 만렙 도달 시 정지할지 여부

investment_enabledOptionalboolean

true

오리지늄각뿔 투자 여부

investments_countOptionalnumber

2147483647

투자 횟수. 도달 시 자동 정지

stop_when_investment_fullOptionalboolean

false

투자 한도 도달 시 자동 정지 여부

investment_with_more_scoreOptionalboolean

false

투자 후 쇼핑 시도 여부. 모드 1에만 적용

start_with_elite_twoOptionalboolean

false

스타트 리세마라 시 2차 정예화도 함께 노릴지 여부. 모드 4에만 적용

only_start_with_elite_twoOptionalboolean

false

다른 스타트 조건 무시하고 2차 정예화만 노릴지 여부. 모드 4이고 start_with_elite_two가 true일 때만 유효

refresh_trader_with_diceOptionalboolean

false

주사위로 상점을 새로고침하여 특수 상품 구매 시도 여부. Mizuki 테마 전용, 길잡이 비늘 파밍용

first_floor_foldartalOptionalstring

1층 원견 단계에서 얻길 희망하는 암호문. Sami 테마 전용, 모드 무관; 성공 시 정지

start_foldartal_listOptionalarray<string>

[]

스타트 리세마라 시 시작 보상으로 얻길 희망하는 암호문 목록. Sami 테마 모드 4일 때만 유효
목록의 모든 암호문을 보유해야 성공으로 간주
주의: "생존지상 분대"와 함께 사용해야 함. 다른 분대는 시작 보상으로 암호문을 얻지 못함

collectible_mode_start_listOptionalobject

스타트 리세마라 시 희망 보상, 기본값은 모두 false. 모드 4일 때만 유효
hot_water: 전기주전자 보상, 파밍 매커니즘 트리거용 (공통)
shield: 보호막 값 보상, 추가 체력 (공통)
ingot: 오리지늄 각뿔 보상 (공통)
hope: 희망 보상 (공통, 주의: JieGarden 테마는 hope 보상 없음)
random: 랜덤 보상 옵션: 게임 내 "모든 각뿔을 소모하여 랜덤 소장품 1개 획득" (공통)
key: 열쇠 보상, Mizuki 테마 전용
dice: 주사위 보상, Mizuki 테마 전용
ideas: 구상 2개 보상, Sarkaz 테마 전용
ticket: 티켓 보상, JieGarden 테마 전용

use_foldartalOptionalboolean

암호문 사용 여부. 모드 5 기본값 false, 기타 모드 기본값 true. Sami 테마 전용

check_collapsal_paradigmsOptionalboolean

획득한 붕괴 패러다임 감지 여부. 모드 5 기본값 true, 기타 모드 기본값 false

double_check_collapsal_paradigmsOptionalboolean

true

붕괴 패러다임 누락 방지 검사 수행 여부. Sami 테마이고 check_collapsal_paradigms가 true일 때 유효. 모드 5 기본값 true, 기타 모드 기본값 false

expected_collapsal_paradigmsOptionalarray<string>

['目空一些', '睁眼瞎', '图像损坏', '一抹黑']

희망하는 붕괴 패러다임. Sami 테마이고 모드 5일 때 유효

monthly_squad_auto_iterateOptionalboolean

월간 소대 자동 전환 활성화 여부

monthly_squad_check_commsOptionalboolean

월간 소대 통신 완료 여부도 전환 기준으로 삼을지 여부

deep_exploration_auto_iterateOptionalboolean

심층 조사 자동 전환 활성화 여부

collectible_mode_shoppingOptionalboolean

false

파밍 중 쇼핑 활성화 여부

collectible_mode_squadOptionalstring

파밍 중 사용할 분대, 기본적으로 squad와 동기화, squad가 비었고 이 값도 없으면 지휘 분대

start_with_seedOptionalstring

시드 파밍에 사용할 고정 시드, 비워 두면 비활성화
Sarkaz 테마, Investment 모드, "연금술 분대" 또는 "지원 분대"일 때만 유효

blackflow_strategyOptionalstring

블랙 플로우 테마의 전략. 비워 두면 mode와 investment_enabled 값으로부터 추론됩니다.
baby_animal - 1층에서 일반 상점을 확인한 뒤, 2·3층을 탐색하여 秘境行商(비밀 상인)에서 씨앗을 육성합니다. blackflow_cultivation_target와 함께 사용해야 합니다
investment - 1층에서 전투 횟수가 가장 적고 예상 시간이 가장 짧은 경로로 고정 일반 상점에 도달합니다
burn_with_investment - 1층에서 투자를 완료한 후 최대한 빨리 3층에 도달하여 도착 즉시 재시작합니다
burn - 최대한 빨리 3층에 도달하여 도착 즉시 재시작합니다

blackflow_cultivation_targetOptionalstring

swaddled_cat

포대기 동물 파밍 모드의 목표. 선택 가능한 값: swaddled_cat(포대기의 고양이) | swaddled_feathered_serpent(포대기의 깃털 뱀) | swaddled_dog(포대기의 개) | swaddled_cerberus(포대기의 케르베로스). blackflow_strategy가 baby_animal일 때만 사용됩니다.

find_playTime_targetOptionalnumber

상락(常樂) 노드 파밍 모드의 목표 노드입니다. 선택 가능한 값: 1(Ling/令) | 2(Shu/黍) | 3(Nian/年). JieGarden 테마이자 mode = 20001일 때만 사용되며, 해당 모드에서는 필수입니다. 미입력 시 또는 범위 밖의 값은 작업 매개변수 설정에 실패합니다.

Example

{
   "enable": true,
   "theme": "Sami",
   "mode": 5,
   "squad": "指挥分队",
   "roles": "稳扎稳打",
   "core_char_list": [
      { "name": "维什戴尔", "use_support": true },
      { "name": "古米", "use_support": false },
      { "name": "史都华德", "use_support": false }
   ],
   "use_nonfriend_support": false,
   "starts_count": 3,
   "difficulty": 8,
   "stop_at_final_boss": false,
   "stop_at_max_level": false,
   "investment_enabled": true,
   "investments_count": 2,
   "stop_when_investment_full": false,
   "investment_with_more_score": false,
   "start_with_elite_two": false,
   "only_start_with_elite_two": false,
   "refresh_trader_with_dice": false,
   "first_floor_foldartal": "",
   "start_foldartal_list": [],
   "collectible_mode_start_list": {
      "hot_water": true,
      "shield": false,
      "ingot": false,
      "hope": true,
      "random": false,
      "key": false,
      "dice": false,
      "ideas": false
   },
   "use_foldartal": true,
   "check_collapsal_paradigms": true,
   "double_check_collapsal_paradigms": true,
   "expected_collapsal_paradigms": ["目空一些", "睁眼瞎"],
   "monthly_squad_auto_iterate": false,
   "monthly_squad_check_comms": false,
   "deep_exploration_auto_iterate": false,
   "collectible_mode_shopping": false,
   "collectible_mode_squad": "",
   "start_with_seed": ""
}

붕괴 패러다임 파밍 기능에 대한 자세한 내용은 통합 전략 보조 프로토콜을 참고하세요.

Copilot
자동지휘

enableOptionalboolean

true

본 작업 활성화 여부

filenamestring

단일 작전 JSON 파일 경로, copilot_list와 택일(필수); 상대/절대 경로 모두 가능

copilot_listarray`<object>

작전 목록, filename과 택일(필수); filename과 copilot_list 동시 존재 시 copilot_list 무시; 이 파라미터 유효 시 set_params는 1회만 실행 가능
각 객체 포함:

filename: 작전 JSON 파일 경로; 상대/절대 경로 모두 가능
nav_name_override: 내비게이션용 스테이지명, 선택 사항; 제공되지 않았거나 null인 경우 작업 파일에서 자동으로 추론합니다
is_raid: 하드 모드 전환 여부, 선택 사항, 기본값 false

loop_timesOptionalnumber

1

반복 횟수. 단일 작전 모드(filename 지정)에서만 유효; 이 파라미터 유효 시 set_params는 1회만 실행 가능

use_sanity_potionOptionalboolean

false

이성 부족 시 이성 회복제 사용 허용 여부

formationOptionalboolean

false

자동 편성 수행 여부

formation_indexOptionalnumber

0

자동 편성 시 사용할 편성 슬롯 번호. formation이 true일 때 유효
0–4 정수, 0은 현재 편성 선택, 1-4는 제1, 2, 3, 4 편성

user_additionalOptionalarray`<object>

[]

사용자 정의 추가 오퍼레이터 목록. formation이 true일 때 유효
각 객체 포함:

name: 오퍼레이터명, 선택 사항, 기본값 "", 비워두면 무시됨
skill: 휴대 스킬, 선택 사항, 기본값 0 (게임 내 기본 스킬 선택 따름); 1–3 정수, 범위 벗어나면 게임 내 기본 스킬 선택 따름

add_trustOptionalboolean

false

자동 편성 시 남은 자리를 신뢰도 낮은 순으로 채울지 여부. formation이 true일 때 유효

ignore_requirementsOptionalboolean

false

자동 편성 시 오퍼레이터 육성 요구조건 무시 여부. formation이 true일 때 유효

support_unit_usageOptionalnumber

0

지원 유닛 사용 모드. 0–3 정수. formation이 true일 때 유효
0 - 지원 유닛 사용 안 함
1 - 결원이 딱 1명일 때만 지원 유닛으로 보충, 결원 없으면 안 씀
2 - 결원이 딱 1명일 때 지원 유닛 보충 시도, 결원 없으면 지정된 지원 유닛 사용
3 - 결원이 딱 1명일 때 지원 유닛 보충 시도, 결원 없으면 랜덤 지원 유닛 사용

support_unit_nameOptionalstring

지정 지원 유닛명. support_unit_usage가 2일 때 유효

작전 JSON은 자동지휘 프로토콜을 참고하세요.

Example

{
   "enable": true,
   "filename": "copilot/1-7.json",
   "loop_times": 2,
   "use_sanity_potion": false,
   "formation": true,
   "formation_index": 1,
   "user_additional": [
      {
         "name": "能天使",
         "skill": 3
      }
   ],
   "add_trust": true,
   "ignore_requirements": false,
   "support_unit_usage": 2,
   "support_unit_name": "艾雅法拉"
}

SSSCopilot
보안 파견 자동지휘

enableOptionalboolean

true

본 작업 활성화 여부

filenameRequiredstring

작전 JSON 파일 경로, 절대/상대 경로 모두 가능. 실행 중 설정 불가

loop_timesOptionalnumber

반복 실행 횟수

보안 파견 작전 JSON은 보안 파견 프로토콜을 참고하세요.

Example

{
   "enable": true,
   "filename": "sss/plan.json",
   "loop_times": 1
}

ParadoxCopilot 패러독스 시뮬레이션 작전 계획 자동 수행

enableOptionalboolean

true

본 작업 활성화 여부.

filenameRequiredstring

단일 작전 JSON 파일 경로, 절대/상대 경로 모두 가능. 실행 중 설정 불가. 필수, list와 택일.

listRequiredarray`<object>` | array`<string>

작전 목록, 실행 중 설정 불가. 필수, filename과 택일.
배열 요소는 두 가지 형식을 지원합니다: 객체 형식은 id(작전 식별자, CopilotListLoadTaskFileSuccess 콜백에 그대로 전달됨)와 filename(작전 JSON 파일 경로, 절대/상대 경로 모두 가능)을 포함하며, 작전 경로 문자열을 직접 사용할 수도 있습니다.

Example

{
   "enable": true,
   "filename": "paradox/exusiai.json",
   "list": []
}

Depot
창고 인식

enableOptionalboolean

true

본 작업 활성화 여부

Example

{
   "enable": true
}

OperBox
오퍼레이터 인식

enableOptionalboolean

true

본 작업 활성화 여부

Example

{
   "enable": true
}

Reclamation
생존 연산

enableOptionalboolean

true

본 작업 활성화 여부

themeOptionalstring

Tales

테마
Fire - 모래 속의 불（종료）
Tales - 사막 이야기
RelaunchAnchor - 리런치 앵커

modeOptionalnumber

0

모드. 테마마다 지원하는 모드가 다릅니다:
Tales（사막 이야기）：
0 - 세이브 없음, 스테이지 반복으로 번영의 선물 획득。
1 - 세이브 있음, 도구 제작으로 번영의 선물 획득。
RelaunchAnchor（리런치 앵커）：
16 (RA1) - RA-1, 정경세작→건설→자원 납품→결산 자동 루프。
32 (RA15) - RA-15, 시빌라이트 에테르나로 60킬 미션 달성。
48 (RA4) - RA-4, "경영 계획"으로 얻은 적금을 사용하여 지역을 해금하고, 비샤델로 보스 처치 임무를 완료합니다。

tools_to_craftOptionalarray<string>

[]

자동 제작 아이템, 부분 문자열 입력 권장, 비워 두면 제작하지 않음. Tales 테마의 세이브 있는 모드(mode = 1)에서만 유효

clear_storeOptionalboolean

false

작업 완료 후 상점 상품 구매(비우기) 여부. Tales 테마의 세이브 없는 모드(mode = 0)에서만 유효

increment_modeOptionalnumber

0

클릭 유형. Tales 테마에서만 유효
0 - 연타
1 - 꾹 누르기

num_craft_batchesOptionalnumber

16

1회 최대 제작 배치 수. Tales 테마에서만 유효

Example

{
   "enable": true,
   "theme": "Fire",
   "mode": 1,
   "tools_to_craft": ["荧光棒", "发电机"],
   "increment_mode": 0,
   "num_craft_batches": 12
}

Custom
사용자 정의 작업

enableOptionalboolean

true

본 작업 활성화 여부

task_namesRequiredarray<string>

배열 중 첫 번째로 매칭된 작업(및 후속 next 등)을 실행. 여러 작업을 실행하려면 Custom task를 여러 번 append 시크릿 프론트(MiniGame@SecretFront) 연결 형식 지원: MiniGame@SecretFront@Begin@Ending[A-E](@이벤트명)?, 이벤트명은 생략 가능(支援作战平台 / 游侠 / 诡影迷踪), 예: MiniGame@SecretFront@Begin@EndingA@支援作战平台。

paramsOptionalobject

작업 추가 파라미터. 현재는 픽셀 아트 작업(MiniGame@PixelPaint@Begin)에서만 사용:

params.pixel_paint.groups: 색상별 칸 좌표 목록. color는 팔레트 슬롯 번호(0~39, 게임 오른쪽 팔레트 순서와 동일), points는 [x, y] 칸 좌표 배열(0~23, 왼쪽 위 원점).
params.pixel_paint.swipe(bool, 선택, 기본 true): 같은 색 연속 칸을 한 번의 드래그로 그려 속도를 높임. 일부 터치 방식에서는 이상 동작이 있을 수 있음.
params.pixel_paint.grid_delay(int, 선택, 기본 0): 칸당 추가 대기 시간(ms). 클릭 후 대기와 드래그 시간에 모두 가산됩니다. 각 터치 방식에 기본 간격이 있어 보통 조정 불필요. 구 키 grid_click_delay 도 호환됩니다.

Example

{
   "enable": true,
   "task_names": ["StartUp", "Infrast", "Fight"]
}

{
   "enable": true,
   "task_names": ["MiniGame@PixelPaint@Begin"],
   "params": {
      "pixel_paint": {
         "groups": [
            { "color": 7, "points": [[0, 1], [3, 4]] }
         ]
      }
   }
}

SingleStep
단일 단계 작업 (현재 전투만 지원)

enableOptionalboolean

true

본 작업 활성화 여부

typeRequiredstring

copilot

현재 "copilot"만 지원

subtypeRequiredstring

서브 작업 유형
stage - 스테이지명 설정, "details": { "stage_name": "xxxx" } 필요
start - 작전 시작, details 없음
action - 단일 작전 조작, details는 작전 프로토콜 중 단일 action이어야 함. 예: "details": { "name": "수르트", "location": [ 4, 5 ], "direction": "左" }. 상세 내용은 자동지휘 프로토콜 참고

detailsOptionalobject

서브 작업 상세 파라미터

Example

{
   "enable": true,
   "type": "copilot",
   "subtype": "stage",
   "details": {
      "stage_name": "1-7"
   }
}

VideoRecognition
영상 인식, 현재 작전(전투) 영상만 지원

enableOptionalboolean

true

본 작업 활성화 여부

filenameRequiredstring

영상 파일 경로, 절대/상대 경로 모두 가능. 실행 중 설정 불가

Example

{
   "enable": true,
   "filename": "videos/copilot.mp4"
}

`AsstSetTaskParams`

인터페이스 원형

AsstBool ASSTAPI AsstSetTaskParams(AsstHandle handle, AsstTaskId id, const char* params);

인터페이스 설명

작업 파라미터 설정

반환 값

AsstBool
설정 성공 여부 반환

파라미터 설명

handleRequiredAsstHandle

인스턴스 핸들

idRequiredAsstTaskId

작업 ID, AsstAppendTask 인터페이스 반환 값

paramsRequiredconst char\*

작업 파라미터, json string, AsstAppendTask 인터페이스와 동일 "실행 중 설정 불가"로 표시되지 않은 필드는 실시간 수정 가능; 표시된 경우 현재 작업이 실행 중이면 해당 필드 무시

`AsstSetStaticOption`

인터페이스 원형

AsstBool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);

인터페이스 설명

프로세스 레벨 파라미터 설정

반환 값

AsstBool
설정 성공 여부 반환

파라미터 설명

keyRequiredAsstStaticOptionKey

Key

valueRequiredconst char\*

Value

키-값 목록

InvalidOptionalnumber

0

무효 점유. 열거값: 0

CpuOCROptionalboolean

CPU로 OCR 수행. 값은 파싱에 사용되지 않음. 리소스 로드 후 전환 불가. 열거값: 1

GpuOCROptionalstring

GPU로 OCR 수행. 값은 GPU 장치 번호(정수), Windows에서는 luid:<16진수 LUID>도 가능. 리소스 로드 후 전환 불가. 열거값: 2

`AsstSetInstanceOption`

인터페이스 원형

AsstBool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key, const char* value);

인터페이스 설명

인스턴스 레벨 파라미터 설정

반환 값

AsstBool
설정 성공 여부 반환

파라미터 설명

handleRequiredAsstHandle

인스턴스 핸들

keyRequiredAsstInstanceOptionKey

Key

valueRequiredconst char\*

Value

키-값 목록

InvalidOptionalnumber

0

무효 점유. 열거값: 0

MinitouchEnabledOptionalboolean

폐기됨. 원 Minitouch 활성화 여부; "1" 켜기, "0" 끄기. 장치가 지원하지 않을 수 있음. 열거값: 1 (폐기됨)

TouchModeOptionalstring

minitouch

DeploymentWithPauseOptionalboolean

오퍼레이터 배치 시 일시정지 여부, 자동지휘/통합 전략/보안파견에 모두 영향. 옵션: "1" 켜기, "0" 끄기. 열거값: 3

AdbLiteEnabledOptionalboolean

AdbLite 사용 여부. 옵션: "0" 끄기, "1" 켜기. 열거값: 4

KillAdbOnExitOptionalboolean

종료 시 ADB 프로세스 종료 여부. 옵션: "0" 끄기, "1" 켜기. 열거값: 5

ClientTypeOptionalstring

클라이언트 종류(게임 채널). 대부분의 연결 설정에서는 필요하지 않습니다. AsstConnect / AsstAsyncConnect 에 전달하는 config 가 연결 단계에서 실행되는 명령에 [PackageName] 을 사용할 때만, 연결 전에 AsstSetInstanceOption(..., ClientType, ...) 를 호출해 설정해야 합니다. 현재 내장 설정 중에서는 Androws 와 WSA 의 displayId 조회만 이 값에 의존합니다. 이 옵션은 StartUp / CloseDown 등의 작업 파라미터 client_type 를 대체하지 않습니다. 열거값: 6