explaingit

bvzrays/forza-painter-fh6

Analysis updated 2026-06-24

106PythonAudience · generalComplexity · 3/5Setup · moderate

TLDR

Windows desktop tool that converts a PNG or JPG into stacked vinyl shape layers for Forza Horizon 6, then imports the layout into the running game via memory write.

Mindmap

mindmap
  root((forza-painter-fh6))
    Inputs
      Source image
      Quality preset
      Game process
    Outputs
      Shape layer JSON
      Imported vinyl group
      Log export
    Use Cases
      Recreate photos
      Custom car liveries
      Logo painting
    Tech Stack
      Python
      GPU
      Windows
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

What do people build with it?

USE CASE 1

Turn a photo or logo into a vinyl design and paint it onto a car in Forza Horizon 6.

USE CASE 2

Pick a quality preset that trades render time against shape fidelity for large or detailed images.

USE CASE 3

Export a detailed log when the import step fails so the in-game layer table can be diagnosed.

USE CASE 4

Use the bundled GPU-based generator instead of stacking sphere layers by hand in the Vinyl Group Editor.

What is it built with?

PythonWindowsGPU

How does it compare?

bvzrays/forza-painter-fh6luoyue789/sm4_detectionrulyone/simple-react-agent
Stars106104103
LanguagePythonPythonPython
Setup difficultymoderatehardeasy
Complexity3/55/52/5
Audiencegeneralresearcherdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs 64-bit Python 3.12 on Windows and a running copy of Forza Horizon 6 with a sphere-layer template loaded.

In plain English

This is a Windows desktop tool that turns a regular image, like a PNG or JPG, into a vinyl design that can be brought into the racing game Forza Horizon 6. In Forza Horizon 6, players can paint custom designs onto their cars by stacking many small shape layers in a built-in editor called the Vinyl Group Editor. Recreating a real picture by hand inside that editor is very tedious, so this app does the heavy work for you. The project is a fork tied to Forza Horizon 6 specifically, based on an earlier forza-painter project. It includes a graphical app with three main pages: one for generating the design data from your image using a bundled GPU-based generator, one for previewing the source image and the generated shape geometry, and one for importing that data into a running copy of the game. The usual flow is to download the repository as a ZIP, install 64-bit Python (3.12 is recommended), then run two batch files: one to install Python dependencies, and one to start the app. Inside the app you pick your images, choose a quality preset that ranges from very fast to very slow, and generate JSON files containing the shape layers. Higher random sample counts, especially above 200000, give a clearer result but take much longer. For the import step, you open the Vinyl Group Editor in Forza Horizon 6, load a template made of many simple sphere layers, ungroup it, and note the exact layer count. In the app, you select the running game process, enter that layer count, pick the generated JSON, and click Import. The tool locates the in-game layer table and verifies it before writing anything, and it refuses to write if it cannot confirm the target safely. The project supports English, Chinese, and Korean readmes, and the recent v1.4.1 release improved automatic locating of the template in memory and added a detailed log export to help with troubleshooting.

Copy-paste prompts

Prompt 1
Walk me through installing forza-painter-fh6 on Windows with Python 3.12 and painting a 256-layer logo onto a car.
Prompt 2
Explain how the import step locates the in-game layer table and what safety check prevents a bad write.
Prompt 3
Compare the very fast and very slow quality presets. When does a sample count above 200000 actually help?
Prompt 4
Help me extend the generator to write a PNG preview of the layered output before importing into the game.
Prompt 5
Translate the Chinese readme section about the v1.4.1 release notes into English and summarize the two improvements.

Frequently asked questions

What is forza-painter-fh6?

Windows desktop tool that converts a PNG or JPG into stacked vinyl shape layers for Forza Horizon 6, then imports the layout into the running game via memory write.

What language is forza-painter-fh6 written in?

Mainly Python. The stack also includes Python, Windows, GPU.

How hard is forza-painter-fh6 to set up?

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

Who is forza-painter-fh6 for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.