インターフェース紹介

AsstAppendTask

インターフェース プロトタイプ

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

インターフェースの説明

タスクを追加します。

返回値

• AsstTaskId
  追加に成功した場合、タスク ID を返します。後続のタスク パラメータ設定に使用できます；
  追加に失敗した場合、0 を返します。

パラメータ説明

handleRequiredAsstHandle

インスタンス ハンドル

typeRequiredconst char*

タスク タイプ

paramsRequiredconst char*

タスク パラメータ、JSON 文字列

タスク タイプ一覧

• StartUp
  ゲーム起動

enableOptionalboolean

true

このタスクを有効にするかどうか。

client_typeRequiredstring

クライアント バージョン。
オプション：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR

start_game_enabledOptionalboolean

false

クライアントを自動的に起動するかどうか。

account_nameOptionalstring

アカウントを切り替えます。デフォルトでは切り替えません。
ログイン済みのアカウントへの切り替えのみ可能で、ログイン名で検索し、入力内容がすべてのログイン済みアカウント間で一意であることを確認してください。
Official：123****4567、入力可能：123****4567、4567、123、3****4567
Bilibili：张三、入力可能：张三、张、三
繁体字中国語サーバー：Eメール形式（例：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

クライアント バージョン。空白を入力すると実行されません。
オプション：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR

Example

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

• Fight
  作戦

enableOptionalboolean

true

このタスクを有効にするかどうか。

stageOptionalstring

ステージ名。デフォルトは空で、現在/最後のステージを認識します。実行中の設定はサポートされていません。 ナビゲーション対象のステージは以下の通りです：

• すべてのメイン ストーリー ステージ。ステージ末尾に -NORMAL または -HARD を付けて難易度を切り替えできます（10〜14章は標準/厄難、15章以降は通常/険地）。
• 龍門幣、作戦記録の 5/6 関。ただし CE-6 / LS-6 と入力する必要があります。MAA は 6 関が代理できない場合は自動的に 5 関に切り替わります。
• スキル本、購買資格証、炭素材の第 5 関。CA-5 / AP-5 / SK-5 と入力する必要があります。
• すべてのチップ本。完全なステージ番号を入力する必要があります（例：PR-A-1）。
• 殲滅モードは以下の入力値をサポートし、対応する Value を使用する必要があります：
• 当期殲滅：Annihilation
• チェルノボーグ：Chernobog@Annihilation
• 龍門郊外：LungmenOutskirts@Annihilation
• 龍門市街：LungmenDowntown@Annihilation
• 別伝の OF-1 / OF-F3。
• 当期 SS イベントの最後の 3 ステージ。API にアクセスして、サポートされているステージ リストを取得できます。tasks.json ファイルのイベント ステージ ナビゲーションを追加でロードする必要があります。
• 復刻 SS イベント。SSReopen-<ステージ プレフィックス> と入力します。例えば SSReopen-IC と入力すると、XX-1～XX-9 ステージを一度に完了できます。

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

ドロップ数を指定します。デフォルトで指定なし。キーは item_id、値は数量です。キーは resource/item_index.json ファイルを参照できます。
例：{ "30011": 10, "30062": 5 }
上記はすべて OR 関係です。つまり、いずれかに達するとタスクが停止します。

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

client_typeOptionalstring

クライアント バージョン。デフォルトは空です。ゲームがクラッシュした場合にクライアントを再起動して接続し直すために使用されます。空の場合、この機能は有効になりません。
オプション：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR

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>

確認するタグレベル。計算のみの場合は、空配列に設定できます。

level3_recruitment_permit_reserveOptionalnumber

0

星3の自動確認時に残しておく求人票の枚数です。現在の求人票数がこの値以下の場合は星3募集をスキップします。星4以上の募集には影響しません。0 に設定すると無効になります。有効時に枚数の認識に失敗した場合も、求人票を誤って消費しないよう現在の星3募集をスキップします。

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],
   "level3_recruitment_permit_reserve": 8,
   "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>

