Blue Archive Auto Script

Appearance

INFO

本文档收录BAAS每一条配置

  1. type: 数据类型
  2. element : 列表 / 字典元素的数据类型
  3. constrains : 可选值范围(n 选 1)
  4. range : 数值型数据的范围
  5. description : 配置描述
  6. note : 需要注意的地方
  7. example : 填写示例
  8. related docs : 相关文档
  9. related issue : 相关issue(这项配置由于这个issue才被添加)

配置文件 ​

  • 在config目录下, 每个文件夹中储存一份可以独立运行BAAS的配置文件, 一个配置文件夹中包含以下文件:
    1. config.json : 用户配置, 与BAAS的GUI交互时基本都是在修改这个文件
    2. event.json : 调度配置
    3. switch.json : 一些GUI有关的配置
  • config/gui.json GUI的配置文件
  • config/static.json 为共享的配置文件, 其中的内容在BAAS运行时不会被修改

如何在重新安装BAAS时保留原有配置 ​

  1. 复制一份原始BAAS的config文件夹
  2. 将复制的config文件夹放在新BAAS可执行文件的同级目录下
    • 如果你使用full_env, 则覆盖新的config文件夹
  3. 运行BAAS可执行程序

增删一条用户配置 ​

  1. 在core/default_config.py 中修改DEFAULT_CONFIG变量, 添加对应字段后重启UI
  2. 便会将所有新配置插入

增删一条调度配置 ​

  1. 在core/default_config.py 中修改SWITCH_CONFIG变量, 添加对应字段后重启UI
  2. 调度配置的每一项具体含义可以见调度配置

Emulator Related (模拟器相关) ​

screenshot_interval ​

  • type: float
  • range : [0.3, INF]
  • description : 截图间隔
  • note : 这里的 间隔 是指从获取上一张截图的函数调用完毕到下一次获取函数截图开始的时间间隔

adbIP ​

  • type: str
  • description : 模拟器的ip地址
  • note : 参见 adbPort的note

adbPort ​

  • type: Union[int, str]
  • description : 模拟器端口号
  • note : 当你的模拟器序列号并非为<IP>:<Port>格式时, 将adbIP 或 adbPort 设置为空, 另一个设置为需要连接的模拟器的完整的序列号即可,
  • example : 首先请阅读adb设备连接管理 :

连接 10.129.164.6:5555:

  • adbIP: 10.129.164.6
  • adbPort: 5555

连接 emulator-5554:

  1. 方案一:
  • adbIP: ''
  • adbPort: emulator-5554
  1. 方案二:
  • adbIP: emulator-5554
  • adbPort: ''

screenshot_method ​

control_method ​

server ​

  • type: str
  • constrains : "官服" / "B服" / "日服" / "国际服" / "国际服青少年" / "韩国ONE"
  • description : 服务器名称
  • note :
    1. 用于Baas_thread类中的self.server, self.package以及ConfigSet类中的self.server_mode变量值
    2. 不同服务器的配置不同, 切换服务器时需要重启UI以更新配置

then ​

  • type: str
  • constrains : "退出 Baas" / "退出 模拟器" / "退出 Baas 和 模拟器" / "关机" / "无动作"
  • description : BAAS运行完毕后的动作
  • note : 运行完毕的标志为 下一次执行任务的等待时间>=120s

program_address ​

  • type: str
  • description : 模拟器的安装路径
  • note :
  1. 特定模拟器截图/控制需要加载其安装路径下的动态库
  2. 启动模拟器时确定可执行文件位置

open_emulator_stat ​

  • type: bool
  • description : 启动调度器后是否先启动模拟器

emulator_wait_time ​

  • type: int
  • range : [0, INF]
  • description : 开启模拟器的等待时间,在这一固定时间后BAAS认为模拟器已经打开完全,可以执行具体任务
  • note : 未来希望去除这一配置,模拟器的启动与否不是单纯靠等待一个固定时间决定的,需要有方法去检测模拟器是否启动完全

emulatorIsMultiInstance ​

  • type: bool
  • description : 模拟器是否为多开

emulatorMultiInstanceNumber ​

  • type: int
  • range : [0, INF]
  • description : 模拟器多开号

multiEmulatorName ​

  • type: str
  • description : 使用的模拟器的名称
  • constrains :
  1. "mumu": 'MuMu模拟器',
  2. "mumu_global": 'MuMu模拟器全球版',
  3. "bluestacks_nxt_cn": '蓝叠模拟器',
  4. "bluestacks_nxt": '蓝叠国际版'

Arena (竞技场) ​

