# mhxy_python **Repository Path**: Mr_ShenD/mhxy_python ## Basic Information - **Project Name**: mhxy_python - **Description**: test梦幻西游 自动化执行 - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-04-02 - **Last Updated**: 2026-04-02 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 梦幻西游自动化脚本 (mhxy_script) ## ⚠️ 重要风险警告 **脚本目前有被封号风险！使用前请务必了解：** - 使用第三方自动化脚本违反游戏服务条款 - 可能导致账号被永久封禁 - 请谨慎考虑，评估风险后使用 - **建议在非主要账号上测试使用** --- ## 📖 项目简介 本项目是一个基于Python的梦幻西游游戏自动化脚本，通过图像识别和鼠标键盘自动化操作，实现游戏日常任务的自动执行。 ### 核心功能 - **宝图任务** - 自动完成宝图任务 - **答题活动** - 自动完成科举、趣题、三界奇缘等答题活动 - **副本系统** - 自动化副本任务 - **捉鬼任务** - 自动完成钟馗捉鬼任务 - **秘境寻宝** - 自动化秘境任务 - **押镖活动** - 自动完成押镖任务 - **门派闯关** - 自动化门派任务 - **日常任务** - 综合性日常任务自动化 - **自动战斗** - 智能自动战斗系统 - **商店购物** - 多商店自动化购买 - **采矿系统** - 自动化采矿功能 ### 技术特点 - 基于图像识别 (OpenCV) 的界面定位 - PyQt5 GUI图形界面 - 多窗口管理支持 - 灵活的配置系统 - 支持二次开发 --- ## 🛠️ 环境要求 ### 依赖环境 - Python 3.8+ - Windows 操作系统 - 梦幻西游游戏客户端 ### Python依赖 ```bash pip install -r requirements.txt pip install -r ui/requirements.txt ``` 核心依赖包括： - PyQt5 - GUI界面框架 - opencv-python - 图像识别 - pyautogui - 鼠标键盘控制 - pywin32 - Windows API调用 - numpy - 数值计算 --- ## 📁 目录结构 ``` mhxy_script-master/ ├── mhxy/ # 核心模块 │ ├── __init__.py # 主逻辑、工具函数、截图功能 │ ├── mhxy_ocr.py # 文字识别 │ └── screenshotpy.py # 截图功能 ├── resources/ # 图像资源目录 │ ├── bangpai/ # 门派相关图片 │ ├── baotu/ # 宝图任务图片 │ ├── common/ # 通用图片 │ ├── fuben/ # 副本任务图片 │ ├── ghost/ # 捉鬼任务图片 │ ├── haidi/ # 海底任务图片 │ ├── linlongshi/ # 灵石洞天图片 │ ├── menpai/ # 门派任务图片 │ ├── mihunta/ # 迷魂塔图片 │ ├── mine/ # 采矿相关图片 │ ├── origin/ # 原始分辨率图片 │ ├── richang/ # 日常任务图片 │ ├── shop/ # 商店相关图片 │ └── small/ # 小地图分辨率图片 ├── ui/ # 图形界面 │ ├── dialog/ # 配置对话框 │ ├── win/ # UI设计文件 │ ├── mhxy_pyqt.py # 主界面程序 │ ├── mhxy_pyqt1.py # 备用界面程序 │ └── requirements.txt # UI依赖 ├── game_process.py # 窗口管理进程 ├── mhxy_auto_battle.py # 自动战斗 ├── mhxy_baotu.py # 宝图任务 ├── mhxy_dati.py # 答题活动 ├── mhxy_fuben.py # 副本任务 ├── mhxy_ghost.py # 捉鬼任务 ├── mhxy_mijing.py # 秘境任务 ├── mhxy_yabiao.py # 押镖任务 ├── mhxy_menpai.py # 门派任务 ├── mhxy_mihunta.py # 迷魂塔任务 ├── mhxy_linlongshi.py # 灵石洞天 ├── mhxy_haidi.py # 海底任务 ├── mhxy_shopping.py # 商店购物 ├── mhxy_shopping2.py # 商店购物(增强版) ├── mhxy_shopping3.py # 商店购物(最终版) ├── mhxy_mine.py # 采矿系统 ├── mhxy_hanhua.py # 喊话功能 ├── mhxy_remote_control.py # 远程控制 ├── mhxy_remote_client.py # 远程客户端 └── requirements.txt # 主程序依赖 ``` --- ## 🚀 快速开始 ### 1. 安装依赖 ```bash pip install -r requirements.txt cd ui && pip install -r requirements.txt ``` ### 2. 启动程序 ```bash # 方式一：通过UI界面启动 cd ui python mhxy_pyqt.py # 方式二：直接运行脚本 python mhxy_baotu.py python mhxy_ghost.py ``` ### 3. 使用说明 1. 启动梦幻西游游戏客户端 2. 运行自动化脚本 3. 脚本会自动识别游戏窗口并执行相应任务 --- ## 📋 任务配置 部分任务支持自定义配置，通过UI对话框进行设置： | 任务类型 | 配置选项 | |---------|---------| | 宝图 | 任务轮次、坐标偏移 | | 捉鬼 | 任务轮次、坐标配置 | | 门派 | 任务选择、起点位置 | | 迷魂塔 | 任务参数 | | 灵石洞天 | 任务参数 | --- ## ⚙️ 二次开发 ### 开发注意事项 1. **坐标系统** - 脚本使用相对坐标系统 - 提供多种坐标转换函数：`percentX/Y`、`relativeX2Act`、`winRelativeX/Y`等 2. **图像匹配** - 使用OpenCV进行图像识别 - 支持多分辨率适配 - 置信度默认0.9 3. **任务扩展** - 继承 `MhxyScript` 基类 - 实现 `do()` 方法 - 使用 `PicNode` 进行流程控制 4. **窗口管理** - 支持多窗口排列 - 提供 `GameProcess` 进行窗口控制 ### 示例：创建新任务 ```python from mhxy import MhxyScript class MyMission(MhxyScript): def __init__(self, idx=0, changWinPos=True): super().__init__(idx, changWinPos) def do(self): # 实现你的任务逻辑 pass ``` --- ## 🔧 核心模块说明 ### mhxy/__init__.py - **工具函数**：坐标转换、战斗状态检测、冷却等待 - **截图功能**：区域截图、保存 - **Util类**：屏幕定位、鼠标点击、键盘操作 - **MhxyScript基类**：所有任务脚本的父类 ### 任务脚本结构 每个任务脚本包含以下核心方法： - `__init__`：初始化参数 - `_find_xxx`：查找相关UI元素 - `_run_xxx`：执行任务流程 - `do()`：任务入口 --- ## ⚠️ 免责声明 1. 本脚本仅供学习和研究使用 2. 使用本脚本产生的任何后果由使用者自行承担 3. 请遵守游戏服务条款 4. 建议在测试账号上验证后再用于主要账号 --- ## 📝 更新日志 请查看提交历史获取更新信息。 --- ## 🤝 贡献者 感谢所有为这个项目做出贡献的人！ --- ## 📧 联系方式 如有问题，请在项目Issue中反馈。