シフト対象施設。実行中の設定はサポートされていません。
mode = 0 の場合、この配列は有効化セットとして扱われ、順序と重複はスケジューリングに影響しません（交代順序はアルゴリズムが自動的に決定します）。mode = 10000 / 20000 の場合は配列の順序で処理されます。
施設名：Mfg | Trade | Power | Control | Reception | Office | Recycle | Dorm | Processing | Training | AssistantChange

dronesOptionalstring

\_NotUse

ドローン使用目的。mode = 10000 の場合、このフィールドは無効です。
オプション：_NotUse | Money | SyntheticJade | CombatRecord | PureGold | OriginStone | Chip

thresholdOptionalnumber

0.3

作業心情しきい値。範囲は [0, 1.0] です。
mode = 10000 の場合、このフィールドは ｢自動入力｣ にのみ有効です。
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

応接室の伝言板FPを受け取るかどうか。

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
  FP受け取りと商店購物。
  まず buy_first にあるものを順番に 1 回購入し、次に左から右に 2 回購入して blacklist を回避し、FP溢出時はブラックリストを無視して左から右に 3 回購入して溢出しなくなるまで続けます。

enableOptionalboolean

true

このタスクを有効にするかどうか。

visit_friendsOptionalboolean

true

フレンドの基地にアクセスしてFPを獲得するかどうか。

shoppingOptionalboolean

true

購物するかどうか。

buy_firstOptionalarray<string>

[]

優先購買リスト。商品名、例："招聘许可"、"龙门币" など。

blacklistOptionalarray<string>

[]

購物ブラックリスト。商品名、例："加急许可"、"家具零件" など。

force_shopping_if_credit_fullOptionalboolean

false

FP溢出時にブラックリストを無視するかどうか。

only_buy_discountOptionalboolean

false

割引品のみを購入するかどうか。2 回目の購買にのみ適用されます。

reserve_max_creditOptionalboolean

false

FP ポイントが 300 未満の場合、購買を停止するかどうか。2 回目の購買にのみ適用されます。

credit_fightOptionalboolean

false

サポートを借りて OF-1 を 1 回クリアし、翌日により多くのFPを獲得するかどうか。

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

限定ガチャから送信される毎日の無料 1 回引きを受け取るかどうか。

orundumOptionalboolean

false

ラッキー ウォール/おみくじの合成玉報酬を受け取るかどうか。

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[]

候補テーマ名のリスト。ゲーム内のテーマ一覧に表示される名称と一致させてください。複数指定した場合は実行ごとにランダムに 1 つ選択され、空の配列の場合はスキップします。

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 テーマでは難易度を変更せず、現在の難易度で第 3 層到達後リセット、開局リセットを試行します。
5 - パラダイムロストを稼ぎます。Sami テーマのみに対応します。戦闘漏れなどで崩壊値の蓄積を加速化し、最初に遭遇したパラダイムロストが expected_collapsal_paradigms リストにある場合はタスクを停止、そうでなければリセット。
6 - 月次小隊を稼ぎ、モード 0 と同じですがモード固有の適応あり。
7 - 多面調査を稼ぎ、モード 0 と同じですがモード固有の適応あり。
10001 - 第 1 層を素早く通過。Sarkaz テーマのみ対応。
20001 - 常楽ノードを稼ぎます。第 1 層で洞窟に入り、必要なノードが見つからなければリセット。JieGarden テーマ専用で、find_playTime_target との併用が必要です。
30001 - 襁褓動物の入手。BlackFlow テーマ専用。
30003 - 初期報酬稼ぎ。まず準備用の探索を行い、その後に目標の探索を開始します。準備用の探索は blackflow_start_animals で指定した襁褓動物を入手して第 3 層に入った後に放棄します。目標の探索では支援選択画面に blackflow_start_rewards のいずれかが出れば選択せずにテーマ画面へ退出し、その探索を保持したままタスクを終了します。準備用の探索は collectible_mode_squad を使用し、difficulty が -1 でない場合は難易度 0 で行います。目標の探索は squad と difficulty を使用し、支援選択画面で終了します。roles と最初のオペレーターは準備用の探索に使用され、collectible_mode_roles と collectible_mode_core_char_list を指定した場合は準備用の探索でそちらを使用します。blackflow_start_utopia が有効な場合、目標の探索は報酬を選んで第 1 層に入ります。該当項目を参照してください。BlackFlow テーマ専用で、blackflow_start_animals と blackflow_start_rewards との併用が必要です。（機械翻訳）

