Skip to main content

Auto Battle (自动战斗)

9/27/26About 1 min

AI Translation Notice

This document was translated using AI. Please refer to the Chinese documentation for the definitive version.

Auto Battle (自动战斗)

Task entry: AutoBattle

PI file: assets/resource/tasks/AutoBattle.json

Pipeline entry file: assets/resource/pipeline/AutoBattle.json

Subflow directory: assets/resource/pipeline/AutoBattle/

Entry node: AutoBattleMain

Feature Overview

自动战斗 (Auto Battle) navigates from the main screen to 出击 (Combat), then automatically completes stage selection, formation confirmation, battle startup, and result waiting according to the stage mode, area, and specific stage selected by the user. A loop count can be configured to repeat the stage.

Currently supported modes:

  • MainStory (主线任务 / Main Story): no specific stages have been adapted yet.
  • MaterialQuests (资源收集 / Resource Collection): two areas, 特别军费行动 (Special Military Funding Operation) and 作战体能训练 (Combat Fitness Training), have been adapted.
  • SkillMaterial (技能演练 / Skill Training): no specific stages have been adapted yet.

Main Nodes

Entry and Routing

  • AutoBattleMain: the 自动战斗 (Auto Battle) entry point. Its next contains [JumpBack]AutoBattle_Do:JumpToField as the universal navigation fallback, routing to the target stage page for the selected area.
  • AutoBattle_Do:JumpToField: universal navigation node. Calls the SceneJump custom action (target is injected by the option, e.g. Combat_MaterialQuests_1), navigating from any screen to the resource-collection area page.
  • AutoBattleStage: the stage-page verification node. It uses And recognition to confirm arrival at the target stage page, then enters the battle loop.

Loop Control

  • AutoBattleLoop: the loop-control node. The loop count is set through max_hit, injected by the AutoBattle_Looptimes option.
  • AutoBattleFinish: the cleanup node used after the loop ends.

Stage Selection Flow

File: assets/resource/pipeline/AutoBattle/MaterialQuests.json

  • AutoBattle_Stage_MaterialQuests: the stage-selection node. It calls the Stage_Select custom action (field is the stage-map name and stage is the target stage, both injected by the option), locating and clicking the target stage according to the stage order recorded in assets/resource/stage/map.json.

Battle Flow

  • AutoBattle_MaterialQuests_Click:Start: recognizes and clicks the “准备战斗” (Prepare for Battle) button (UI/Combat/Start.png).
  • AutoBattle_MaterialQuests_Click:Start2: recognizes and clicks the formation screen's “开始战斗” (Start Battle) button (UI/Combat/Start2.png, green screen). A loading screen may appear after the click.
  • AutoBattle_MaterialQuests_Click:Start3: recognizes and clicks the in-map “作战开始” (Commence Operation) button (UI/Combat/Start3.png). The battle begins after the click.
    • next contains:
      • [JumpBack]AutoBattle_MaterialQuests_Click:speed2x: attempts to enable 2× speed. (Not handled yet.)
      • [JumpBack]UI_Combat_InStage_active: waits while the battle is in progress.
      • [JumpBack]SceneDo_Click_Stage_finish: waits for the results.
      • [JumpBack]SceneDo_GetItem: claims the battle rewards.
      • AutoBattleStage: returns to the stage page to begin the next loop.