gt4-staticrecomp README

项目的 README,来自 github.com/moesuito/gt4-staticrecomp。合并为一个 markdown 文件:README.md。

GT4Recomp

Gran Turismo 4, recompiled to run natively on PC.
No JIT, no emulator window, full speed.

60 FPS Windows MIT Release Beta Ko-fi Discord

Code GS


Gran Turismo 4 night race at high resolution, 60 FPS

GT4Recomp is a static recompilation of Gran Turismo 4 (NTSC-U, SCUS-97328) for Windows x86-64. The game's own code is translated ahead of time into C++ and compiled to native machine code; the PS2 hardware it talks to is reproduced in software, and graphics run on Vulkan. Nothing generates code while the game runs.

[!IMPORTANT] You need your own original copy of the game. GT4Recomp does not include or distribute Gran Turismo 4. We only distribute the launcher and the natively recompiled system that runs the game. To play, make a disc image of your own Gran Turismo 4 (USA, v2.00, SCUS-97328) disc as a plain .iso, and for the mod, your own Spec II 1.10 image.

Highlights

Where we are

Channel Version Renderer
Stable 1.2.5 GSdx The latest final release
Beta 1.3.0-rc14 CoreGS 2.0 (default) · GSdx Release candidate: Spec II, CoreGS 2.0, new launcher

Choose the channel in the launcher (Settings > General > Channel). Every piece of work is a numbered task in TASKS.md, tested in game before it is released.

Known issues

Roadmap

Phase Release Platform Renderer Status
1 1.0.0 - 1.2.5 Windows PC GSdx (PCSX2 GS, separate process) Done
2 1.3.0 - 2.0.0 Windows PC CoreGS 2.0 (our own) as the default · GSdx as the fallback In progress (1.3.0 beta)
3 after 2.0.0 Linux (native) CoreGS 2.0 Planned
4 after 2.0.0 Android CoreGS 2.0 (Vulkan) Planned

How it works

The EE game code is translated ahead of time into C++ and compiled for x86-64. The VU1 microcode, stored encrypted inside the executable, is recovered and compiled offline and verified against a reference interpreter; the VU0 microprograms are compiled the same way. IOP system services are native, and frames are paced by one high-resolution clock. This is a hybrid recompilation: PS2 hardware is still modelled in software, so we do not claim zero emulation or full PS2 fidelity. Details: Architecture.

Requirements

The launcher checks the processor and the graphics card before setup and before Play, and says what is missing.

Install

  1. Download the installer (GT4Recomp-Setup-<version>.exe) or the portable zip from Releases: the latest release for Stable, or the newest pre-release for Beta.
  2. Start GT4Recomp and choose your disc image. The launcher checks it, prepares the game and its shaders.
  3. Press Play.

Updates install from the launcher. Your settings, saves and replays are kept per Windows user in %APPDATA%\GT4Recomp (the portable build keeps them in its own folder). Building from source needs your own game files and a development environment: see the Build guide.

Controls

Controllers work out of the box with the DualShock 2 layout (analog triggers with pressure for throttle and brake) and can be remapped in the launcher (Settings > Controls). The keyboard has a fixed layout:

Key Action (PS2 button)
W · Enter Accelerate, confirm (Cross)
S Brake (Square)
Space Handbrake (Circle)
A · D · arrow keys Steer, navigate (D-pad)
Backspace · Esc Back (Triangle)
Shift Nitro (R1)
R · F Gear up · gear down (R2 · L2)
Q Look back (L1)
C · Tab Camera (Select)
P Start / Pause
Alt+Enter, F11 Borderless fullscreen

Support and contributing

Credits

Contributors on GitHub: Wise (gustavocanepa), the author of gt4-decomp, for the game's function names and a check on GS settings; Julio Vitor Rufino (JulioHeroZ), for racing wheel support, RetroAchievements and the renderer choice kept on updates; Luan Antony (luanantony), for the racing wheel integration, DualSense trigger curves and many fixes and studies. Thank you!

