wangshub/wechat_jump_game

★ 13,834PythonAudience · developerComplexity · 2/5Setup · moderate

Mindmap

mindmap
  root((wechat-jump-game))
    How it works
      ADB connection
      Screenshot capture
      Image analysis
      Tap simulation
    Operation modes
      Manual click mode
      Automatic mode
    Requirements
      Android phone
      ADB installed
      Python 3
    Learning value
      Mobile automation
      Image processing
      Bot building

mindmap root((wechat-jump-game)) How it works ADB connection Screenshot capture Image analysis Tap simulation Operation modes Manual click mode Automatic mode Requirements Android phone ADB installed Python 3 Learning value Mobile automation Image processing Bot building

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Learn how ADB lets a computer send tap commands to an Android phone by reading the automation script.

USE CASE 2

Study image processing techniques that detect objects by color in screenshots to calculate jump distances.

USE CASE 3

Understand how to build a game automation bot that captures screenshots and acts on what it sees.

Tech stack

PythonADB

Getting it running

Difficulty · moderate Time to first run · 30min

Requires an Android phone with developer mode and ADB enabled. Anti-cheat detection may block the bot on current WeChat versions.

License is not stated in the available content.

In plain English

This repository contains a Python script that plays the WeChat "Jump" mobile mini-game automatically. Jump is a casual game released within the WeChat app in late 2017 where a small figure must jump from platform to platform. Holding your finger on the screen charges the jump, and releasing it sends the character forward. A longer press equals a longer jump. The goal is to land precisely on each platform and build up a high score on the leaderboard. The script works by connecting to an Android phone via ADB, which is a standard developer tool for communicating with Android devices from a computer. It captures a screenshot of the current game state, analyzes the image to find where the character is standing and where the next platform is located, then calculates how far apart they are in pixels. From that distance, it computes how long to press the screen and sends that press command back to the phone via ADB. The result is that the character jumps the correct distance without any human input. The README describes two operation modes. In the manual mode, a screenshot is shown on screen and the user clicks two points to indicate the start and target positions, then the script handles the tap. In the automatic mode, the script identifies the character and target platform by their colors in the screenshot and does the whole thing without human involvement. The README includes a note that WeChat's anti-cheat detection has improved significantly, and the bypass code in the repository may no longer work. The authors describe it as primarily a learning resource rather than a practical tool, since the game's detection is now strict enough to catch most automated clients. The code is written in Python 3 and uses ADB shell commands for device interaction and image processing for the visual analysis step.

Copy-paste prompts

Prompt 1

I have an Android phone connected via ADB with WeChat's Jump game open. Walk me through running the wechat_jump_game script to make the character jump automatically.

Prompt 2

How does the wechat_jump_game script detect the character's position and the target platform's position from a screenshot? Explain the image analysis steps.

Prompt 3

I want to adapt the wechat_jump_game approach to automate a different Android game. What parts of the code control screenshot capture, object detection, and tap simulation?

Prompt 4

The WeChat anti-cheat detection now blocks the bot. What does the bypass code in wechat_jump_game try to do, and why might it no longer work on newer WeChat versions?

Open on GitHub → Explain another repo

← wangshub on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.