explaingit

caisf25/fh6auto-fork

14PythonAudience · generalComplexity · 2/5Setup · moderate

TLDR

A Windows automation tool for Forza Horizon 6 that watches the game screen using image recognition and sends keyboard and mouse inputs to run races, buy cars, and grind skill points automatically without any manual input.

Mindmap

mindmap
  root((fh6auto-fork))
    What It Does
      Game automation
      Screen recognition
      Input simulation
    Modules
      Race loop
      Car purchasing
      Skill grinding
    Tech Stack
      Python
      Image matching
    Use Cases
      Credit grinding
      Car collecting
      Unattended play
    Platform
      Windows only
      High DPI support
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Run automated race loops in Forza Horizon 6 overnight to grind credits without touching the keyboard.

USE CASE 2

Bulk-purchase specific car models in the in-game car collection automatically by navigating menus via screen matching.

USE CASE 3

Chain race runs, car purchases, and skill grinding into a single hands-free pipeline that loops continuously.

Tech stack

PythonOpenCV

Getting it running

Difficulty · moderate Time to first run · 30min

Windows only, template images used for screen matching may need recapturing for your specific resolution and graphics settings.

In plain English

FH6Auto Fork is an automation tool for the game Forza Horizon 6, written in Python with a README in Chinese. It is a fork (a personal copy with modifications) of an upstream project of the same name. The tool watches the game screen using image recognition and then sends keyboard and mouse inputs to carry out repetitive tasks automatically, letting the user run the game unattended for extended periods. The tool has three main modules that can be run individually or chained together. The first handles repeated race runs: it automatically opens menus, navigates to EventLab, enters a blueprint code to select a specific race route, picks the correct car, and starts the race again and again for a set number of repetitions. The second module handles bulk car purchasing by navigating to the car collection, finding a target brand, selecting a specific model, and buying it repeatedly. The third module handles a skill point and reward mechanic in the game's upgrade system, automatically navigating through menus and clicking skill nodes in a path the user defines through a direction grid in the interface. All three modules can be linked into a single pipeline that cycles through racing, buying, and skill grinding in sequence and then loops back to the start. The tool uses screenshot comparison rather than fixed screen coordinates to decide what to do next. It takes a screenshot, checks whether the game is showing the expected menu or page by matching template images, and only proceeds if the right state is detected. This approach is intended to make the tool more reliable than scripts that blindly send keystrokes in a fixed sequence. If the game crashes or the screen shows something unexpected, the tool tries to detect the problem, bring the game window back into focus, navigate back to a known menu state, and resume from where it stopped. An optional auto-restart feature can relaunch the game and resume the script if the game process disappears entirely. The tool runs on Windows only and includes adjustments for high-DPI displays. The template images used for screen matching can be replaced by the user to handle different resolutions, graphics settings, or display configurations. The F8 key acts as an emergency stop at any time.

Copy-paste prompts

Prompt 1
I want to run the fh6auto race automation module in Forza Horizon 6. Walk me through how to configure the EventLab blueprint code and set the number of repetitions before starting.
Prompt 2
The fh6auto tool uses template image matching to detect game states. How do I replace the default template images with ones that match my screen resolution and graphics settings?
Prompt 3
Show me how to chain the race, car purchase, and skill modules in fh6auto into a single automated pipeline that restarts from the beginning after each full cycle.
Prompt 4
fh6auto sometimes loses track of the game state when the game crashes. How does the auto-restart feature detect this and resume the script?
Open on GitHub → Explain another repo

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

Verify against the repo before relying on details.