explaingit

tokyubevoxelverse/forzadesigner6

40Python

TLDR

This is a Windows desktop app that turns any picture into a vinyl group inside the racing games Forza Horizon 3, 4, 5, and 6.

Mindmap

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

In plain English

This is a Windows desktop app that turns any picture into a vinyl group inside the racing games Forza Horizon 3, 4, 5, and 6. A vinyl group is the in-game decal editor's collection of layered shapes, normally drawn one at a time by the player. Forza Designer 6, or FD6, approximates a source image with one or two thousand colored shapes, saves the result as JSON, then writes the shapes directly into the running game's memory so they show up in the editor. Installation is simple. The user downloads FD6.exe from the GitHub Releases page and runs it. There is no installer and no admin rights are needed; Windows SmartScreen has to be dismissed once. The README also lists a source-from-Python path using pip install -r requirements.txt for users who prefer Python 3.10 or newer. Usage has two phases. In Generate, the user picks a JPEG or PNG, chooses a profile such as balanced, sets a shape budget like 1500 or 3000, and clicks Start. A live preview rebuilds the picture out of shapes and the JSON is saved next to the source image. In Inject, the user opens the game's vinyl group editor, loads a sphere template with at least as many spheres as the JSON has shapes, picks the game in the FD6 Target dropdown, clicks Upload JSON, then Inject. The dialog turns green when finished. The README warns not to click anything in either app during injection, since the game can reallocate memory mid-write and break the operation. Under the hood, FD6 finds the in-memory Livery Group structure either by fingerprinting a fresh template or, as a fallback for re-injection, by scanning the Microsoft compiler's RTTI type information for the class name. The credits section lists earlier projects FD6 builds on, including forza-painter, geometrize-lib, Primitive, and bvzrays's forza-painter-fh6 research, which supplied struct offsets and confirmed that FH5 and FH6 share a layout. The disclaimer is unusually long. Because FD6 modifies the memory of a running Forza process, Microsoft or the publisher Turn 10 and Playground Games could consider it a breach of the Microsoft Services Agreement or the game's terms, with a possible Xbox or Microsoft account suspension or ban. The author accepts no responsibility. The license is MIT.

Open on GitHub → Explain another repo

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