炉石传说自动化脚本配置与使用全指南

准备工作

系统环境要求

炉石传说自动化脚本（Hearthstone-Script）需要在特定环境下运行，确保您的系统满足以下条件：

• 操作系统：Windows 10 或 Windows 11（其他系统未经过测试）
• 运行时环境：JDK 21（若未安装，首次启动脚本时会自动下载并安装）
• 硬件要求：最低配置即可运行，但MCTS策略需要较高CPU性能支持

技术架构解析

本项目采用多层次架构设计，主要技术组件包括：

• 核心层：基于Kotlin语言开发，结合部分Java代码实现跨平台能力
• 界面层：使用Swing框架构建桌面图形界面
• 数据层：采用SQLite数据库存储卡牌信息和用户配置
• 自动化层：通过JNI技术实现Windows系统级操作模拟

⚠️ 重要提示：项目仅供学习交流Java/Kotlin编程语言及炉石传说游戏玩法，不得用于违反法律法规及游戏协议的场景。

软件获取与安装

源码获取方式

🔍 通过Git克隆仓库（推荐开发人员使用）：

git clone https://gitcode.com/gh_mirrors/he/Hearthstone-Script.git

克隆完成后，需要进行项目初始化：

1. 使用管理员权限运行IDE
2. 执行Maven同步操作
3. 编译项目：

mvn compile

快速安装流程

对于普通用户，推荐使用预编译版本：

1. 获取安装包：从项目发布页面下载最新的hs-script.zip文件
2. 解压文件：将压缩包解压至任意目录（避免中文路径和系统目录）
3. 验证完整性：检查解压后的文件夹结构，确保包含hs-script.exe和相关依赖文件

⚠️ 安全警告：部分杀毒软件可能误报脚本文件，请在信任该项目的前提下添加信任或暂时关闭防护软件。

配置指南

卡组准备

在启动脚本前，需要在游戏中完成卡组配置：

1. 打开炉石传说客户端
2. 将需要使用的卡组移动到一号卡组位
3. 确保卡组符合所选策略的卡牌要求（基础策略需要无战吼无法术的套牌）

首次启动设置

🔍 初始配置步骤：

1. 双击运行解压目录中的hs-script.exe
2. 首次启动会检查JDK环境，如未安装将自动开始下载
3. 阅读并同意用户协议
4. 在设置向导中选择游戏模式和对应策略类型

策略选择指南

系统提供多种自动化策略，适用于不同场景：

• 秒投策略：快速结束对局，适用于任务完成
• 基础策略：通用模式，需要搭配无战吼无法术的卡组
• 激进策略：在基础策略上增加法术释放和战吼牌使用
• MCTS策略：基于蒙特卡洛树搜索的智能决策，需要卡牌插件支持

操作使用

基本操作流程

完成配置后，即可开始使用自动化功能：

1. 启动脚本：双击hs-script.exe打开主程序
2. 开始运行：点击界面"开始"按钮或使用快捷键Ctrl + P
3. 后台运行：启动后可关闭主窗口，程序将以系统托盘图标形式后台运行
4. 停止运行：通过系统托盘右键菜单退出，或使用快捷键Alt + P，也可执行force-stop.exe

高级功能使用

窗口管理：

• 支持游戏窗口透明度调节
• 可设置鼠标操作范围限制
• 提供窗口置顶和大小调整功能

策略定制：

• 通过权重设置页调整出牌优先级
• 高级设置中可配置鼠标控制模式
• 支持自定义游戏超时检测时间

快捷键一览

功能	快捷键
开始/暂停	Ctrl + P
强制停止	Alt + P
打开设置	Ctrl + S
查看日志	Ctrl + L

维护与故障处理

软件更新管理

系统提供灵活的更新机制：

• 自动更新：软件会定期检查新版本，发现更新时将提示下载
• 手动更新：
  1. 从发布页面下载最新的hs-script.zip
  2. 删除旧版目录下的new_version_temp文件夹（如有）
  3. 双击update.exe完成更新
• 开发版切换：在设置中开启"更新开发版"选项可获取测试版本

常见问题解决

启动问题

Q: 双击hs-script.exe无反应怎么办？
A: 检查是否安装了正确版本的JDK，或尝试以管理员身份运行程序。

Q: 提示dll注入失败如何处理？
A: 可能原因包括：

1. 未以管理员权限运行
2. 缺少Visual C++ Redistributable组件
3. 被杀毒软件拦截

解决方法：安装64位Visual C++ Redistributable和32位Visual C++ Redistributable，关闭杀毒软件后重新尝试。

运行时问题

Q: 脚本无法识别卡组怎么办？
A: 确保卡组已放置在一号卡组位，并检查是否选择了正确的游戏模式。

Q: 程序突然停止工作如何排查？
A: 查看软件根目录下log文件夹中的日志文件，或游戏目录Logs文件夹下的游戏日志，通过issue提交问题时请附上相关日志。

数据管理

日志文件：所有操作日志保存在软件根目录的log文件夹中，建议定期清理以节省磁盘空间。

配置备份：用户配置文件位于config目录下，如需重装系统，可备份此文件夹以保留个人设置。

附录

开源协议信息

本项目遵循GPL3.0开源协议及禁止商用附加协议，详细条款参见项目根目录下的LICENSE和ADDITIONAL_LICENSE_INFO文件。

策略插件开发

高级用户可开发自定义策略插件，相关文档参见项目中的插件开发文档。

版本更新历史

最新版本v4.9.0-GA主要更新内容：

• 新增开机自启功能
• 修复插件重复加载问题
• 优化激进策略的硬币使用逻辑
• 更新卡牌数据库

完整更新记录请参考项目文档中的更新记录。

图：炉石传说自动化脚本图标