Skip to content

Latest commit

 

History

History
134 lines (80 loc) · 6.53 KB

README_en.md

File metadata and controls

134 lines (80 loc) · 6.53 KB

Blue_Archive_ArisHelper(BAAH)

Discussion Group

QQ: 715586983

Discord: https://discord.com/invite/7cEvvfcd

How to Run

Latest Tutorial on Bilibili Homepage

Pre-run Setup

  1. Emulator: Set the resolution to 1280*720 pixels, 240 DPI. Enable adb debugging. Note the adb debugging port of the emulator.
    • If you are using Mumu emulator, please disable background activity running at the bottom of the settings.
    • If can not connect ADB, please shut the network bridge function of emulator, or change the adb connect ip.
  2. BA Game Settings:
    • Game: Turn off skill animations;
    • Graphics: Turn off black bars at the top and bottom during battles,
    • In the café, manually adjust the camera angle to the highest and stack all furniture on the right side of the screen if possible.

Usage

Running via exe (Windows)

  1. Download and extract the approximately 100MB zip file to any folder.
  2. Rename the example.json file in the BAAH_CONFIGS folder to any other name, such as task.json.
  3. Double-click BAAH_GUI.exe to open the interface.
  4. In Emulator Settings, change the port number to your emulator's adb port.
  5. In Server Settings, select your ba server.
  6. In Task List Settings, enable any tasks or click fast-run task button.

Running via local Python environment

  1. Ensure your Python environment version is == 3.10.x.
  2. Ensure adb.exe is available on your computer, and later modify the ADB_PATH in the configuration file to point to adb.exe on your computer.
  3. Execute git clone https://github.com/sanmusen214/BAAH.git in the command line.
  4. Execute cd BAAH to enter the project directory.
  5. Execute pip install -r requirements.txt to install the required dependencies.
  6. Execute python jsoneditor.py to run the GUI, and modify the path to adb.exe at the bottom of the GUI.
  7. Execute python main.py config.json to start executing BAAH according to the config.json configuration.

Running via Docker

Ensure you have a docker environment. You can run in the following ways

  1. Prebuild Image: Get the image built by Github Action, execute docker run -d --name BAAH -p 8000:8000 ghcr.io/sanmusen214/baah:latest

  2. Build Locally: Run git clone https://github.com/sanmusen214/BAAH.git. Use the docker-compose.yml file and execute docker compose up -d

FAQs

0. How to Update BAAH

Download BAAH1.x.xx_update.zip on Github releases or by clicking the update button in the GUI, then extract all contents to overwrite the existing files in the BAAH folder.

Or just double click UPDATE.exe to update BAAH.

1. How to Provide Feedback

Please:

  1. Check if the issue is already listed in the FAQs.
  2. Check whether the BAAH is the latest version. You can update BAAH through the update button in the GUI.
  3. Describe your game server, BAAH version.
  4. Describe your purpose.
  5. Describe the behavior of BAAH before and after the error occurred or provide a recording.
  6. Provide logs of BAAH.exe before and after the error occurred.

2. ADB Connection Failed, Screenshot Size is 0kb, or Game Continuously Detected as Not Opened

Please check if the adb port number in your configuration file matches the adb port number of the emulator.

Please verify if your server selection in the configuration file is correct.

3. How to View the ADB Port Number of Mumu Emulator

Click the three horizontal lines in the upper right corner of the emulator, open problem detection, scroll to the bottom, and the adb port number will be displayed.

4. How to View the Port Number of LDPlayer Emulator

You can click the using serial number box on the right side of the adb port input box when connecting to the LDPlayer emulator, then enter emulator-5554, or try emulator-5556, emulator-5558, etc., until the connection is successful.

Click Multi-player on the right side of the emulator to find out the current emulator's ID number. The port number is: 5555 + ID * 2.

5. If I Installed Anti-Censorship for CN Server BA, BAAH Can't Click the Sweep Button

Please check the "If anti-censorship is enabled, please check this option" box when selecting the server.

6. When Using Swipe to Select Levels, the Swipe Distance is Not Enough

This issue usually occurs in CN server official BAs. Unbind the swipe trigger distance from the server in the configuration file and change 40 to 60.

7. Can BAAH be Multi-opened?

Switch to different configuration files in the GUI interface, then click Save and Run in the bottom right corner separately.

BAAH can be run through the command line, just cd to the BAAH folder, and execute BAAH.exe your_config.json. By combining the Windows Task Scheduler, you can run BAAH automatically at a specific time.

If you are using a bat command or Windows Task Scheduler, make sure to cd to the BAAH folder, then execute BAAH.exe config1.json followed by BAAH.exe config2.json.

8. Can BAAH be Run Multi-opened with Other Scripts?

BAAH is compatible with ALAS and MAA, but:

  1. Please do not attempt to run BAAH and ALAS or MAA on the same multi-opened emulator/same emulator port simultaneously, as they will compete for screenshots. Please set up multiple multi-opened emulators.
  2. Please be careful not to let the automation scripts restart the adb service, BAAH will not try to shut down the adb daemon, you should start BAAH after other automation tools.

9. After Extracting, BAAH.exe Disappears

Please set the BAAH folder as an exception in your antivirus software, then extract it again. BAAH is completely open source.

10. How to let BAAH run automatically

BAAH itself is an excutable application, you can cd to the BAAH folder and run BAAH.exe urconfig.json in cmd to run script. After getting in touch with the Windows task scheduled (google), you can set a task and let it run automatically.

11. GUI parameters

You can set more parameters before BAAH_GUI running to enable more settings. For example, run "BAAH_GUI.exe --token 123456" will protect your GUI webpage with a password. Following is the paremeter table that GUI can use:

Param Desc Default
--host GUI will bind on this IP 127.0.0.1
--port GUI will bind on this port 8000, auto find
--token GUI password None
--no-show Switch, will not open explorer when GUI is started if it is given