如何使用炉石传说脚本：新手入门的完整指南

Hearthstone-Script（炉石传说脚本）是一款专为炉石传说玩家设计的辅助工具，支持自动执行游戏策略、智能卡组管理等功能。本指南将带你快速掌握脚本的安装、配置与使用方法，让你轻松体验自动化游戏的乐趣！

📋 目录

• 📋 目录
• ✨ 为什么选择炉石传说脚本
• 📋 支持的核心功能
• 💻 准备工作
• 📥 下载与安装步骤
• 🚀 快速启动教程
• ⚙️ 配置文件详解
• 🎯 策略选择指南
• ❓ 常见问题解决

✨ 为什么选择炉石传说脚本

炉石传说脚本通过自动化操作解放你的双手，无论是日常任务、卡组测试还是策略优化，都能提供稳定高效的辅助。支持多种自定义策略，兼容Windows系统，新手也能快速上手！

📋 支持的核心功能

• 多策略支持：秒投、基础、激进、MCTS等多种智能策略
• 自动更新：软件内置更新功能，一键获取最新版本
• 托盘模式运行：启动后最小化至系统托盘，不占用桌面空间
• 插件扩展：支持开发者自定义卡牌和策略插件

💻 准备工作

使用炉石传说脚本前，请确保你的设备满足以下要求：

• 操作系统：Windows 11
• 运行环境：JDK 21（若未安装，首次启动时会自动下载安装）
• 游戏配置：炉石传说客户端已安装并登录

📥 下载与安装步骤

1. 获取源码
   克隆项目仓库到本地：

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

2. 安装依赖
   项目使用Maven管理依赖，通过以下命令自动安装所需组件：

   cd Hearthstone-Script && ./mvnw compile
   

🚀 快速启动教程

完成安装后，按照以下步骤启动脚本：

1. 配置卡组
   将游戏内要使用的卡组移动到一号卡组位，确保卡组与选择的策略匹配。

2. 启动软件
   双击运行项目根目录下的hs-script.exe文件，首次启动可能需要等待JDK自动安装。

图：炉石传说脚本启动界面，显示唤醒需要登录的提示窗口

3. 开始运行
   • 点击界面上的"开始"按钮，或使用快捷键Ctrl + P启动脚本
   • 启动后可关闭主窗口，程序将以托盘模式在后台运行
   • 退出时可通过托盘右键菜单、执行force-stop.exe或使用快捷键Alt + P

⚙️ 配置文件详解

项目的核心配置文件为根目录下的pom.xml，主要包含以下配置项：

• 依赖管理（dependencies）：定义项目所需的Java库和版本
• 构建插件（plugins）：配置编译、打包等构建流程
• 项目信息：包含版本号、开发者信息等元数据

如需自定义策略或插件，可修改对应模块的配置文件：

• 卡牌插件配置：hs-script-card-sdk/
• 策略插件配置：hs-script-strategy-sdk/

🎯 策略选择指南

根据你的卡组类型和游戏目标，选择合适的策略：

• ⚡ 秒投策略：快速投降，适用于任务完成
• 🏹 基础策略：通用型策略，需搭配无战吼、无法术的卡组
• 🔥 激进策略：自动释放法术和战吼牌，适合快攻卡组
• 🤖 MCTS策略：基于蒙特卡洛树搜索的智能策略，对CPU性能要求较高

❓ 常见问题解决

遇到启动或运行问题时，可参考以下解决方案：

1. 注入失败

   • 确保以管理员身份运行软件
   • 安装Visual C++ Redistributable（32位和64位版本）
   • 关闭杀毒软件后重新下载程序

2. 无反应或崩溃
   检查log目录下的日志文件，常见问题可参考doc/常见问题.md

3. 策略失效

   • 确认卡组已放置在一号卡组位
   • 检查策略与卡组类型是否匹配
   • 更新至最新版本尝试解决兼容性问题