squadOptionalstring

指挥分队

開局分隊名。

rolesOptionalstring

取长补短

開局職業グループ。

core_charOptionalstring

開局オペレーター名。単一のオペレーター中国語名のみ対応、サーバー関係なし。空欄または空文字列 "" の場合は練度に応じて自動選択。core_char_list の第 1 順位と等価で、旧呼び出し元との互換性のためのみ保持。

core_char_listOptionalarray<object>

開局オペレーターリスト。各項目は { "name": オペレーター名, "use_support": サポートを使用するかどうか } で、オペレーター名は同じく中国語名のみ対応、サーバー関係なし。配列の順に開局 1・2・3 回目の募集に対応し、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: シールド報酬。追加の HP 相当（共通）。
ingot: 源石錐報酬（共通）。
hope: 希望報酬（共通、注意：JieGarden テーマでは無効）。
random: ランダム報酬オプション：すべての源石錐を消費してランダムなコレクションを取得（共通）。
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 が空文字列で collectible_mode_squad が指定されていない場合は指揮分隊。
BlackFlow のモード 30003 では準備用の探索で使用する分隊です。（機械翻訳）

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階層に到達し、到着次第再開します
ending1 - レベル稼ぎで第一エンディングを目指して進めます
ending2 - レベル稼ぎで第二エンディングを目指して進めます
ending3 - レベル稼ぎで第三エンディングを目指して進めます
これらの値はレベル稼ぎモード（mode 0）でのみ使用されます。エンディングが解放されているかどうかはゲーム内の表示に従います。エンディングを指定した場合、開始時も通常どおりオペレーターを招集します。
モード 30003 ではこの項目を読み取りません。動物の指定がある場合、準備用の探索は baby_animal のルートで育成します。指定がない場合、準備用の探索はできるだけ早く第 3 層に到達し、investment_enabled が true のときは先に第 1 層で投資します。準備用の探索の最初のオペレーターが機械師、collectible_mode_squad が特勤分队（特別行動分隊）または堡垒战术分队（要塞戦術分隊）、準備用の探索の職業が稳扎稳打（攻守一体）または坚不可摧（難攻不落）の場合、素質を全解放した機械師での開局とみなし、構造性原理を持ち込みます。準備用の探索では機械師を招集した後に残りの初期招集を放棄し、必要に応じて構造性原理で移動します。動物の指定がない場合は、第 2 層でそれを使って出口へ直接飛びます。（機械翻訳）

blackflow_cultivation_targetOptionalstring

swaddled_cat

襁褓動物育成モードの目標。選択可能な値：swaddled_cat（襁褓の猫）| swaddled_feathered_serpent（襁褓の羽蛇）| swaddled_dog（襁褓の犬）| swaddled_cerberus（襁褓のケルベロス）。blackflow_strategy が baby_animal の場合のみ使用されます。

blackflow_start_animalsOptionalarray<string>

