# wangshub/wechat_jump_game

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/wangshub-wechat-jump-game).**

13,833 stars · 4,245 forks · Python · Apache-2.0

## Links

- GitHub: https://github.com/wangshub/wechat_jump_game
- Homepage: https://zhuanlan.zhihu.com/p/32452473
- awesome-repositories: https://awesome-repositories.com/repository/wangshub-wechat-jump-game.md

## Topics

`adb` `python` `wechat-app`

## Description

This project is a Python-based game automation bot and computer vision assistant designed to automate gameplay on Android devices. It functions as a controller that identifies game elements via pixel color scanning and simulates touch inputs to execute gameplay without manual intervention.

The system distinguishes itself through the use of anti-detection measures, implementing interaction coordinate management and timing offsets to avoid being flagged by security systems. It also employs resolution-dependent scaling coefficients to maintain jump accuracy across different device screen sizes.

The automation suite covers real-time screen capture, computer vision-based state analysis, and mathematical jump distance calculations to determine required press durations. It includes debugging tools that save annotated screenshots to visualize detected coordinates and calculated paths.

## Tags

### Game Development

- [Game Automation Bots](https://awesome-repositories.com/f/game-development/game-automation-bots.md) — Implements a bot that reads game state and executes optimal actions without manual intervention.
- [Mobile Game Automation Tools](https://awesome-repositories.com/f/game-development/mobile-game-automation-tools.md) — Uses computer vision and input simulation to automate gameplay on mobile devices.
- [Sequential Gameplay Automators](https://awesome-repositories.com/f/game-development/game-idling-automators/sequential-gameplay-automators.md) — Executes a programmed series of jumps via configuration files to automate game sessions. ([source](https://github.com/wangshub/wechat_jump_game/wiki/Android-%E5%92%8C-iOS-%E6%93%8D%E4%BD%9C%E6%AD%A5%E9%AA%A4))
- [Input Gesture Simulations](https://awesome-repositories.com/f/game-development/input-gesture-simulations.md) — Simulates precise press durations to trigger specific jump mechanics within the game engine.

### Artificial Intelligence & ML

- [Computer Vision](https://awesome-repositories.com/f/artificial-intelligence-ml/computer-vision-systems/computer-vision.md) — Applies computer vision techniques to identify game elements and calculate precise movement coordinates.
- [Computer Vision Libraries](https://awesome-repositories.com/f/artificial-intelligence-ml/computer-vision-systems/computer-vision/development-orchestration-tools/computer-vision-libraries.md) — Utilizes pixel color scanning and image processing to identify game elements and their coordinates.
- [Game Element Detection](https://awesome-repositories.com/f/artificial-intelligence-ml/game-element-detection.md) — Identifies coordinates of the player piece and target board by scanning pixel colors. ([source](https://github.com/wangshub/wechat_jump_game#readme))
- [Visual Game State Analysis](https://awesome-repositories.com/f/artificial-intelligence-ml/visual-game-state-analysis.md) — Analyzes screen pixels to determine the current coordinates of the player and destination. ([source](https://github.com/wangshub/wechat_jump_game/blob/master/wechat_jump_auto_iOS.py))

### Data & Databases

- [Pixel Analyzers](https://awesome-repositories.com/f/data-databases/image-preprocessing-utilities/pixel-normalizers/pixel-analyzers.md) — Analyzes pixel-level color data to identify and locate game objects on the screen.

### Development Tools & Productivity

- [Screen Capture Tools](https://awesome-repositories.com/f/development-tools-productivity/screen-capture-tools.md) — Captures real-time snapshots of the mobile screen for immediate visual analysis. ([source](https://github.com/wangshub/wechat_jump_game#readme))
- [Gameplay Macro Engines](https://awesome-repositories.com/f/development-tools-productivity/process-execution-utilities/script-execution-contexts/gameplay-macro-engines.md) — Runs scripted sequences of timed inputs based on real-time visual analysis of the game. ([source](https://github.com/wangshub/wechat_jump_game/blob/master/Makefile))

### Graphics & Multimedia

- [Display Screenshot Capture](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/display-capture/display-screenshot-capture.md) — Captures real-time screenshots of the device display to analyze game state and object positions.

### Mobile Development

- [Mobile Device Control Utilities](https://awesome-repositories.com/f/mobile-development/mobile-utilities/mobile-device-control-utilities.md) — Provides command-line utilities for remote interaction and input execution on mobile hardware via ADB.
- [Resolution Scaling Coefficients](https://awesome-repositories.com/f/mobile-development/resolution-scaling-coefficients.md) — Uses resolution-dependent scaling coefficients to ensure jump accuracy across various device screen sizes.

### Scientific & Mathematical Computing

- [Euclidean Distance Calculators](https://awesome-repositories.com/f/scientific-mathematical-computing/euclidean-distance-calculators.md) — Calculates the precise distance between the game piece and target to determine required jump power. ([source](https://github.com/wangshub/wechat_jump_game#readme))
- [Input Power Calculators](https://awesome-repositories.com/f/scientific-mathematical-computing/input-power-calculators.md) — Determines the necessary jump power by analyzing the spatial relationship between starting and target points. ([source](https://github.com/wangshub/wechat_jump_game/wiki/Android-%E5%92%8C-iOS-%E6%93%8D%E4%BD%9C%E6%AD%A5%E9%AA%A4))
- [Input Timing Calculators](https://awesome-repositories.com/f/scientific-mathematical-computing/input-timing-calculators.md) — Computes the required press duration based on the distance between the player and target coordinates. ([source](https://github.com/wangshub/wechat_jump_game/blob/master/README.rst))
- [Euclidean Distance Calculators](https://awesome-repositories.com/f/scientific-mathematical-computing/numerical-mathematical-foundations/mathematical-libraries-and-utilities/core-mathematical-concepts/distance-metrics/coordinate-distance-transformations/euclidean-distance-calculators.md) — Implements Euclidean distance calculations to determine the required jump power between game elements.

### Security & Cryptography

- [Anti-Detection Strategies](https://awesome-repositories.com/f/security-cryptography/anti-detection-strategies.md) — The project implements measures to avoid being flagged by service providers during automated gameplay to prevent account bans. ([source](https://github.com/wangshub/wechat_jump_game/blob/master/changelog.md))
- [Anti-Bot Evasion](https://awesome-repositories.com/f/security-cryptography/bot-detection/anti-bot-evasion.md) — Implements input timing and coordinate offsets to evade detection systems and prevent account bans.

### Software Engineering & Architecture

- [Automated Gameplay Controllers](https://awesome-repositories.com/f/software-engineering-architecture/architectural-design-patterns/object-oriented-foundations/game-logic-models/game-logic-controllers/automated-gameplay-controllers.md) — Analyzes screen data to calculate the optimal jump distances and timings for the bot. ([source](https://github.com/wangshub/wechat_jump_game/blob/master/README.rst))

### System Administration & Monitoring

- [Input Device Emulators](https://awesome-repositories.com/f/system-administration-monitoring/virtual-device-drivers/input-device-emulators.md) — Emulates physical input devices to inject touch and swipe events into the Android system stream. ([source](https://github.com/wangshub/wechat_jump_game/blob/master/wechat_jump_auto_curves.py))

### Testing & Quality Assurance

- [Coordinate-Based Interactions](https://awesome-repositories.com/f/testing-quality-assurance/screen-swipe-simulations/coordinate-based-interactions.md) — Determines precise pixel coordinates for interaction buttons to simulate user touches on the screen. ([source](https://github.com/wangshub/wechat_jump_game/blob/master/wechat_jump_auto_slim.py))

### User Interface & Experience

- [Element Positioning Utilities](https://awesome-repositories.com/f/user-interface-experience/element-positioning-utilities.md) — Calculates the center points of detected shapes to identify precise pixel positions of game elements. ([source](https://github.com/wangshub/wechat_jump_game/blob/master/wechat_jump_auto_curves.py))

### Part of an Awesome List

- [Bot Detection Evasion](https://awesome-repositories.com/f/awesome-lists/security/bot-detection-evasion.md) — Implements interaction coordinate management and timing offsets to avoid being flagged as a bot.
