explaingit

bvzrays/forza-painter-fh6

106Python

TLDR

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.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

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.

Open on GitHub → Explain another repo

Generated 2026-05-21 · Model: sonnet-4-6 · Verify against the repo before relying on details.