# maple-auto

**Repository Path**: ElfenSterben/maple-auto

## Basic Information

- **Project Name**: maple-auto
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-05
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 冒险岛挂机脚本工具

基于 PySide6 和 python-interception 的冒险岛挂机脚本工具。

## 功能特性

- 技能配置管理（启用、次数、CD、快捷键、位置）
- 移动模式配置（全图跳、定点）
- 职业和键位配置
- 状态检测（来人、GM巡查）通过图片对比
- 配置文件保存/加载/导入/导出
- 实时日志显示
- 随时可中断的脚本执行

## 安装

```bash
pip install -r requirements.txt
pip install -e .
```


### 安装 Interception 驱动

1. 下载 [Interception](https://github.com/oblitum/Interception/releases)
2. 以管理员身份运行 `install-interception.exe /install`
3. 重启电脑

## 运行

```bash
python -m src.main
```

## 独立按键录制回放工具

本仓库包含一个单独的软件窗口，用于录制、编辑、回放按键流程（含按键时长和间隔），回放使用 Interception 驱动。工具还支持鼠标移动/点击动作，并可配置时长抖动、间隔抖动、鼠标轨迹抖动来模拟更接近人类的行为。

```bash
python -m src.key_macro_main
```

或在安装项目后直接运行：

```bash
maplestory-key-macro
```

## 打包（Nuitka）

默认打包主程序为 `onefile`，发布目录仅保留 `lwn.exe`、`asserts/`、`configs/`：

```powershell
.\build_nuitka.ps1
```

如需打包独立按键录制工具：

```powershell
.\build_nuitka.ps1 -Target KeyMacro
```

如需 `standalone` 目录模式：

```powershell
.\build_nuitka.ps1 -Standalone
```

如需打包按键录制工具的 `standalone` 目录模式：

```powershell
.\build_nuitka.ps1 -Target KeyMacro -Standalone
```

说明：
- 输出目录固定为 `dist_nuitka`
- `onefile` 输出为 `dist_nuitka/lwn.exe`，依赖解包到 `exe` 同级目录 `lwn_runtime`
- `standalone` 输出为 `dist_nuitka/lwn.dist/lwn.exe`
- 按键录制工具 `onefile` 输出为 `dist_nuitka/key_macro.exe`
- 按键录制工具 `standalone` 输出为 `dist_nuitka/key_macro.dist/key_macro.exe`
- 会自动包含 `configs/` 和 `asserts/`（如果目录存在）

## 项目结构

```
├── src/
│   ├── core/           # 核心模块
│   │   ├── models.py           # 数据模型
│   │   ├── config_manager.py   # 配置管理
│   │   ├── script_engine.py    # 脚本引擎
│   │   ├── state_detector.py   # 状态检测
│   │   └── error_handler.py    # 错误处理
│   ├── drivers/        # 驱动模块
│   │   └── interception_driver.py  # 键盘驱动
│   ├── ui/             # UI 组件
│   │   ├── main_window.py      # 主窗口
│   │   ├── log_panel.py        # 日志面板
│   │   ├── skill_panel.py      # 技能面板
│   │   ├── config_panel.py     # 配置面板
│   │   └── config_toolbar.py   # 配置工具栏
│   └── main.py         # 入口文件
├── configs/            # 配置文件目录
├── asserts/            # 状态检测模板图片
├── logs/               # 日志文件
└── tests/              # 测试文件
```

## 使用说明

1. 启动程序后，配置技能和键位
2. 将状态检测模板图片放入 `asserts/` 目录
3. 点击"开始"按钮启动脚本
4. 点击"停止"按钮或检测到 GM 时自动停止

## 注意事项

- 需要以管理员权限运行
- 确保已安装 Interception 驱动
- 状态检测需要准备对应的模板图片