Skip to content

DaydreamStarRiver/Svb_Byd_Deck_Auto

Repository files navigation

logo

Shadowverse: Worlds Beyond 自动化脚本

一个用于Shadowverse: Worlds Beyond游戏的自动化脚本工具,提供图形界面操作,支持多服务器配置、换牌策略选择和战斗自动化功能。

功能一览

核心功能

  • 多服务器支持:支持国际服和国服配置,自动切换对应模板目录
  • 换牌策略:提供3费、4费、5费三个档次的换牌策略,优化起手手牌组合
  • 战斗自动化:自动执行回合结束、随从攻击、进化/超进化等操作
  • 卡组管理:支持保存、加载和分享卡组配置
  • 庆典模式:支持庆典广场赛活动的自动化流程
  • 空过功能:可在战斗中直接结束回合,跳过其他操作
  • 运行控制:支持设置运行时长和对战次数阈值,新增强制关闭模式
  • 卡牌设置:支持设置卡牌优先级、进化优先级和模式选项(选项1/选项2)

UI功能

  • 图形界面:提供直观的图形界面操作
  • 状态栏显示:实时显示当前状态、运行时间和对战次数
  • 日志系统:详细的运行日志,便于问题排查

面向普通玩家的简易安装与使用

安装步骤

  1. Release页面下载最新版本的安装包
  2. 解压安装包到任意目录
  3. 运行Shadowverse_Auto.exe即可启动程序

使用步骤

  1. 配置设置

    • 选择服务器(国际服/国服)
    • 开启深色识别(仅国际服有深色BUG的用户需要)
    • 选择庆典模式(根据游戏活动需要)
    • 设置启用空过(根据需要选择)
  2. 卡组选择

    • 在"卡组选择"页面选择与游戏中使用的相同卡组
    • 点击"保存卡组"按钮保存选择
  3. 卡牌设置

    • 在"卡牌设置"页面设置卡牌的出牌优先级、进化优先级
    • 为模式卡牌选择模式选项(选项1/选项2)
    • 点击"保存设置"按钮保存配置
  4. 参数设置

    • 调整拖拽速度(默认即可)
    • 设置自动重启时间(建议3-10分钟)
    • 配置运行终止条件(可选)
  5. 开始运行

    • 点击"连接设备"按钮连接模拟器
    • 点击"开始运行"按钮启动脚本

面向开发者的简易安装与使用

开发环境搭建

  1. 克隆项目仓库:

    git clone https://github.com/DaydreamStarRiver/Svb_Byd_Deck_Auto.git
    cd Svb_Byd_Deck_Auto
  2. 创建虚拟环境:

    python -m venv .venv
    .venv\Scripts\activate  # Windows
  3. 安装依赖

    pip install -r requirements.txt
  4. 运行开发版本:

    python main_ui.py

项目结构

Svb_Byd_Deck_Auto/
├── main.py              # 主入口文件
├── main_ui.py           # GUI界面实现
├── src/                 # 核心源码目录
│   ├── config/          # 配置管理
│   ├── device/          # 设备管理
│   ├── game/            # 游戏逻辑
│   └── utils/           # 工具函数
├── templates/           # 国服模板图片
├── templates_global/    # 国际服模板图片
├── shadowverse_cards_cost/  # 卡牌费用模板
├── saved_decks/         # 保存的卡组配置
├── models/              # OCR和MNIST模型
└── quanka/              # 全卡库图片

配置说明

  • config.json:存储卡牌优先级、进化优先级和模式选项配置
  • card_mode_options:普通模式卡牌的选项配置
  • card_evolve_mode_options:进化模式卡牌的选项配置

打包与发布

  1. 使用PyInstaller打包:

    pyinstaller main.spec
  2. 打包产物将生成在dist目录中

KNOWN ISSUE

  1. 国际服深色模式:MUMU模拟器运行的国际服可能会出现画面过暗的BUG,导致模板识别失败,建议开启深色识别选项
  2. 画面分辨率:仅支持1280x720分辨率,请确保模拟器设置正确
  3. 场地选择:建议使用黑色背景的场地,避免使用简易场地,否则识别出错率会增加

