pinyon-shift README

The project's README from github.com/arcanite24/pinyon-shift. As one markdown file: README.md.

Pinyon Shift

Pinyon Shift is a Windows-only playable preview of a native recompilation of the Xbox 360 release of Forza Horizon. The project is early, imperfect, and surprisingly drivable.

This repository contains the launcher, build tools, host code, configuration, and patches needed to create the preview on your own computer. It does not contain the game, game assets, generated translations, or a prebuilt game executable.

Play

  1. Download PinyonShift-Launcher.zip from the latest release.
  2. Extract the two files to a folder and run PinyonShift.Launcher.exe.
  3. Select an ISO you personally dumped from a supported original disc.
  4. Confirm ownership, then choose Verify & Build.
  5. Leave the launcher open while it installs the Windows build tools and builds the preview. The first build can take 20–60 minutes and requires roughly 25 GB of free disk space.

The preview launcher is not code-signed yet, so Windows may identify it as an unrecognized app. Use only the archive attached to this repository's release and verify its published SHA-256.

The launcher verifies the image before reading it. Unsupported or modified images are rejected. Your image and extracted game files stay on your machine. The launcher downloads build tools and the pinned ReXGlue source, extracts the disc locally, generates the translation locally, and compiles the executable locally. Administrator permission is requested only if Visual Studio Build Tools must be installed.

Supported today: the USA retail base disc, serial MS-2505, title ID 4D5309C9. Windows 10/11 x64 and a DirectX 12-capable GPU are required.

This is a public preview, not a finished remaster. Please report reproducible problems using the issue template and do not attach game files or generated code.

Reporting crashes and bugs

Keep the launcher open while playing. If the game exits unexpectedly, the launcher catches the exit, creates a sanitized diagnostic ZIP, and offers one button to open a prefilled GitHub issue with that ZIP selected in Explorer. Attach the selected ZIP and add the shortest reliable reproduction steps.

The public report includes build hashes, a stable crash ID, exception details, the end of the runtime log, runtime settings, Windows build, CPU, GPU, and driver versions. It excludes the game, saves, generated code, input capture, local paths, and memory dumps. A fuller dump stays on the player's computer and should only be shared privately if a maintainer requests it. Non-crash bugs can be reported with Report a problem in the launcher.

Build from source

From a PowerShell terminal in a repository checkout:

.\tools\setup-preview.ps1 -IsoPath C:\path\to\your-disc.iso
.\tools\launch-preview.ps1

The setup script provisions pinned dependencies under .local/, downloads and patches ReXGlue, verifies/extracts the disc, generates translated source, and builds Release. See Building and Troubleshooting for details.

Project boundaries

Only independently authored project files are licensed under the BSD 3-Clause License. Microsoft, Xbox, Turn 10 Studios, Playground Games, Forza Horizon, and third-party dependencies remain the property of their respective owners. Pinyon Shift is not affiliated with or endorsed by them. See Legal and distribution and Third-party notices.

Contributing

Start with CONTRIBUTING.md. Repository checks reject disc images, executables, generated translations, extracted assets, build products, and other machine-local material.

Supporting the project

Pinyon Shift is and will remain free. If you would like to support its continued development, you can sponsor arcanite24 on GitHub. Sponsorship is entirely optional and does not provide builds, game content, support, or influence over the project roadmap.

pinyon-shift (arcanite24/pinyon-shift)

Searching Database…

723 ·GitHub
Pinyon-shift
这是什么？Pinyon Shift 是一个仅限 Windows 的可玩预览版，基于 Xbox 360 版 Forza Horizon 的原生静态重编译构建，让你可以用自己的光盘构建并运行一个可玩但不完美的游戏版本。
这里面包含游戏本体吗？不包含。仓库只包含启动器、构建工具、宿主代码、配置和补丁，供你自己构建预览版；它不提供游戏本体、资源文件、翻译或预构建的可执行文件。
怎么让它跑起来？从最新 release 下载 PinyonShift-Launcher.zip，解压并运行 PinyonShift.Launcher.exe，选择一个你亲自从受支持光盘转储的 ISO，确认拥有正版，然后选择 Verify & Build；首次构建需要 20-60 分钟，并需要约 25 GB 的可用磁盘空间。
开玩之前我需要准备什么？一张你亲自从受支持光盘转储的 ISO、Windows 10/11 x64，以及一块支持 DirectX 12 的 GPU；启动器会自行安装所需的 Windows 构建工具，只有当必须安装 Visual Studio Build Tools 时才会请求管理员权限。
任何 Forza Horizon 光盘都能用吗？不能——目前只支持美版零售基础光盘（序列号 MS-2505，title ID 4D5309C9），启动器尚未进行代码签名，Windows 可能会将其标记为无法识别的应用，而且这明确是一个公开预览版，而非完成的重制版。
我的光盘镜像或游戏数据会离开我的电脑吗？不会——启动器只下载构建工具和固定版本的 ReXGlue 源码；光盘提取、翻译生成和编译全部在本地完成，崩溃报告默认不包含游戏文件、存档和本地路径。
BSD-3-Clause 许可证实际覆盖哪些内容？只有独立编写的项目文件（启动器、构建工具、补丁）采用 BSD-3-Clause 许可；Forza Horizon、Xbox 及其他第三方资产仍归 Microsoft、Turn 10 和 Playground Games 所有，且不包含在内。
ReXGlue 是什么？ReXGlue 是固定版本的静态重编译源码，启动器会下载它，并在构建过程中用它把 Xbox 360 版 Forza Horizon 的可执行文件转换成本地代码。
我玩游戏时如果游戏崩溃了会怎样？启动器会捕获退出事件，生成一个经过脱敏处理的诊断 ZIP，并提供一键按钮打开预填好的 GitHub issue 并附上该 ZIP，公开报告中不包含游戏文件、存档和内存转储。
这个项目可以免费使用吗？可以，Pinyon Shift 现在和将来都免费；GitHub 赞助是可选的，不会解锁构建、游戏内容或任何特殊支持。
What are similar projects?The-Darkness-Recomp, Playnite, hells-gate-recomp, exodium, ShadowOfTheColossus-PC, Fable-2-Recomp, OpenCE, Wind-Waker-Recomp
Which topics is it in?launcher, decompiler, emulation, retrogaming, windows-10, windows-11, game, windows-app, gaming, reverse-engineering, bsd, cpp
Creator
arcanite24
Size
30.4 MB
Stars
723
Updated
CommitOct 17Releasev0.6.0Oct 17
Age
1mo
Commits · 90 Days