モード 30003 の準備用の探索で育成する襁褓動物。0〜2 項目、重複可、羽蛇は 1 項目まで。選択可能な値：swaddled_cat | swaddled_dog | swaddled_cerberus | swaddled_feathered_serpent。各項目は数も含めて同時に満たす必要があり、例えば swaddled_cat を 2 項目指定すると猫が 2 匹以上必要で、それ以外の動物が多くても影響しません。育成終了時にそろっていない場合はその探索を放棄し、準備用の探索をやり直します。空配列の場合、準備用の探索は第 3 層に入るだけで済みます。モード 30003 では必須。（機械翻訳）

blackflow_start_rewardsOptionalnumber

モード 30003 の目標の探索で狙う初期報酬。ビットマスクで、範囲は 0〜4095。モード 30003 では必須。（機械翻訳）
1 未编号物；2 调查预付款；4 空间租赁；8 退行补偿；16 林间代步；32 巢寄生；64 襁褓天马；128 襁褓骏鹰；256 襁褓巨龙；512 襁褓九头蛇；1024 襁褓白泽；2048 襁褓金乌（日本語名未定）。後ろの 6 項目は羽蛇がもたらす青色の報酬で、blackflow_start_animals に羽蛇が含まれる場合のみ有効、それ以外は無視されます。
目標の探索では支援選択画面の報酬をすべて認識してから判断します。いずれかが一致すれば完了します。報酬は認識できたが狙うものがない場合はその探索を放棄し、準備用の探索をやり直します。1 つも認識できない場合、または羽蛇の報酬を指定したのに青色の報酬を読み取れない場合は、支援選択画面に留まってタスクを停止し、スクリーンショットを debug/roguelike に保存します。0 で blackflow_start_utopia が無効の場合は、支援選択画面に入った時点で完了します。進捗は SubTaskExtraInfo の BlackFlowStartRun コールバックで通知されます。コールバックスキーマ を参照してください。

collectible_mode_rolesOptionalstring

モード 30003 の準備用の探索で使う職業。指定しない場合は roles を使用します。（機械翻訳）

collectible_mode_core_char_listOptionalarray<object>

モード 30003 の準備用の探索で使う最初のオペレーターの順位。形式は core_char_list と同じで、指定しない場合は core_char_list を使用します。（機械翻訳）

blackflow_start_utopiaOptionalboolean

false

モード 30003 の目標の探索で第 1 層の实托邦（第 1 層の種類）を厳選します。true の場合、目標の探索は支援選択画面に blackflow_start_rewards のいずれかが出たら（0 の場合は条件なし）、blackflow_start_reward_priority の順に報酬を選び、襁褓のケルベロスで 2 回選べる場合はもう 1 枚選びます。その後 roles と最初のオペレーターで開局して第 1 層に入り、第 1 層が实托邦ならテーマ画面へ退出してその探索を保持したままタスクを終了し、そうでなければその探索を放棄して準備用の探索をやり直します。实托邦は第 1 層の層名の位置で判定し、難易度 6 以上でのみ出現します。difficulty は呼び出し側で選んでください。（機械翻訳）

blackflow_start_reward_priorityOptionalarray<string>

モード 30003 で第 1 層の实托邦を厳選する場合に、目標の探索で報酬を選ぶ順番。blackflow_start_utopia が true の場合は必須で、空と重複は不可。選択可能な値：unnumbered_item 未编号物；survey_advance 调查预付款；space_lease 空间租赁；regression_compensation 退行补偿；forest_ride 林间代步；nest_parasitism 巢寄生；pegasus 襁褓天马；hippogriff 襁褓骏鹰；dragon 襁褓巨龙；hydra 襁褓九头蛇；bai_ze 襁褓白泽；golden_crow 襁褓金乌（日本語名未定）。实托邦を厳選しない場合、目標の探索は条件を満たすと支援選択画面のまま探索を保持し、報酬を選ばないため、この項目は読みません。厳選する場合、目標の探索は第 1 層に入る必要があり、支援選択画面でカードを選ばなければなりません。blackflow_start_rewards を満たした後、画面にある報酬のうちこの順番で最も上のものを選び、襁褓のケルベロスで 2 回選べる場合はもう 1 枚選びます。このとき後ろの 6 項目の羽蛇の報酬も、blackflow_start_animals に羽蛇が含まれるかどうかに関係なく順番に加わります。準備用探索で羽蛇を指定していなくても連れていることがあり、その場合も目標の探索に青い報酬が出るためです。これは blackflow_start_rewards と異なり、そちらの後ろの 6 項目は条件で、羽蛇を指定した場合のみ有効です。並べた報酬が画面に 1 つもない場合は、戦略の既定の順番で通常の報酬を 1 つ選びます。（機械翻訳）

