gitwtfhub

wtf is wechat_jump_game?

wangshub/wechat_jump_game — explained in plain English

Analysis updated 2026-06-24

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

TL;DR

A Python script that automatically plays the WeChat Jump mobile game by connecting to an Android phone via ADB, analyzing screenshots to find the jump target, and sending the correct tap to the screen.

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

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

What's in the stack?

PythonADB

How it stacks up

wangshub/wechat_jump_gamedask/daskdottxt-ai/outlines
Stars13,83413,83113,837
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity2/53/52/5
Audiencedeveloperdatadeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

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.

Wtf does this do

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.

Yoink these 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?

Frequently asked questions

wtf is wechat_jump_game?

A Python script that automatically plays the WeChat Jump mobile game by connecting to an Android phone via ADB, analyzing screenshots to find the jump target, and sending the correct tap to the screen.

What language is wechat_jump_game written in?

Mainly Python. The stack also includes Python, ADB.

What license does wechat_jump_game use?

License is not stated in the available content.

How hard is wechat_jump_game to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is wechat_jump_game for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.