Zuhu’s FH5 Reward Runner

A high-performance automation utility for Forza Horizon 5 designed to automate the tedious process of spinning Wheelspins and Super Wheelspins. Using OCR (Optical Character Recognition), the script identifies rewards, automatically decides whether to keep rare Forza Edition cars or sell duplicates, and tracks your total session earnings via a sleek, transparent overlay.

---

Getting Started

Note

Easiest Method: Download the Executable (.exe)

This is the recommended way for most users and does not require a Python installation.

1. Go to the Releases Page.
2. Download the latest .exe file from the Assets section.
3. Important: You must have Tesseract OCR installed at C:\Program Files\Tesseract-OCR\tesseract.exe for the script to read the screen.
4. Run the downloaded file and follow the on-screen instructions!

➡️ Go to the Releases Page to Download

---

For Developers: Running from Source

Click here for instructions on running from the Python source code

Prerequisites

• Python 3.8+
• Tesseract OCR installed at C:\Program Files\Tesseract-OCR\tesseract.exe.
• Forza Horizon 5 running in Windowed or Borderless mode.

Installation Steps

1. Clone the repository:

   git clone https://github.com/ZuhuInc/Zuhu-FH5-Reward-Runner
   cd Zuhu-FH5-Reward-Runner

2. Install dependencies:

   pip install pydirectinput pytesseract keyboard mss Pillow

3. Run the Script:

   python Reward-Runner.py

---

Feature Showcase

The script uses a transparent overlay that sits on top of your game, providing real-time data and status updates.

Step / Mode	Description	Preview
1. Standby Mode	Press [INSERT] to Start Launch the script and enter the Wheelspin menu in-game. The overlay will show "Press INSERT to Start" so the bot doesn't click prematurely.
2. Normal Wheelspin	Automated Single Spins The script detects the reward reel, identifies the prize value, and automatically handles the "Owned Car" screen to maximize your profit.
3. Super Wheelspin	Triple Reel Detection Optimized for Super Wheelspins. It scans all three reels simultaneously, tracks the total credit gain, and manages the "Keep/Sell" logic for all rewards.

---

Configuration & Customization

The script creates a local configuration file where you can define your "Keep vs Sell" logic. This allows you to automatically keep cars worth over a certain amount or specifically target Forza Edition (FE) cars.

Config Path:
Documents\ZuhuProjects\ZuhuFH5WS\Config.json

Example Config.json:

{
    "Keep_FE": true,
    "Keep_HV": false,
    "Value_HV": 1000000,
    "Car_Earned": true,
    "Credit_Earned": true,
    "Reel_Scan_Delay": 1.3,
    "Debug_Mode": false
    "Use_Overlay": true
}

---

Script Controls

• [INSERT]: Toggle Start/Pause (The main control).
• [~] (Tilde): Hold for 5 seconds to toggle Debug Mode (Visualizes detection boxes).
• [CTRL + C]: Safe exit the script.

---

Libraries Used

• External: pydirectinput, pytesseract, keyboard, mss, Pillow
• Standard: os, sys, json, tkinter, threading, time

---

✨ Maintainers

This project is created and maintained by:

• ZuhuInc

---

License

This project is licensed under the MIT License - see the LICENSE file for details.