find_playTime_targetOptionalnumber

常楽ノード稼ぎモードの目標常楽ノード。1 - 令（掷地有声）；2 - 黍（种因得果）；3 - 年（三缺一）。テーマが JieGarden かつモードが 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～第 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 と二択。
配列の要素は 2 つの形式をサポートします：オブジェクト形式は id（作業識別子。CopilotListLoadTaskFileSuccess コールバックにそのまま透過される）と filename（作業 JSON ファイルのパス。絶対/相対パスの両方可）を含みます。作業パスの文字列を直接指定することもできます。

Example

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

• Depot
  倉庫識別

enableOptionalboolean

true

このタスクを有効にするかどうか。

Example

{
   "enable": true
}

• OperBox
  オペレーター box 識別

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

単次最大製造バッチ数。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）、潜在能力自動強化タスク（MiniGame@AutoRaisePotential@Begin）、イベントショップ交換タスク（SS@Store@Begin）で使用：

• params.pixel_paint.groups：色ごとのマス座標リスト。color はパレットのスロット番号（039、ゲーム右側パレットの順序と一致）、points は [x, y] のマス座標配列（023、左上原点）。
• params.pixel_paint.swipe（bool、任意、デフォルト true）：同じ色の連続マスを1回のドラッグで描画し高速化。一部のタッチ方式では正常に動作しない可能性があります。
• params.pixel_paint.grid_delay（int、任意、デフォルト 0）：マスごとの追加待機時間（ms）。クリック後の待機とドラッグ時間の両方に加算されます。各タッチ方式に基礎間隔があるため、通常は調整不要。旧キー grid_click_delay も受け付けます。
• params.auto_raise_potential.use_normal_token（bool、任意、デフォルト false）：トークンが不足している場合の確認ダイアログは、既定では × を押して中断する。true にすると √ を押して通常のトークンを消費して続行する。
• params.event_shop.blacklist（string 配列、任意）：イベントショップ交換タスク（SS@Store@Begin）の購入時における商品名ブラックリスト。認識した商品名にいずれかの項目が含まれる場合その商品をスキップし、残りの商品を買い続けます。空の場合は効果がありません。

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 文字列、AsstAppendTask インターフェイスと同じ。 ｢実行期設定非対応｣ と注記されていないフィールドはすべてリアルタイム修正に対応。そうでなければ、タスク実行中は対応するフィールドを無視します

AsstSetStaticOption

インターフェース プロトタイプ

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

インターフェースの説明

プロセス レベル パラメータを設定します。

返回値

• AsstBool
  設定が成功したかどうかを返す

パラメータ説明

keyRequiredAsstStaticOptionKey

キー

valueRequiredconst char\*

値

キー値一覧

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

キー

valueRequiredconst char\*

値

キー値一覧

InvalidOptionalnumber

0

無効なプレースホルダ。列挙値：0。

MinitouchEnabledOptionalboolean

廃止済み。元は Minitouch を有効にするかどうか。"1" オン、"0" オフ。デバイスがサポートされていない可能性がります。列挙値：1（廃止済み）。

TouchModeOptionalstring

minitouch

タッチ モード設定。可能な値：minitouch | maatouch | adb | MacPlayTools | MaaFwAdb | MumuExtras。デフォルト minitouch。列挙値：2。

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。

このページを編集