FFX FPS Unlock

An experimental Fahrenheit mod that lifts Final Fantasy X HD Remaster from its original 30 Hz presentation rate and adjusts frame-dependent systems.

Status

Work in progress / experimental preview. A successful build verifies compilation and packaging, not complete in-game compatibility. Final Fantasy X only; Final Fantasy X-2 is unsupported. Keep a backup of your saves and report the game build, scene and enabled settings when filing an issue.

Features

• Configurable presentation rate in Fahrenheit's settings panel.
• Timing corrections for script waits, camera transitions, fades, character motion, battle UI, particles and texture animation.
• Individual correction toggles and diagnostics for investigating timing regressions.
• In-process patches recorded by PatchJournal and restored on shutdown; original game files remain unchanged.

The default present interval targets approximately 59.94 Hz. Higher rates are experimental; compatibility across all scenes, battles and effects is not established. This is ongoing development, not a promise of uniformly correct high-framerate gameplay. The source contains experimental alternatives and diagnostics; consult FpsUnlockConfig before changing advanced settings.

No interpolated FMVs, extracted assets or replacement game files are included. Do not install another mod that hooks the same timing functions alongside this one.

Requirements

• Windows and a legitimate installation of Final Fantasy X HD Remaster.
• Fahrenheit, compatible with the revision pinned in fahrenheit.release.ref.
• The mod is a Windows x86 managed plugin, not a standalone executable. Fahrenheit provides its runtime and loader dependencies.

Installation

Every release carries two archives. fahrenheit-full-<version>.zip is the ready-to-play package: the Fahrenheit host built from the pinned revision, the mod, a loadorder naming it, and the launcher scripts. fhfpsunlock-mod-<version>.zip is the mod alone, for an existing Fahrenheit installation.

Full package:

1. Download the ZIP and its SHA-256 checksum from Releases.
2. Extract it into the game directory, next to FFX.exe. The resulting paths must be fahrenheit/bin/fhstage0.exe and fahrenheit/mods/fhfpsunlock/fhfpsunlock.dll.
3. Start the game through start-ffx-with-mods.cmd, which checks for the Microsoft .NET Runtime 10 (x86) and offers to install it. The bundled README.txt has the details.

Mod only:

1. Install Fahrenheit following its upstream instructions.
2. Extract the mod ZIP into the game's fahrenheit/ directory. The resulting path must be fahrenheit/mods/fhfpsunlock/fhfpsunlock.dll.
3. Add fhfpsunlock on its own line to fahrenheit/mods/loadorder.
4. Launch the game and adjust the mod's settings in Fahrenheit.

To uninstall, close the game, remove that loadorder entry and remove fahrenheit/mods/fhfpsunlock/, or remove the whole fahrenheit/ directory for the full package. Do not overwrite the game's executable or data archives.

Verify the ZIP with Get-FileHash <downloaded.zip> -Algorithm SHA256 and compare the value with the .sha256 file.

Build from source

Requires Git, PowerShell 7 and the .NET 10 SDK selected by global.json.

git clone https://github.com/Exoridus/ffx-fpsunlock-mod.git
cd ffx-fpsunlock-mod
pwsh tools/bootstrap.ps1
pwsh build.ps1 -Configuration Release -OutDir .release/stage

Bootstrap checks out the pinned public Fahrenheit source. No game installation or private sibling repository is required to compile. -Deploy is an optional local convenience with a machine-specific destination in build.ps1; use staged output for other installations.

The full package additionally needs the Fahrenheit host, whose native loaders require Visual Studio (or Build Tools) with the C++ workload and an integrated vcpkg:

pwsh tools/build-fahrenheit.ps1 -Configuration Release
pwsh .github/scripts/New-ReleasePackage.ps1 -Tag v<VERSION> -StageDir .release/stage -OutDir .release -FahrenheitDeployDir .workspace/fahrenheit/artifacts/deploy/rel

Releases and CI

CI builds on Windows, builds the Fahrenheit host from the pinned revision, and exercises the same package and release-note scripts used by releases. The mod ZIP contains only mods/fhfpsunlock/: the mod DLL, manifest, dependency metadata and localization files. The full ZIP adds Fahrenheit's bin/ as built from fahrenheit.release.ref, a loadorder, and the launcher scripts from packaging/. Game assets are never bundled.

Maintainers set the manifest version, merge to main, then dispatch:

gh workflow run release.yml -R Exoridus/ffx-fpsunlock-mod -f version=v<VERSION> -f dry_run=true

Omit dry_run to publish an experimental prerelease with a ZIP and SHA-256 file. The version must match the manifest; the workflow creates its tag only after building and packaging succeed.

Related projects

• Fahrenheit Parry Mod
• FFX Quality of Life
• FFX FPS Unlock