purchase_arena_ticket_times ​

  • type: int
  • range : [0, INF]
  • description : 每日购买竞技场门票次数
  • note : 每日竞技场战斗次数 = 5 + 5 * 购买次数

ArenaLevelDiff ​

  • type: int
  • range : [-INF, INF]
  • description : 竞技场选择对手时能接受的最大等级差距, 正数表示可以接受对手等级高于自己的对手, 负数表示可以接受对手等级低于自己的对手

ArenaComponentNumber ​

  • type: int
  • range : [1, 3]
  • description : 竞技场对手编号

maxArenaRefreshTimes ​

  • type: int
  • range : [0, INF]
  • description : 当遇到等级差距过大的对手时, 最多刷新次数

Cafe (咖啡厅) ​

cafe_reward_invite1_criterion ​

  • type: str
  • Constraints:
    • "lowest_affection": 邀请最低好感度学生
    • "highest_affection": 邀请最高好感度学生
    • "starred": 邀请收藏的指定编号的学生
    • "name": 邀请指定名字的学生
  • Description: 1号咖啡厅的邀请方式

cafe_reward_invite1_starred_student_position ​

  • type: int
  • range: [1, 5]

favorStudent1 ​

  • type: List[str]
  • Description: 1号咖啡厅的邀请学生名字
  • note: 索引小到大逐次尝试, 邀请时ocr获取的姓名与配置名完全匹配才会邀请

cafe_reward_invite2_criterion ​

  • type: str
  • Constraints:
    • "lowest_affection": 邀请最低好感度学生
    • "highest_affection": 邀请最高好感度学生
    • "starred": 邀请收藏的指定编号的学生
    • "name": 邀请指定名字的学生
  • Description: 2号咖啡厅的邀请方式

cafe_reward_invite2_starred_student_position ​

  • type: int
  • range: [1, 5]

favorStudent2 ​

  • type: List[str]
  • Description: 2号咖啡厅的邀请学生名字
  • note: 索引小到大逐次尝试, 邀请时ocr获取的姓名与配置名完全匹配才会邀请

Create (制造) ​

createTime ​

  • type: int
  • range: [0, INF]
  • description : 每日制造次数上限

alreadyCreateTime ​

  • type: int
  • range: [0, INF]
  • description : 当日已经制造次数
  • note: 每日重置

create_phase ​

  • type: int
  • range: [1, 3]
  • description : 制造级数

createPriority_phase1 ​

  • type: List[str]
  • Description: 制造一阶段选择节点的优先级

create_phase_1_select_item_rule ​

  • type: str
  • Description: 制造一阶段选择材料的方式
  • constrains:
    1. "default": 使用10个制造石碎片或1个制造石

createPriority_phase2 ​

  • type: List[str]
  • Description: 制造二阶段选择节点的优先级

create_phase_2_select_item_rule ​

  • type: str
  • Description: 制造二阶段选择材料的方式
  • constrains
    1. "default": 使用数量最多的白色材料

createPriority_phase3 ​

  • type: List[str]
  • Description: 制造三阶段选择节点的优先级

create_phase_3_select_item_rule ​

  • type: str
  • constrains
    1. "default": 使用数量最多的金色材料
  • Description: 制造三阶段选择材料的方式

create_item_holding_quantity ​

  • type: dict[str, int]
  • Description: 每一种制造材料的剩余数量
  • note: BAAS在选择制造材料时会确定每个位置的材料名称和数量, 当材料以数量排序时, 用于确定图像匹配的顺序

use_acceleration_ticket ​

  • type: bool
  • Description: 自动制造是否使用加速券

Lesson (日程) ​

purchase_lesson_ticket_times ​

  • type: int
  • range : [0, 4]
  • description : 购买日程券的次数

lesson_each_region_object_priority ​

  • type: List
  • element : List
    • element : str
    • description : 每个区域选择日程的等级
    • example :
    json
          [
          "primary",
          "normal",
          "superior"
      ]
    表示这个区域会优先做编号为7-8的日程(superior) --> 3-4(normal) --> 1-2(primary)
  • note : 当在两个日程间做选择时,会优先选择获得好感经验多的日程

lesson_relationship_first ​

  • type: bool
  • description : 选择日程时是否优先选择可获得好感度多的

lesson_times ​

  • type: List
  • element : int
    • range : [0, INF]
  • length : 不同服务器长度不同
  • description : 每个区域日程次数

Common Task ​

mainlinePriority ​

unfinished_normal_tasks ​

  • type: str
  • description : 今日还未扫荡的普通任务的扫荡关卡
  • note : 每日刷新

explore_normal_task_regions ​

Hard Task ​

hardPriority ​

