Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 9 additions & 5 deletions .vitepress/theme/components/DownloadLink.vue
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
texts.quarkDownload }}</a>
<a href="https://mirrorchyan.com/zh/projects?rid=BAAH" class="VPButton medium alt">{{ texts.mirrorChyanDownload
}}</a>
<a href="https://api.blockhaity.qzz.io/docs/#/api-doc/getbaah" class="VPButton medium alt">{{
<a href="https://api.blockhaity.eu.org/docs/#/api-doc/getbaah" class="VPButton medium alt">{{
texts.blockhaityapi }}</a>
<a href="https://cnb.cool/BlockHaity/BAAH-releases/-/releases" class="VPButton medium alt">{{ texts.cnbDownload
}}</a>
Expand Down Expand Up @@ -59,8 +59,9 @@ export default {
},
methods: {
detectLanguage() {
const urlPath = window.location.pathname
const browserLang = navigator.language.toLowerCase()
const hasBrowserApi = typeof window !== 'undefined' && typeof navigator !== 'undefined'
const urlPath = hasBrowserApi ? window.location.pathname : ''
const browserLang = hasBrowserApi ? navigator.language.toLowerCase() : ''
const textDict = {
zh: {
currentVersion: '当前最新版本:',
Expand All @@ -78,7 +79,7 @@ export default {
blockhaityapi: "BlockHaity's API",
sourceCodePath: '/zh_CN/docs/manual/source-code',
dockerPath: '/zh_CN/docs/manual/quick-start',
androidPath: 'https://bas.blockhaity.qzz.io?target=/2025/02/10/BAAH%E5%9C%A8%E9%80%86%E5%A4%A9%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E8%BF%90%E8%A1%8C/'
androidPath: 'https://bas.blockhaity.eu.org?target=/2025/02/10/BAAH%E5%9C%A8%E9%80%86%E5%A4%A9%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E8%BF%90%E8%A1%8C/'
},
en: {
currentVersion: 'Current Latest Version: ',
Expand All @@ -97,7 +98,7 @@ export default {
blockhaityapi: "BlockHaity's API",
sourceCodePath: '/en_US/docs/manual/source-code',
dockerPath: '/en_US/docs/manual/quick-start',
androidPath: 'https://bas.blockhaity.qzz.io?target=/2025/02/10/BAAH%E5%9C%A8%E9%80%86%E5%A4%A9%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E8%BF%90%E8%A1%8C/'
androidPath: 'https://bas.blockhaity.eu.org?target=/2025/02/10/BAAH%E5%9C%A8%E9%80%86%E5%A4%A9%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E8%BF%90%E8%A1%8C/'
}
}

Expand All @@ -119,6 +120,9 @@ export default {
this.releaseBody = this.texts.loading
},
detectPlatform() {
if (typeof navigator === 'undefined') {
return
}
const platform = navigator.platform.toLowerCase()
if (platform.includes('win')) {
this.platform = 'windows'
Expand Down
17 changes: 15 additions & 2 deletions src/en_US/docs/manual/QA.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,23 @@ description: Quick solutions to common BAAH automation script issues update over

## 0. How to update BAAH

Download BAAH1.x.xx_update.zip from [GitHub Release](https://github.com/BlueArchiveArisHelper/BAAH/releases/) or [Gitee Release](https://gitee.com/sammusen/BAAH/releases) or QQ group or by clicking the update button in the GUI, then extract all contents to the BAAH folder and overwrite.
Download BAAH1.x.xx_update.zip from [GitHub Release](https://github.com/BlueArchiveArisHelper/BAAH/releases/) or the [download page](/en_US/download), or by clicking the update button in the GUI, then extract all contents to the BAAH folder and overwrite.

Or just double click `UPDATE.exe` to update BAAH.

### About containers

When using containers, updates may fail due to network issues (this mostly happens in mainland China). You can run this script to switch to a mirror download source:
```bash
# Inside the container:
aria2c https://baah.sanmusen.top/res/change-source.sh -d . -o change-source.sh && bash change-source.sh && rm change-source.sh
# Outside the container
## docker
docker exec -it <container_name> bash -c "aria2c https://baah.sanmusen.top/res/change-source.sh -d /root -o change-source.sh && bash /root/change-source.sh && rm /root/change-source.sh"
## podman
podman exec -it <container_name> bash -c "aria2c https://baah.sanmusen.top/res/change-source.sh -d /root -o change-source.sh && bash /root/change-source.sh && rm /root/change-source.sh"
```

## 1. How to provide feedback

Please:
Expand Down Expand Up @@ -73,7 +86,7 @@ BAAH is compatible with ALAS and MAA, but:

## 10. BAAH.exe disappeared after extraction

Please add the BAAH folder to your antivirus software's whitelist and extract again. BAAH is completely open source. As long as you download BAAH from GitHub Release, MirrorChyan, the Quark Cloud Disk link at the beginning of this document, or the QQ group, you can use it safely.
Please add the BAAH folder to your antivirus software's whitelist and extract again. BAAH is completely open source. As long as you download BAAH from GitHub Release, MirrorChyan, or the official download page, you can use it safely.

## 11. How to make BAAH run on a schedule

Expand Down
10 changes: 5 additions & 5 deletions src/en_US/docs/manual/get-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,19 +23,19 @@ BAAH has comprehensive community support. If you encounter any problems while us

You can get help through the following channels.

[QQ Group Q&A Group](https://qm.qq.com/q/K2wAMIovqQ): 985729020
[GitHub Discussions](https://github.com/BlueArchiveArisHelper/BAAH/discussions) (Recommended for international users)

[Tencent Channel](https://pd.qq.com/s/5atxio0vq)
[GitHub Issues](https://github.com/BlueArchiveArisHelper/BAAH/issues)

[GitHub Discussions](https://github.com/BlueArchiveArisHelper/BAAH/discussions)
[QQ Group Q&A Group](https://qm.qq.com/q/K2wAMIovqQ): 985729020 (For Chinese users)

> :memo: **Note:** Please prioritize consulting in the group.
> :memo: **Note:** Please prioritize GitHub Discussions / Issues for international users, and the QQ group for Chinese users.


### Before Asking Questions
1. Please make sure you have watched the tutorial videos and this documentation as suggested, as they can solve the vast majority of problems.
2. Check if the software has an [update](/en_US/docs/manual/QA.md#0-how-to-update-baah), and try updating to the latest version.
3. If you are in the QQ group, you can first browse through the group chat history to see if there are similar situations and how they were resolved.
3. Search GitHub [Discussions](https://github.com/BlueArchiveArisHelper/BAAH/discussions) and closed [Issues](https://github.com/BlueArchiveArisHelper/BAAH/issues?q=is%3Aissue%20state%3Aclosed) to see if there are similar situations and how they were resolved. (Chinese users can also browse the QQ group chat history.)
4. Read GitHub [Issues](https://github.com/BlueArchiveArisHelper/BAAH/issues), including closed [Issues](https://github.com/BlueArchiveArisHelper/BAAH/issues?q=is%3Aissue%20state%3Aclosed), to see if there are similar problems.

### When Asking Questions
Expand Down
2 changes: 1 addition & 1 deletion src/en_US/docs/manual/introduction/assault.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ This feature allows Team 1 in Assault to use Assistant. Please leave an empty sl
1. Go to the team formation interface and enter the student borrowing screen.
2. Click the `ASSAULT HELPER STUDENT` button.
![assist Student](/img/assault/assault_helper_1.webp)
1. In the popup window, use the left mouse button to select the students you want to borrow.
3. In the popup window, use the left mouse button to select the students you want to borrow.
![Select Students](/img/assault/assault_helper_2.webp)

> :memo: **Note:** If you need to borrow SPECIAL students, please check `Whether assault helper is support role` to enable this feature. You only need to leave an empty slot in the back row, and select the SPECIAL students you want to borrow.
Expand Down
2 changes: 1 addition & 1 deletion src/en_US/docs/manual/introduction/explore-stage.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

If `Use simple explore` is selected, the function to skip grid movement will be used. Please note that this will not collect all rewards, but it can increase the success rate of stage exploration (especially in the early game when your students' levels are low and you can't form a complete team).

Some grid-based stages cannot be cleared in one run to collect all rewards (Mission Obbjectives, Special Gift Boxes(50 Pyroxenes), and challenge achievements). For these stages, repeated battles will be performed to ensure all rewards are collected.
Some grid-based stages cannot be cleared in one run to collect all rewards (Mission Objectives, Special Gift Boxes (50 Pyroxenes), and challenge achievements). For these stages, repeated battles will be performed to ensure all rewards are collected.
:::

::: warning
Expand Down
10 changes: 5 additions & 5 deletions src/en_US/docs/manual/introduction/notification.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Please check the `API Notification` option to enable this feature.

:::

You can use API to get notifications, which can be used to push to WeChat Official Accounts, QQ groups, etc. This requires some third-party services, please look it up on the internet yourself.
You can use API to get notifications, which can be used to push to messaging services such as Telegram, Discord, etc. This requires some third-party services, please look it up on the internet yourself.

1. Enter your API address in the `API Notification URL` field.
> :memo: **Note:** You can click the `PUSHPLUS`, `SERVERCHAN` or `TELEGRAM BOT` buttons below the API address tab to automatically add the API addresses for [PushPlus](https://www.pushplus.plus/), [ServerChan](https://sct.ftqq.com/) or [Telegram Bot](https://t.me/BotFather).
Expand Down Expand Up @@ -109,10 +109,10 @@ In the `Customize the email content` field, you can fill in the following **fiel
| 12 | %ASSAULT_DATE% | Total assault date | Date |
| 13 | %CRAFT_FAILED% | Craft failed | Reason |
| 14 | %EVENT_DATE% | Event date | Date |
| 13 | %SCREENSHOT_READ_FAIL_TIMES% | Number of screenshot read failures | Number |
| 14 | %RESTART_EMULATOR_TIMES% | Number of emulator restarts | Number |
| 15 | %SCREENSHOT_DATA% | Screenshot data | RGB value or None when screenshot mode is pipe |
| 16 | %CURRENT_PERIOD_TASK_INDEX% | Executed task sequence number | Number, -1 means no task has been executed |
| 15 | %SCREENSHOT_READ_FAIL_TIMES% | Number of screenshot read failures | Number |
| 16 | %RESTART_EMULATOR_TIMES% | Number of emulator restarts | Number |
| 17 | %SCREENSHOT_DATA% | Screenshot data | RGB value or None when screenshot mode is pipe |
| 18 | %CURRENT_PERIOD_TASK_INDEX% | Executed task sequence number | Number, -1 means no task has been executed |

::: details Example

Expand Down
2 changes: 1 addition & 1 deletion src/en_US/docs/manual/introduction/shop.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,4 +9,4 @@ The shop locates items to be purchased based on row and column relationships, yo
- If you want to purchase all items, please check `Buy All`.
- `Refresh times` refers to the number of times clicking the **Refresh** button after purchase, which consumes Pyroxene.
- If you don't want to buy items in a certain row, just leave it blank, which will prompt **No tasks set here**.
- The shop is divided into Normal Shop and Tacticial Challenge Shop, which can be filled in independently.
- The shop is divided into Normal Shop and Tactical Challenge Shop, which can be filled in independently.
28 changes: 26 additions & 2 deletions src/en_US/docs/manual/quick-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,8 @@ description: Complete BlueArchive Aris Helper deployment in 3 steps! MuMu emulat

[Video Tutorial](https://www.bilibili.com/video/BV1ZxfGYSEVr)

> :memo: **Note:** The official tutorial video is in Chinese, but the steps below cover the same process.

First, download the approximately 160MB compressed package and extract it to any folder.

[Go to Download Page](/en_US/download)
Expand Down Expand Up @@ -61,7 +63,7 @@ See [Deploy from Source Code](/en_US/docs/manual/source-code) for details.
== Linux
**Linux**

First, ensure your system has Docker installed. You can check by entering the following command
First, ensure your system has Docker or podman installed. You can check by entering the following command

``` bash
# For ROOT users
Expand Down Expand Up @@ -160,9 +162,31 @@ For more help on how to use Docker, head to https://docs.docker.com/go/guides/

Then, pull the image, create and run the container.

Image release: [Github Package](https://github.com/BlueArchiveArisHelper/BAAH/pkgs/container/baah)

::: details docker
``` bash
# If you use an emulator/other Android container, use port forwarding
sudo docker run -d --name BAAH -p 8000:8000 ghcr.io/bluearchivearishelper/baah:latest

# If you need to connect to a remote Android device, start the ADB Server on the host and use host mode
sudo docker run -d --name BAAH --net=host ghcr.io/bluearchivearishelper/baah:latest

# If you are in mainland China and cannot pull the image from ghcr.io, please refer to the mirror registries listed in the Chinese documentation (/zh_CN/docs/manual/quick-start).
```
:::
:::details podman
``` bash
docker run -d --name BAAH -p 8000:8000 ghcr.io/bluearchivearishelper/baah:latest
# It is recommended to run the BAAH container at the system level
# If you use an emulator/other Android container, use port forwarding
podman run -d --name BAAH -p 8000:8000 ghcr.io/bluearchivearishelper/baah:latest

# If you need to connect to a remote Android device, start the ADB Server on the host and use host mode
podman run -d --name BAAH --net=host ghcr.io/bluearchivearishelper/baah:latest

# If you are in mainland China and cannot pull the image from ghcr.io, please refer to the mirror registries listed in the Chinese documentation (/zh_CN/docs/manual/quick-start).
```
:::

Then open your browser and navigate to `http://<your-server-ip>:8000`

Expand Down
8 changes: 4 additions & 4 deletions src/en_US/docs/manual/source-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ description: BAAH source code deployment solution for developers, requires Pytho

# Deploying from Source Code

For Android Termux deployment, please visit [🔗 Deployment Method](https://bas.blockhaity.qzz.io?target=/2025/02/10/BAAH%E5%9C%A8%E9%80%86%E5%A4%A9%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E8%BF%90%E8%A1%8C/) (Only Chinese!!!)
For Android Termux deployment, please visit [🔗 Deployment Method](https://bas.blockhaity.eu.org?target=/2025/02/10/BAAH%E5%9C%A8%E9%80%86%E5%A4%A9%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E8%BF%90%E8%A1%8C/) (Only Chinese!!!)

::: warning
Regardless, it is not recommended for regular users to deploy directly from source code. There will be no official update program support for source code deployment, and using `git pull` also carries the risk of damaging the program.
Expand Down Expand Up @@ -51,7 +51,7 @@ uv python install 3.10

:::

Then, you need to prepare [adb](https://developer.android.google.cn/tools/releases/platform-tools) and [aria2](https://github.com/aria2/aria2/releases) yourself.
Then, you need to prepare [adb](https://developer.android.com/tools/releases/platform-tools) and [aria2](https://github.com/aria2/aria2/releases) yourself.

## Installing from Git

Expand Down Expand Up @@ -99,12 +99,12 @@ git clone https://github.com/BlueArchiveArisHelper/BAAH.git
Don't close the window, run `cd BAAH` to enter the folder, and install dependencies.

``` cmd
# Switch source
pip config set global.index-url https://mirrors.cernet.edu.cn/pypi/web/simple
# Install dependencies
pip install -r requirements.txt
```

> :memo: **Note:** If you are in mainland China, you can append `-i https://mirrors.cernet.edu.cn/pypi/web/simple` to use a local PyPI mirror.

Use `python jsoneditor.py` to run the WebUI, and modify the adb and aria2 paths in the configuration file editing interface.

Execute `python jsoneditor.py config.json` to start BAAH according to the config.json configuration.
Expand Down
12 changes: 5 additions & 7 deletions src/en_US/donate.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,18 +4,16 @@ If you really like BAAH and would like to buy the developer a cup of milk tea (o

## Paid Donation

You can purchase Mirror-chan CDK and use it for downloads and updates. This not only allows the developer to earn a commission, but also enables high-speed downloads/updates.
You can purchase a MirrorChyan CDK and use it for downloads and updates. This not only allows the developer to earn a commission, but also enables high-speed downloads/updates.

## Free Donation

Here are the developers' payment codes or Afdian links.

Software maintenance is not easy. If you feel this software has been helpful to you, you are welcome to sponsor through Afdian or WeChat QR code. Your support will be the motivation for developers to continue maintenance.
The developer accepts donations through Afdian (爱发电):

::: details sanmusen214
<AfdianCard />
![sanmusen214](/img/donate/sanmusen214.webp)
:::

::: warning
Message from the developer: Thank you for your support of BAAH! Please consider sponsoring within an amount you're comfortable with. Donations made via WeChat or other channels do not include any additional benefits. Students and minors, please refrain from tipping~ Giving two coins to BAAH's [tutorial video](https://www.bilibili.com/video/BV1ZxfGYSEVr/) would also be a huge encouragement and support for us. Thank you very much~
:::
Message from the developer: Thank you for your support of BAAH! Please consider donating within an amount you're comfortable with. Donations do not include any additional benefits. Students and minors, please refrain from donating~ Even giving the BAAH repository a star on GitHub or spreading the word among your friends would be a great encouragement to us. Thank you very much~
:::
20 changes: 8 additions & 12 deletions src/en_US/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,20 +8,15 @@ description: Get BlueArchive Aris Helper automation script for free! Windows rec
# Download BAAH

::: tip
You can join one of the following QQ groups to get the latest version update notifications
To get the latest version update notifications:

**Mute Notification Group 2: 1056031857**
- **Star/Watch** the [BAAH GitHub repository](https://github.com/BlueArchiveArisHelper/BAAH) and enable notifications for new releases.

**Mute Notification Group 1: 1029291081 (Full)**
To get usage help:

**Mute Notification Group: 715586983 (Full)**



You can join one of the following QQ groups for usage help

**Q&A Group: 985729020**
- Ask in [GitHub Discussions](https://github.com/BlueArchiveArisHelper/BAAH/discussions) or open an [Issue](https://github.com/BlueArchiveArisHelper/BAAH/issues).

Chinese users can also join the QQ groups listed in the [Chinese documentation](/zh_CN/download).
:::

<!-- Reconstruct download page -->
Expand All @@ -38,7 +33,8 @@ You can join one of the following QQ groups for usage help
<a href="https://pan.quark.cn/s/49fab9d220ec" class="VPButton medium brand" title="Extraction Code: W3dc">Quark Cloud Download</a>
<a href="https://mirrorchyan.com/en/projects?rid=BAAH" class="VPButton medium alt">MirrorChyan Download (CDK Required)</a>
<a href="https://github.com/BlueArchiveArisHelper/BAAH/releases" class="VPButton medium alt">GitHub Release</a>
<a href="https://api.blockhaity.qzz.io/docs/#/api-doc/getbaah" class="VPButton medium alt">BlockHaity's API</a>
<a href="https://api.blockhaity.eu.org/docs/#/api-doc/getbaah" class="VPButton medium alt">BlockHaity's API</a>
<a href="https://cnb.cool/BlockHaity/BAAH-releases/-/releases" class="VPButton medium alt">Cloud Native Build</a>

== macOS

Expand All @@ -51,7 +47,7 @@ You can join one of the following QQ groups for usage help

== Android Termux

<a href="https://bas.blockhaity.qzz.io?target=/2025/02/10/BAAH%E5%9C%A8%E9%80%86%E5%A4%A9%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E8%BF%90%E8%A1%8C/" class="VPButton medium brand">View Android Deployment Tutorial (Only Chinese)</a>
<a href="https://bas.blockhaity.eu.org?target=/2025/02/10/BAAH%E5%9C%A8%E9%80%86%E5%A4%A9%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E8%BF%90%E8%A1%8C/" class="VPButton medium brand">View Android Deployment Tutorial (Only Chinese)</a>

::::

Expand Down
Loading
Loading