From 0b041c4cb6ccedc1288b0a11c1e7b29792f89ed1 Mon Sep 17 00:00:00 2001 From: TCddddd Date: Sun, 23 Aug 2026 19:17:27 +0800 Subject: [PATCH 1/3] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=20BetterGI=20?= =?UTF-8?q?=E8=84=9A=E6=9C=AC=E9=85=8D=E7=BD=AE=E6=8C=87=E5=8D=97=EF=BC=88?= =?UTF-8?q?=E4=B8=AD/=E8=8B=B1=EF=BC=89=E5=B9=B6=E6=8E=A5=E5=85=A5?= =?UTF-8?q?=E5=AF=BC=E8=88=AA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增 docs/script-guide/bettergi.md 与 en/docs/script-guide/bettergi.md - 讲解配置管理方式、一条龙 8 个内置配置组开关语义、自定义配置组与原生设置会话 - 侧边栏与脚本指南索引加入 BetterGI 条目 --- .vitepress/config/en.ts | 1 + .vitepress/config/zh.ts | 1 + docs/script-guide/bettergi.md | 128 +++++++++++++++++++++++++++++++ docs/script-guide/index.md | 12 +++ en/docs/script-guide/bettergi.md | 128 +++++++++++++++++++++++++++++++ en/docs/script-guide/index.md | 12 +++ 6 files changed, 282 insertions(+) create mode 100644 docs/script-guide/bettergi.md create mode 100644 en/docs/script-guide/bettergi.md diff --git a/.vitepress/config/en.ts b/.vitepress/config/en.ts index e3f273e..9294bb7 100644 --- a/.vitepress/config/en.ts +++ b/.vitepress/config/en.ts @@ -30,6 +30,7 @@ export const enThemeConfig: DefaultTheme.Config = { { text: "M9A", link: "/en/docs/script-guide/m9a" }, { text: "OK-WW", link: "/en/docs/script-guide/okww" }, { text: "HSR", link: "/en/docs/script-guide/hsr" }, + { text: "BetterGI", link: "/en/docs/script-guide/bettergi" }, { text: "General Scripts", link: "/en/docs/script-guide/general" }, { text: "SRA", link: "/en/docs/script-guide/sra" }, { text: "March 7th", link: "/en/docs/script-guide/march7th" }, diff --git a/.vitepress/config/zh.ts b/.vitepress/config/zh.ts index 3bcf61e..6161ffd 100644 --- a/.vitepress/config/zh.ts +++ b/.vitepress/config/zh.ts @@ -30,6 +30,7 @@ export const zhThemeConfig: DefaultTheme.Config = { { text: "M9A", link: "/docs/script-guide/m9a" }, { text: "OK-WW", link: "/docs/script-guide/okww" }, { text: "HSR", link: "/docs/script-guide/hsr" }, + { text: "BetterGI", link: "/docs/script-guide/bettergi" }, { text: "通用脚本", link: "/docs/script-guide/general" }, { text: "SRA", link: "/docs/script-guide/sra" }, { text: "三月七", link: "/docs/script-guide/march7th" }, diff --git a/docs/script-guide/bettergi.md b/docs/script-guide/bettergi.md new file mode 100644 index 0000000..f0fe6da --- /dev/null +++ b/docs/script-guide/bettergi.md @@ -0,0 +1,128 @@ +--- +title: BetterGI 配置方法 +description: 原神 - BetterGI 专项适配配置指南 +date: 2026-08-23 +--- + +# BetterGI 配置方法 + +## 先了解两件事 + +**BetterGI** 是原神的第三方辅助工具，能执行一条龙（每日委托、清体力、地脉花、秘境、首领讨伐等）与多种进阶功能。它是**原生 GUI 直控**模式：账号由 BetterGI 原生管理，复杂设置在 BetterGI 自己的界面里完成。 + +AUTO-MAS 的专项适配为每个用户单独管理其**「一条龙」任务配置、自定义配置组、账号切换归档与通知**。运行前按该用户的独立配置加载到 BetterGI，结束时按任务策略回写保存。BetterGI 不需要保留在 MAS 里的一份完整配置。 + + + +## 快速开始 + +1. 从 [BetterGI 官方仓库](https://github.com/babalae/better-genshin-impact)下载并解压。建议放在不含中文字符的路径中，并先在 BetterGI 中完成一次基础配置。 +2. 打开 **脚本管理** → **新建脚本**，选择 **BetterGI 脚本**，设置 BetterGI 的 `RootPath` 路径。 +3. 添加用户，在用户编辑页选择**配置管理方式**，并按需配置一条龙任务。 +4. 点击右上角 **配置 BetterGI**，打开 BetterGI 原生界面完成一次保存；复杂设置也在这里完成。 +5. 保存后把脚本加入调度队列即可。 + +## 配置管理方式 + +每个用户可选择一条龙配置的来源： + +| 配置管理方式 | 适合谁 | 实际含义 | +| --- | --- | --- | +| **用户独立配置** | 大多数用户 | 为该用户保存一份独立的一条龙配置，运行前加载、结束时按任务策略回写。同一脚本下不同用户可不同。 | +| **脚本直控配置** | 想让 BetterGI 自己管理配置 | 直接使用脚本当前的配置，不加载、也不回写该用户的独立配置；由直控用户共享。 | + +> 选择「脚本直控配置」时，下方「任务配置」与「自定义配置组」区块会整体置灰、不可编辑，由 BetterGI 原生配置决定。 + +## 任务配置（一条龙） + +BetterGI 的一条龙配置以独立 JSON 文件保存于 `{RootPath}/User/OneDragon/{名称}.json`（`Name` 字段等于文件名）。 + +### 一条龙名称 + +对应 BetterGI「一条龙」页面中已保存的配置名称。**留空则使用「默认配置」**。 + +### 内置配置组（8 个开关） + +下方 8 个按钮控制一条龙内置配置组的**开启 / 关闭**，可多选： + +| # | 配置组 | +| --- | --- | +| 1 | 领取邮件 | +| 2 | 合成树脂 | +| 3 | 自动地脉花 | +| 4 | 自动秘境 | +| 5 | 自动首领讨伐 | +| 6 | 自动幽境危战 | +| 7 | 领取每日奖励 | +| 8 | 领取尘歌壶奖励 | + +**语义说明**： + +- 这些按钮是**开关，而不是删减**：关闭某组只是把该组置为关闭，**组定义会保留**，日后可随时重新打开（可逆操作）。 +- 若某组当前为「开」但在配置中缺失，会自动补建并启用。 +- 本系统只管理这 8 个内置组；其余设置字段（队伍、秘境、地脉花、首领讨伐等）一律原样保留、不覆盖。 + +### 领取奖励队伍 + +填写领取奖励时使用的队伍名。**留空则不覆盖** BetterGI 现有设置。 + +### 通用战斗队伍 + +通用战斗场景使用的队伍名。留空则不覆盖 BetterGI 现有设置。 + +### 通用战斗策略 + +自动战斗策略下拉框。选项为 **「根据队伍自动选择」** + `{RootPath}/User/AutoFight/*.txt` 目录下已放置的战斗脚本文件名（每次实时扫描，可自行放入 `.txt` 脚本增加选项）。**留空默认为「根据队伍自动选择」**。 + +## 自定义配置组 + +自定义配置组 = 你自行创建、不属于上面 8 个内置组的配置组。 + +### 总开关「启用」 + +控制本系统是否接管自定义组的开启 / 关闭： + +- **关闭（默认）**：自定义组一律**原样保留**其启用状态与顺序，启用与否由 BetterGI 内部配置决定，本系统不干预。 +- **开启**：本系统按下方表格接管自定义组的启用状态。已列入表格的组按表格状态执行；已存在于 BetterGI 配置但未列入表格的组**默认开启**；已列入且启用但配置中缺失的组会自动补建。 + +> 首次开启且表格为空时，会**自动从 BetterGI 现有一条龙配置加载已有的自定义组**填入表格。 + +### 添加配置组 + +点击「添加配置组」，输入名称后确定即可添加，**添加后默认启用**（名称不能与已有组重复）。 + +### 表格管理 + +表格列出各自定义配置组，包含「配置组名称」与「是否启用」（可点击开关切换）。可通过复选框选中若干组，再点击「删除选中」批量移除。 + +## 配置 BetterGI（原生设置会话） + +点击右上角「配置 BetterGI」按钮，会在 BetterGI 原生界面打开一次设置会话，页面出现遮罩提示：请用户在 BetterGI 界面完成设置，完成后点击「**保存设置**」结束本次会话（默认 30 分钟无操作自动超时）。保存时会**回读 BetterGI 当前的一条龙配置**，并快照为该用户的独立副本。 + +## 用户一条龙副本 + +每个用户持有一份一条龙配置副本，保存在 `data/{脚本ID}/{用户ID}/OneDragon/{名称}.json`。写入时的种子优先级为： + +1. 该用户的副本（存在则优先） +2. BetterGI 现有一条龙配置 +3. 内置模板 + +## 常见问题 + +### 关闭了某个内置组，以后还能找回吗？ + +能。按钮是开关语义，关闭只置为关闭、不删除组定义；重新打开即可，可用状态会恢复。 + +### 「脚本直控配置」为什么不能编辑任务配置？ + +直控模式下，一条龙配置完全由 BetterGI 原生配置决定，MAS 不加载也不回写该用户的独立配置，因此相关字段整体置灰。想用 MAS 管理就切回「用户独立配置」。 + +### 自定义配置组关了，我在 BetterGI 里建的组会丢吗？ + +不会。总开关关闭时，自定义组原样保留其启用状态与顺序，本系统不干预；只有开启总开关后，才按表格接管其启用状态。 + +### 战斗策略为什么有我没建过的选项？ + +「根据队伍自动选择」是 BetterGI 内置默认策略，其余选项来自 `{RootPath}/User/AutoFight/` 下的 `.txt` 战斗脚本文件名，由系统实时扫描得出。 \ No newline at end of file diff --git a/docs/script-guide/index.md b/docs/script-guide/index.md index 0212ccc..27bdcf9 100644 --- a/docs/script-guide/index.md +++ b/docs/script-guide/index.md @@ -55,6 +55,17 @@ AUTO-MAS 支持多种游戏脚本的管理与调度。本节将介绍如何在 A --- +### [BetterGI](/docs/script-guide/bettergi) + +原神 - BetterGI + +- 原生 GUI 直控，账号由 BetterGI 原生管理，复杂设置在 BetterGI 界面完成 +- 为每个用户独立管理「一条龙」内置配置组（8 个可开关）与自定义配置组 +- 支持填写领取奖励队伍、通用战斗队伍与自动战斗策略，自动读取 `User/AutoFight` 下的战斗脚本 +- 切换账号、通知、额外脚本均可独立配置 + +--- + ### [通用调度](/docs/script-guide/general) 适用于所有支持启动时运行任务且能够打印日志的脚本 @@ -80,5 +91,6 @@ AUTO-MAS 支持多种游戏脚本的管理与调度。本节将介绍如何在 A - **鸣潮玩家**：查看 [OK-WW 配置方法](/docs/script-guide/okww) 快速上手 - **1999 玩家**：查看 [M9A 配置方法](/docs/script-guide/m9a) 快速上手 - **星穹铁道玩家**：查看 [HSR 配置方法](/docs/script-guide/hsr) 快速上手 +- **原神玩家**：查看 [BetterGI 配置方法](/docs/script-guide/bettergi) 快速上手 - **其他游戏**：查看 [通用调度](/docs/script-guide/general) 并使用现成模板 - **高级用户**：深入了解[通用调度](/docs/script-guide/general)的配置管理逻辑，自定义您的调度方案 diff --git a/en/docs/script-guide/bettergi.md b/en/docs/script-guide/bettergi.md new file mode 100644 index 0000000..e1fa54e --- /dev/null +++ b/en/docs/script-guide/bettergi.md @@ -0,0 +1,128 @@ +--- +title: BetterGI Configuration Guide +description: Genshin Impact - BetterGI specialization configuration guide +date: 2026-08-23 +--- + +# BetterGI Configuration Guide + +## Two things to know first + +**BetterGI** is a third-party tool for Genshin Impact. It can run One Dragon (daily commissions, resin clearing, Ley Line Outcrops, domains, world boss kills, etc.) and many advanced features. It works in a **native GUI direct-control** mode: accounts are managed natively by BetterGI, and complex settings are configured inside BetterGI's own interface. + +The AUTO-MAS specialization manages, for each user independently, the **One Dragon** task configuration, **custom config groups**, account switching records, and notifications. Before a run, AUTO-MAS loads that user's independent configuration into BetterGI; when the run ends, it writes it back according to the task strategy. AUTO-MAS does not maintain a full copy of the BetterGI configuration. + + + +## Quick start + +1. Download and extract [BetterGI](https://github.com/babalae/better-genshin-impact) from its official repository. It is recommended to use a path without non-ASCII characters, and complete a basic configuration in BetterGI first. +2. Open **Script Management** → **New Script**, choose the **BetterGI script**, and set the BetterGI `RootPath`. +3. Add a user, choose the **Configuration Management Mode** on the user edit page, and configure the One Dragon tasks as needed. +4. Click **Configure BetterGI** in the top-right corner, open the BetterGI native interface and save once; complex settings are also done here. +5. Save, then add the script to the scheduling queue. + +## Configuration management mode + +Each user can choose a source for their One Dragon configuration: + +| Configuration mode | Best for | What it means | +| --- | --- | --- | +| **User-specific config** | Most users | Saves an independent One Dragon configuration per user, loaded before a run and written back after. Different users under the same script can differ. | +| **Script direct control** | Letting BetterGI manage the config | Uses the script's current configuration directly, neither loading nor writing back the user's independent configuration; shared by direct-control users. | + +> When **Script direct control** is chosen, the **Task Configuration** and **Custom Config Groups** sections below are greyed out and not editable; BetterGI's native configuration decides. + +## Task configuration (One Dragon) + +BetterGI stores each One Dragon configuration as an independent JSON file at `{RootPath}/User/OneDragon/{Name}.json` (the `Name` field equals the file name). + +### One Dragon config name + +The name of a configuration saved in BetterGI's One Dragon page. **Leaving it empty uses "Default Configuration"**. + +### Built-in config groups (8 toggles) + +The 8 buttons below turn the One Dragon built-in config groups **on / off** and are multi-selectable: + +| # | Config group | +| --- | --- | +| 1 | Mail claim | +| 2 | Resin synthesis | +| 3 | Auto Ley Line Outcrop | +| 4 | Auto Domain | +| 5 | Auto world boss hunting | +| 6 | Auto Arcalanos crisis war | +| 7 | Claim daily rewards | +| 8 | Claim Serenitea Pot rewards | + +**Important semantics**: + +- These buttons are **toggles, not removals**: turning a group off only disables it; **its definition is preserved** and can be turned back on anytime (reversible). +- If a group is "on" but missing from the configuration, it is automatically created and enabled. +- AUTO-MAS only manages these 8 built-in groups; all other settings fields (parties, domains, Ley Line Outcrops, world boss hunting, etc.) are left untouched. + +### Daily reward party + +The party name used when collecting rewards. **Leaving it empty does not override** BetterGI's existing settings. + +### Combat party + +The party name used in general combat. Leaving it empty does not override BetterGI's existing settings. + +### Combat strategy + +Dropdown for the auto-battle strategy. Options are **"Auto-select based on party"** plus the `.txt` combat script file names under `{RootPath}/User/AutoFight/` (scanned in real time; you can drop in `.txt` scripts to add options). **Leaving it empty defaults to "Auto-select based on party"**. + +## Custom config groups + +Custom config groups are groups you create yourself, beyond the 8 built-in groups above. + +### Master toggle "Enable" + +Controls whether AUTO-MAS manages the on / off state of custom groups: + +- **Off (default)**: custom groups are **left as-is** (their enabled state and order preserved); whether they run is decided by BetterGI's internal configuration. +- **On**: AUTO-MAS manages custom group states through the table below. Groups listed in the table follow their table state; groups present in the BetterGI configuration but not listed default to **enabled**; groups listed as enabled but missing from the configuration are automatically recreated. + +> When toggled on for the first time with an empty table, existing custom groups are **auto-loaded from the current BetterGI One Dragon configuration** into the table. + +### Add config group + +Click **Add Config Group**, enter a name and confirm. New groups are **enabled by default** (names must not duplicate existing groups). + +### Table management + +The table lists each custom config group, with "Config group name" and "Enabled" columns (click the toggle to switch). You can select several rows with the checkboxes, then click **Delete Selected** to remove them in batch. + +## Configure BetterGI (native settings session) + +Click the **Configure BetterGI** button in the top-right corner to open a settings session in BetterGI's native interface. A mask appears prompting you to finish configuration in BetterGI, then click **Save Settings** to end the session (the session times out automatically after 30 minutes of no interaction). On save, AUTO-MAS **reads back the current BetterGI One Dragon configuration** and snapshots it as that user's independent copy. + +## Per-user One Dragon copy + +Each user holds a copy of the One Dragon configuration at `data/{ScriptID}/{UserID}/OneDragon/{Name}.json`. The seed priority when writing is: + +1. This user's copy (used first if present) +2. BetterGI's current One Dragon configuration +3. Built-in template + +## FAQ + +### If I turn off a built-in group, can I get it back later? + +Yes. The buttons are toggles: turning off only disables a group without deleting its definition. Turn it back on and its enabled state is restored. + +### Why can't I edit task configuration in "Script direct control" mode? + +In direct-control mode, the One Dragon configuration is fully decided by BetterGI's native configuration; AUTO-MAS neither loads nor writes back the user's independent configuration, so the related fields are greyed out. Switch back to "User-specific config" to have AUTO-MAS manage it. + +### Will my groups created in BetterGI be lost if I turn off the custom groups toggle? + +No. When the master toggle is off, custom groups keep their enabled state and order untouched. Only after you turn it on does AUTO-MAS manage their states through the table. + +### Why do I see strategy options I did not create? + +"Auto-select based on party" is BetterGI's built-in default strategy. The rest come from `.txt` combat scripts under `{RootPath}/User/AutoFight/`, scanned in real time by the system. \ No newline at end of file diff --git a/en/docs/script-guide/index.md b/en/docs/script-guide/index.md index cb85005..f9e93f5 100644 --- a/en/docs/script-guide/index.md +++ b/en/docs/script-guide/index.md @@ -55,6 +55,17 @@ Honkai: Star Rail - HSR specialization, with M7A and SRA dual engines --- +### [BetterGI](/en/docs/script-guide/bettergi) + +Genshin Impact - BetterGI + +- Native GUI direct control; accounts are managed natively by BetterGI, complex settings are done in BetterGI's interface +- Manages the One Dragon built-in config groups (8 toggles) and custom config groups independently per user +- Supports reward party, combat party, and auto-battle strategy fields, auto-reading combat scripts under `User/AutoFight` +- Account switching, notifications, and extra scripts can each be configured independently + +--- + ### [General Scheduling](/en/docs/script-guide/general) For scripts that can run tasks on startup and print logs @@ -80,5 +91,6 @@ Honkai: Star Rail - March7thAssistant - **Wuthering Waves players**: read the [OK-WW guide](/en/docs/script-guide/okww) - **Reverse: 1999 players**: read the [M9A guide](/en/docs/script-guide/m9a) - **Honkai: Star Rail players**: read the [HSR guide](/en/docs/script-guide/hsr) +- **Genshin Impact players**: read the [BetterGI guide](/en/docs/script-guide/bettergi) - **Other games**: read [General Scheduling](/en/docs/script-guide/general) and use an existing template - **Advanced users**: learn the configuration management model in [General Scheduling](/en/docs/script-guide/general) and customize your scheduling plan From 55b38e6061d09189468a26e845c3e7c41f6c932b Mon Sep 17 00:00:00 2001 From: TCddddd Date: Thu, 27 Aug 2026 21:36:07 +0800 Subject: [PATCH 2/3] =?UTF-8?q?docs(bettergi):=20=E5=AF=B9=E9=BD=90?= =?UTF-8?q?=E7=8B=AC=E7=AB=8B=E9=85=8D=E7=BD=AE=E6=A7=BD=E4=BD=8D=E9=9A=94?= =?UTF-8?q?=E7=A6=BB=E6=9C=BA=E5=88=B6=E4=B8=8E=E5=BF=85=E5=A1=AB=E4=B8=8B?= =?UTF-8?q?=E6=8B=89=20UI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户独立配置落地到 MAS 专属槽位「MAS独立配置」、BGI 同名实配零接触；一条龙名称改为必填下拉，补充通用战斗队伍/策略作用域与胶囊开关语义。 --- docs/script-guide/bettergi.md | 52 +++++++++++++++++++++----------- en/docs/script-guide/bettergi.md | 50 +++++++++++++++++++----------- 2 files changed, 67 insertions(+), 35 deletions(-) diff --git a/docs/script-guide/bettergi.md b/docs/script-guide/bettergi.md index f0fe6da..75f029f 100644 --- a/docs/script-guide/bettergi.md +++ b/docs/script-guide/bettergi.md @@ -1,7 +1,7 @@ --- title: BetterGI 配置方法 description: 原神 - BetterGI 专项适配配置指南 -date: 2026-08-23 +date: 2026-08-27 --- # BetterGI 配置方法 @@ -10,7 +10,7 @@ date: 2026-08-23 **BetterGI** 是原神的第三方辅助工具，能执行一条龙（每日委托、清体力、地脉花、秘境、首领讨伐等）与多种进阶功能。它是**原生 GUI 直控**模式：账号由 BetterGI 原生管理，复杂设置在 BetterGI 自己的界面里完成。 -AUTO-MAS 的专项适配为每个用户单独管理其**「一条龙」任务配置、自定义配置组、账号切换归档与通知**。运行前按该用户的独立配置加载到 BetterGI，结束时按任务策略回写保存。BetterGI 不需要保留在 MAS 里的一份完整配置。 +AUTO-MAS 的专项适配为每个用户单独管理其**「一条龙」任务配置、自定义配置组、账号切换归档与通知**。运行前按该用户的独立配置加载到 BetterGI，结束后回读该用户的一条龙设置并保存为独立副本。BetterGI 不需要在 MAS 里保留一份完整配置。 When **Script direct control** is chosen, the **Task Configuration** and **Custom Config Groups** sections below are greyed out and not editable; BetterGI's native configuration decides. +### Where the independent config lives (important) + +When **User-specific config** is enabled, AUTO-MAS does **not rewrite** your original One Dragon config (such as `User/OneDragon/默认配置.json`, "Default Config"). Instead it materializes the user's independent config into a **MAS-owned slot** `{RootPath}/User/OneDragon/MAS独立配置.json`, launches BetterGI with `startOneDragon MAS独立配置`, and deletes the slot when done (idempotent). + +So the One Dragon you always edit inside BetterGI is the one named **"MAS独立配置"** — not your own original config (that real file is never read or modified). + ## Task configuration (One Dragon) BetterGI stores each One Dragon configuration as an independent JSON file at `{RootPath}/User/OneDragon/{Name}.json` (the `Name` field equals the file name). -### One Dragon config name +### One Dragon config name (required) + +The name of a configuration saved in BetterGI's One Dragon page, **defaulting to 「默认配置」("Default Config")**. Options come from the existing config files under `{RootPath}/User/OneDragon/` (「默认配置」is placed first; the MAS slot "MAS独立配置" is not shown). -The name of a configuration saved in BetterGI's One Dragon page. **Leaving it empty uses "Default Configuration"**. +This name decides which real BetterGI configuration this user's One Dragon is snapshotted from. Choosing it does **not** mean MAS reads/writes that file at runtime — in independent mode the actual file is the "MAS独立配置" slot, as described under "Where the independent config lives" above. ### Built-in config groups (8 toggles) -The 8 buttons below turn the One Dragon built-in config groups **on / off** and are multi-selectable: +The 8 **capsule toggles** below turn the One Dragon built-in config groups **run / do not run** and are multi-selectable. **Checked (on) tasks run; unchecked (off) tasks do not**: | # | Config group | | --- | --- | @@ -70,28 +78,28 @@ The party name used when collecting rewards. **Leaving it empty does not overrid ### Combat party -The party name used in general combat. Leaving it empty does not override BetterGI's existing settings. +The party name used in general combat. Leaving it empty does not override BetterGI's existing settings; when filled, it is applied to the four combat tasks (**Auto Ley Line Outcrop, Auto Domain, Auto world boss hunting, Auto Arcalanos crisis war**), replacing BetterGI's default party for those tasks. ### Combat strategy -Dropdown for the auto-battle strategy. Options are **"Auto-select based on party"** plus the `.txt` combat script file names under `{RootPath}/User/AutoFight/` (scanned in real time; you can drop in `.txt` scripts to add options). **Leaving it empty defaults to "Auto-select based on party"**. +Dropdown for the auto-battle strategy. Options are **"Auto-select based on party"** plus the `.txt` combat script file names under `{RootPath}/User/AutoFight/` (scanned in real time; you can drop in `.txt` scripts to add options). **Leaving it empty defaults to "Auto-select based on party"**. Like the combat party, it applies to the four combat tasks above. ## Custom config groups -Custom config groups are groups you create yourself, beyond the 8 built-in groups above. +Custom config groups are groups you create in BetterGI's One Dragon page, beyond the 8 built-in groups — this is the table's data **source**. The table is only a **switch**: groups present in the One Dragon but not in the table **run by default**; groups added to the table follow their row's switch — on means run, off means do not run. ### Master toggle "Enable" Controls whether AUTO-MAS manages the on / off state of custom groups: - **Off (default)**: custom groups are **left as-is** (their enabled state and order preserved); whether they run is decided by BetterGI's internal configuration. -- **On**: AUTO-MAS manages custom group states through the table below. Groups listed in the table follow their table state; groups present in the BetterGI configuration but not listed default to **enabled**; groups listed as enabled but missing from the configuration are automatically recreated. +- **On**: AUTO-MAS manages custom group states through the table below. Groups listed in the table follow their table state; groups present in the BetterGI configuration but not listed run **by default**; groups listed as enabled but missing from the configuration are automatically recreated. -> When toggled on for the first time with an empty table, existing custom groups are **auto-loaded from the current BetterGI One Dragon configuration** into the table. +> When toggled on for the first time with an empty table, existing custom groups are **auto-loaded from the current BetterGI One Dragon configuration** into the table (in independent mode it reads the "MAS独立配置" slot). ### Add config group -Click **Add Config Group**, enter a name and confirm. New groups are **enabled by default** (names must not duplicate existing groups). +Click **Add Config Group** to pick a group from BetterGI's current configuration to bring under control, enter a name and confirm. New groups are **enabled by default** (names must not duplicate existing groups). Groups not added to the table stay in the One Dragon and are not lost because of the table. ### Table management @@ -99,18 +107,26 @@ The table lists each custom config group, with "Config group name" and "Enabled" ## Configure BetterGI (native settings session) -Click the **Configure BetterGI** button in the top-right corner to open a settings session in BetterGI's native interface. A mask appears prompting you to finish configuration in BetterGI, then click **Save Settings** to end the session (the session times out automatically after 30 minutes of no interaction). On save, AUTO-MAS **reads back the current BetterGI One Dragon configuration** and snapshots it as that user's independent copy. +Click the **Configure BetterGI** button in the top-right corner to open a settings session in BetterGI's native interface. A mask appears prompting you to finish configuration in BetterGI. With **User-specific config** enabled, select and edit the One Dragon named **"MAS独立配置"** (do not touch your original config), then click **Save Settings** to end the session (the session times out automatically after 30 minutes of no interaction). On save, AUTO-MAS **reads back the current "MAS独立配置" slot** and snapshots it as that user's independent copy. ## Per-user One Dragon copy Each user holds a copy of the One Dragon configuration at `data/{ScriptID}/{UserID}/OneDragon/{Name}.json`. The seed priority when writing is: 1. This user's copy (used first if present) -2. BetterGI's current One Dragon configuration +2. BetterGI's current real One Dragon configuration (by the One Dragon config name) 3. Built-in template ## FAQ +### After enabling "User-specific config", which One Dragon should I edit in BetterGI? + +The one named **"MAS独立配置"**. In independent mode MAS reads and writes this slot and launches with it at runtime. Your original config (such as 「默认配置」, "Default Config") is not read and is unaffected by edits here. + +### Will my "Default Config" created in BetterGI be overwritten into the shape of "User-specific config"? + +No. MAS only operates on the "MAS独立配置" slot; your same-named real config (such as 「默认配置」, "Default Config") is never touched — this zero-contact behavior is exactly the design goal of independent mode. + ### If I turn off a built-in group, can I get it back later? Yes. The buttons are toggles: turning off only disables a group without deleting its definition. Turn it back on and its enabled state is restored. From 01000aff6e666835c19e33698d24b6933fe364f6 Mon Sep 17 00:00:00 2001 From: TCddddd Date: Thu, 27 Aug 2026 21:44:47 +0800 Subject: [PATCH 3/3] =?UTF-8?q?fix(bettergi):=20=E5=B9=BD=E5=A2=83?= =?UTF-8?q?=E5=8D=B1=E6=88=98=E8=8B=B1=E8=AF=91=E6=9B=B4=E6=AD=A3=E4=B8=BA?= =?UTF-8?q?=E5=AE=98=E6=96=B9=E5=90=8D=E7=A7=B0=20Auto=20Stygian=20Onslaug?= =?UTF-8?q?ht?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 响应 Sourcery 评审：第六个内置组「幽境危战」官方英文名是 Stygian Onslaught（与 BetterGI 全局配置键 autoStygianOnslaughtConfig 一致），替换不准确的 'Auto Arcalanos crisis war'。 --- en/docs/script-guide/bettergi.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en/docs/script-guide/bettergi.md b/en/docs/script-guide/bettergi.md index e803965..7706928 100644 --- a/en/docs/script-guide/bettergi.md +++ b/en/docs/script-guide/bettergi.md @@ -62,7 +62,7 @@ The 8 **capsule toggles** below turn the One Dragon built-in config groups **run | 3 | Auto Ley Line Outcrop | | 4 | Auto Domain | | 5 | Auto world boss hunting | -| 6 | Auto Arcalanos crisis war | +| 6 | Auto Stygian Onslaught | | 7 | Claim daily rewards | | 8 | Claim Serenitea Pot rewards | @@ -78,7 +78,7 @@ The party name used when collecting rewards. **Leaving it empty does not overrid ### Combat party -The party name used in general combat. Leaving it empty does not override BetterGI's existing settings; when filled, it is applied to the four combat tasks (**Auto Ley Line Outcrop, Auto Domain, Auto world boss hunting, Auto Arcalanos crisis war**), replacing BetterGI's default party for those tasks. +The party name used in general combat. Leaving it empty does not override BetterGI's existing settings; when filled, it is applied to the four combat tasks (**Auto Ley Line Outcrop, Auto Domain, Auto world boss hunting, Auto Stygian Onslaught**), replacing BetterGI's default party for those tasks. ### Combat strategy