Project Author What it gives this project
gt4-staticrecomp, the original project Kaezzey (Niket Shah) Where GT4Recomp started: this repository is a fork of his project.
ps2-web-recomp (MIT) snuri00 The runtime foundation: EE-to-C++ translator, PS2 hardware models and the original VU1 compiler.
gt4-decomp (MIT) gustavocanepa GT4's decompilation: function names, class layouts and engine notes (identity).
Nenkai's GT research Nenkai File formats and the VU1 microcode encryption scheme (details).
GT4FS Razer2015 GT4 volume file-system research.
Gran Turismo 4 Spec II TheAdmiester and contributors The Spec II mod (the second game). GT4Recomp ships none of its files.
PCSX2 (GPL-3.0) PCSX2 team Decades of PS2 knowledge; its GS runs only in the separate gt4-gs.exe.
naga · Vulkan-Headers gfx-rs · Khronos Shader compilation at build time · Vulkan API headers.

Gran Turismo 4 Spec II by TheAdmiester and contributors, with credits to Nenkai, ddm, ermaccer, zinklesmesh, pez2k, xfileFIN, Silentwarrior112, Xenn and Submaniac, Silent, Alconautica, hydnhntr, JeyM and pioneerspine; special thanks to DustinEden and the testers and translators listed on the mod's credits page.

Exact revisions and licenses: THIRD_PARTY.md.

Documentation

TASKS · CONTRIBUTING · STATUS · BUILD · ARCHITECTURE · Renderers · Decisions · Journal

Star history

Star history chart of moesuito/gt4-staticrecomp

gt4-staticrecomp (moesuito/gt4-staticrecomp)

正在搜索数据库…

这是什么?GT4Recomp 是对《GT赛车4》(NTSC-U,SCUS-97328)的静态重编译版本,让这款 PS2 赛车游戏通过 Vulkan 在 Windows 上原生运行,无需 JIT,也没有模拟器窗口。
这是模拟器还是别的什么?它不是通用模拟器:PS2 游戏代码(EE CPU、VU1 和 VU0 微程序)会被提前翻译成 C++ 并编译为原生机器码,PS2 硬件则通过软件复现,画面通过 Vulkan 渲染。
我该怎么让它运行起来?从 Releases 下载 GT4Recomp-Setup-1.2.3.exe,运行安装程序,然后从开始菜单启动《GT赛车4》,并让启动器指向你自己的光盘镜像。
除了安装程序,我还需要什么?你需要 64 位 Windows 10/11、支持 SSE4.1 的 CPU、支持 Vulkan 1.2 驱动的显卡,以及你自己合法拥有的《GT赛车4》美版 v2.00(SCUS-97328)光盘镜像,格式为普通的 .iso 文件。
安装前有什么需要注意的吗?目前还不支持赛车方向盘,长时间游玩也尚未经过充分验证;部分驾照考试背景无法渲染(与 PCSX2 的默认行为一致);安装程序没有代码签名,首次运行时 Windows SmartScreen 可能会发出警告。
这个会支持 Linux 或手机吗?目前仅支持 Windows;原生 Linux 和 Android 版本计划在项目自研渲染器 CoreGS 2.0 发布后推出。
授权条款简单吗?GT4Recomp 自身的代码采用 MIT 许可证,但捆绑的 GSdx 渲染器采用 GPL-3.0-or-later 许可证,并运行在独立进程(gt4-gs.exe)中,其源代码会随每个版本单独发布,因此主程序不受其约束。
需要特定的显卡吗?需要支持 Vulkan 1.2 的 NVIDIA、AMD 或 Intel 显卡;目前的测试大多在 AMD 显卡上完成,因此 NVIDIA 和 Intel 的测试覆盖较少。
它是如何锁定 60 FPS 的?通过提前预编译 VU1 和 VU0 微代码(而不是逐条解释执行)、异步提交 GPU 任务,并用单个高精度时钟为每一帧计时。
我能使用 PCSX2 的高清材质包吗?可以,自定义材质包可以直接放入安装目录下的 data/Textures 文件夹,现有的 PCSX2 社区材质模组无需重命名文件夹即可使用。
它支持超宽屏显示器吗?从 1.1.0 版本开始,支持原生超宽屏及任意宽高比:3D 画面会按 Hor+/Vert+ 方式加宽,HUD 保持居中 16:9,菜单则以两侧加黑边的方式显示。
原始游戏代码和格式是从哪里来的?它基于 ps2-web-recomp 运行时、用于函数和类标识的 gt4-decomp 项目,以及 Nenkai 对 GT 文件格式和 VU1 微代码加密的研究。
作者
moesuito
大小
40 MB
星标
596
时长
1个月
提交 · 90 天