# GameScript

**Repository Path**: seekermaple/game-script

## Basic Information

- **Project Name**: GameScript
- **Description**: 向僵尸开炮挂机脚本
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-27
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 向僵尸开炮 - 全自动挂机助手 (v1.0.0)

本项目是一款基于 Python 开发的游戏自动化辅助工具，专为《向僵尸开炮》小游戏设计。通过 OpenCV 图像识别与 PyAutoGUI 模拟操作，实现无人值守的环球救援抢位与精英主线推图。

> **最新版本**：提供了直观的 GUI 图形界面，支持实时日志显示、区域预览及参数动态调整。

## 📋 核心功能

-   **环球救援助手**：24小时监控聊天频道，自动识别招募信息，零延迟抢占救援名额。
-   **精英主线助手**：循环挑战精英关卡，涵盖自动开局、智能技能选择、超时卡死判定、体力耗尽自停。
-   **智能 UI 识别**：
    -   自动处理：网络重连、断网干扰、非法授权弹窗。
    -   智能技能树：基于图片库优先级的自动化选技逻辑。
-   **可视化操作**：内置截图预览功能，方便精准定位模拟器坐标。

---

## 🖥️ 界面预览与设置

1.  **运行环境**：推荐在 Windows 10/11 上运行。
2.  **窗口设置**：
    *   脚本默认适配 **542 * 1008** 分辨率窗口。
    *   若尺寸不同，请使用界面上的“刷新预览”确认识别区域，并根据需要对游戏窗口相应页面位置进行截图，替换 `picture/` 和`zhuxian_picture/` 目录下的图片素材。
3.  **权限要求**：若成功识别，但是点击无效，请尝试以 **管理员权限** 运行本程序（特别是针对应用宝、腾讯手游助手等模拟器）。

---

## 🚀 快速上手

### 1. 直接运行 (用户版)
1. 下载并解压 `GameScript-v1.0.0-win-x64.zip`。
2. 双击运行 `GameScript-v1.0.0-win-x64.exe`。
3. **设置参数**：
    *   **坐标(XYWH)**：设置游戏窗口在屏幕上的位置。
    *   **运行时间/次数**：设置脚本自动停止的阈值。
4. **启动脚本**：
    *   **抢环**：先进入游戏聊天/救援页面，点击“抢环”。
    *   **精英**：先进入精英模式关卡选择页，点击“精英”。

### 2. 开发者模式
若需从源码运行：
```bash
pip install pyautogui opencv-python numpy pillow PyQt5
python gui_main.py
```

### 3. 参考页面
<img  src="https://github.com/wcy-hash/GameScript/blob/main/picture/example.png?raw=true"  width="1000"  height=auto>

---

## 🛠️ 编译与打包

如果你修改了代码并希望重新生成 `.exe` 文件，项目根目录下已包含打包配置文件。

### 打包步骤：
1. 确保安装了 `pyinstaller`：
   ```bash
   pip install pyinstaller
   ```
2. 创建或编辑 `gui_main.spec` 文件，确认包含以下核心配置：
   ```python
   # -*- mode: python ; coding: utf-8 -*-
   a = Analysis(
       ['gui_main.py'],
       datas=[('picture', 'picture'), ('zhuxian_picture', 'zhuxian_picture'), ('config.ini', '.')],
       ...
       icon='picture/logo.ico',
   )
   ```
3. 执行打包命令：
   ```bash
   pyinstaller gui_main.spec
   ```
4. 打包完成后，在 `dist/gui_main` 目录下即可找到可执行文件。

---

## 📂 资源结构说明

| 目录/文件 | 说明 |
| :--- | :--- |
| `gui_main.py` | 主图形界面程序入口 |
| `qiang_huan.py` | 抢救援逻辑核心。**逻辑说明**：循环执行：`检查是否入队` -> `点击聊天` -> `点击招募` -> `抢票`。 |
| `zhuxian_main.py` | 精英主线逻辑核心。**逻辑说明**：自动执行：`点击开始` -> `识别开局` -> `自动选技能` -> `结算返回`。 |
| `utils.py` | 底层图像识别、UI 异常处理及工具函数 |
| `picture/` | 通用图片库（按钮、异常弹窗、技能图标） |
| `zhuxian_picture/` | 主线精英模式专用素材（暂停、退出、进入识别） |
| `config.ini` | 自动保存本地的坐标和运行参数 |

---

## ⚙️ 核心逻辑配置

| 参数 | 说明 |
| :--- | :--- |
| **任务耗时** | 仅针对精英模式。若单局时长超过此设定（如600秒），脚本将强制点击暂停并退出，防止关卡内卡死。 |
| **匹配精度** | 默认置信度为 0.7-0.9。如识别不准，可在 `qiang_huan.py` 或 `zhuxian_main.py` 的元组定义中修改 `confidence`。 |
| **防卡死** | 在抢票模式下，每尝试 100 次会强制休息 10 秒，以便用户夺回鼠标控制权。 |

---

## ⚠️ 注意事项与免责声明

*   **路径安全**：打包后的程序依赖 `picture` 等文件夹，请勿随意移动 `.exe` 与这些文件夹的相对位置。
*   **素材更新**：游戏版本更新可能导致 UI 变化，如脚本失效，请重新截取对应的按钮图片覆盖原素材。
*   **法律风险**：本脚本仅用于技术交流与自动化学习。严禁用于任何商业用途或违反游戏服务协议的行为。因使用本脚本导致的封号、损失等后果由使用者自行承担。

---