unfinished_hard_tasks ​

  • type: str
  • description : 今日还未扫荡的普通任务的扫荡关卡
  • note : 每日刷新

explore_hard_task_List ​

Drill (战术综合测试) ​

drill_difficulty_List ​

  • type: List
  • length : 3
  • element : int
    • range : [1, 4]
  • description : 战术综合测试三次挑战的难度

drill_fight_formation_List ​

  • type: List
  • length : 3
  • element : int
    • range : [1, 4]
  • description : 战术综合测试三次挑战的队伍编号
  • note : 队伍编号不能重复

drill_enable_sweep ​

  • type: bool
  • description : 是否扫荡综合战术测试

Common Shop ​

CommonShopList ​

  • type: List[int]
  • description : 日常商店购买商品列表, 0表示不购买, 1表示购买
  • note : 不同服务器的长度不同

CommonShopRefreshTime ​

  • type: int
  • range : [0, 3]
  • description : 日常商店的刷新次数

Tactical Challenge Shop ​

TacticalChallengeShopList ​

  • type: List[int]
  • description : 竞技场商店购买商品列表, 0表示不购买, 1表示购买
  • note : 不同服务器的长度不同

TacticalChallengeShopRefreshTime ​

  • type: int
  • range : [0, 3]
  • description : 竞技场商店的刷新次数

Bounty (悬赏委托) ​

rewarded_task_times ​

  • type: List[Union[int, str]]
  • element : [0, INF] or 'max'
  • length : 3
  • description : 每个区域使用学园交流会券的次数

purchase_rewarded_task_ticket_times ​

  • type: int
  • range : [0, 12]
  • description : 购买悬赏委托券的次数

Commissions (特殊委托) ​

special_task_times ​

  • type: List[Union[int, str]]
  • element : [0, INF] or 'max'
  • length : 2
  • description : 扫荡经验本(据点防御)和钱本(信用回收)的次数

Scrimmage (学园交流会) ​

scrimmage_times ​

  • type: List[Union[int, str]]
  • element: [0, INF] or 'max'
  • length: 3
  • description : 每个区域使用学园交流会券的次数

purchase_scrimmage_ticket_times ​

  • type: int
  • range: [0, 12]
  • description: 购买学院交流会券的次数

Activity ​

activity_sweep_task_number ​

activity_sweep_times ​

Clear Friend (自动清好友) ​

clear_friend_white_List ​

  • type: List[str]
  • description : 自动删好友白名单, 每一项为好友码

Other ​

auto_start ​

  • type: bool
  • description: 在启动BAAS ui启动完全后自动运行这一项配置

burst1 burst2 pierce1 pierce2 mystic1 mystic2 shock1 shock2 ​

  • type: int
  • range: [1, 4]
  • description: 对应属性在游戏里队伍的编号, 用于自动选择队伍

manual_boss ​

  • type: bool
  • description: 推图时是否手动打BOSS, 为真则进入BOSS战会点击暂停并等待手动操作

push_after_error ​

  • type: bool
  • description: 当BAAS发生错误时是否推送错误信息

push_after_completion ​

  • type: bool
  • description: 当BAAS完成任务时是否推送完成信息

push_json ​

  • type: str
  • description: 推送json信息的url地址

push_serverchan ​

last_refresh_config_time ​

  • type: float
  • description: 上次刷新配置的时间
  • note:

  1. BAAS根据上次刷新时间和当前时间判断是否需要刷新配置, 当且仅当以下表达式不满足时需要刷新配置(同一天每日游戏数据刷新时间前/后), 游戏数据重置时间

    python
        daily_reset = 4 - (self.server == "Global" or self.server == "JP")
    python
        # 判断语句
    now.day == last_refresh.day and 
    now.year == last_refresh.year and 
    now.month == last_refresh.month and \
    ((hour < daily_reset and last_refresh_hour < daily_reset) # 两者都在四点前
    or 
    (hour >= daily_reset and last_refresh_hour >= daily_reset)) # 两者都在四点后

  2. 哪些数据会被重置

    名称重置为
    alreadyCreateTime0
    unfinished_normal_tasksmainlinePriority
    unfinished_hard_taskshardPriority

new_event_enable_state ​

  • type: str
  • description : 当BAAS更新新的功能时,如果它加入调度器,那么它的开关状态
  • related issue : #166

bannerVisibility ​

  • type: bool
  • description : 是否显示ui首页banner(关闭后日志界面更大)

name ​

  • type: str
  • description : ui界面顶层显示的该配置的配置名

在不同服务器有区别的配置 ​

游戏每日数据重置时间 ​

  • description:
    • 国服: 4:00
    • 国际服/日服: 3:00
  • note: 时间为UTC+8