TODO

  1. 优化OCR识别速度和准确率
  2. 添加更多换牌策略和战斗策略
  3. 支持更多游戏活动模式
  4. 添加多设备管理功能
  5. 添加更多卡牌特殊操作支持

重要更新

2026/02/05

  • 终止逻辑:优化脚本终止逻辑,确保对战完成后再停止
  • 模式选项:为普通模式和进化模式卡牌添加了模式选项(空选项/选项1/选项2)

2026/02/04

  • 运行设置:添加了运行终止条件设置(运行时长和对战次数阈值)
  • 强制关闭模式:新增强制关闭模式选项,可直接强制关闭模拟器
  • 对战次数统计:在状态栏显示当前对战次数
  • 庆典广场支持:添加庆典广场相关模板图片

2026/02/03

  • 庆典模式:添加庆典模式功能,支持检测和点击庆典广场相关按钮
  • 空过功能:添加空过功能,可在战斗中直接结束回合
  • 日志优化:优化设备日志显示,确保UI日志与终端输出一致
  • 免责声明:添加免责声明不再显示选项

2025/12/30

  • 卡组管理:更新了保存加载卡组功能,现可在加载卡组时一并加载此前保存的随从出牌先后级
  • 卡组分享:重新加入卡组分享码功能,现可以在分享卡组时预览卡组,支持实时加载卡组
  • 换牌策略:换牌策略功能在底层进行了重构,后续预计会添加更多样的策略

2025/11/12

  • 卡组选择:更新了卡组选择中可选择卡组进行调整
  • 参数设置:参数设置中更新自动重启设置和换牌策略设置
  • 特殊操作:更新随从出牌特殊操作和法术出牌特殊操作
  • 进化操作:更新进化/超进化特殊操作
  • 识别优化:优化识别手牌和护盾,优化随从血量和攻击识别

开发里程碑

  • 换牌策略实现:实现多档次换牌策略并集成到游戏逻辑
  • HP检测模块:添加HP检测模块和MNIST预处理工具
  • 战斗逻辑优化:基于回合顺序和进化点的卡牌优先级系统
  • 换牌策略改进:优化换牌逻辑,提高起手质量

注意事项

  1. 使用环境

    • 请使用1280x720分辨率
    • 使用黑色背景的场地(不要用简易场地)
    • 画面设置请参考压缩包里面的 "对战画质1"和"对战画质2"
  2. 卡组同步

    • 脚本卡组选择请和你的游戏卡组保持同步
    • "保存卡组"后,你的游戏用的什么卡组你的脚本也要选择相同的卡组,包括衍生物
  3. 服务器选择

    • 可选国际服和国服
    • 深色识别,只有国际服有深色BUG的用户才需要开启
  4. 使用规范

    • 本工具仅供个人娱乐使用
    • 请遵守游戏相关规定,合理使用
    • 不要过度依赖脚本,影响游戏体验
  5. 风险提示

    • 使用脚本可能存在被游戏官方检测的风险
    • 作者不承担因使用本工具导致的任何游戏账号问题

加入我们

  • szb_auto 交流群 QQ 群:892100160
  • szb_auto 交流群 QQ 群:1070074638
  • szb_auto 开发群 QQ 群:883457604

许可证

本项目采用GPL3.0 license,您可以在遵守许可证条款的前提下自由使用、修改和分发本项目的代码。

Shadowverse: Worlds Beyond 自动化脚本工具
Copyright (C) 2025-2026 Auto SZB Team

本程序是自由软件:您可以根据自由软件基金会发布的GNU通用公共许可证第3版条款重新发布和/或修改它

本程序的发布是希望它能有用,但没有任何担保;甚至没有对适销性或特定用途适用性的暗示担保。有关详细信息,请参阅GNU通用公共许可证。

您应该已经收到了GNU通用公共许可证的副本。如果没有,请访问 <https://www.gnu.org/licenses/>

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages