FPSUnlocked (Partial XIIHook Port)

# FPSUnlocked 0. 9. 9. 3

This is a compatibility-focused rebuild of XIIHook/FPSUnlocker for

`FFXII_TZA.exe` version 1. 0. 4. 0 Steam. It adds FPS-aware adaptive timing so

gameplay, cached animation rates, mouse input, and controller input remain

properly paced when the gameplay FPS target changes.

Legacy free-camera, FOV, and gamma features from XIIHook/FPSUnlocker are not

part of this build.

## Features

### FPS and game timing

- Configurable gameplay frame rate through `Gameplay_Framerate`.

- Native 60 FPS timing is restored automatically for cinematics, movies,

front-end sequences, and other non-gameplay transitions that require it.

- Unfocused gameplay is limited separately to reduce unnecessary load.

### Mouse input

- XIIHook-compatible adaptive mouse coefficient scaling.

- Optional locked base mouse multiplier.

- FPS-synchronized coefficient publication.

- Raw relative mouse input through Windows `WM_INPUT`.

- Independent X/Y sensitivity.

- Optional velocity-based acceleration.

- Configurable acceleration power, reference speed, and maximum gain.

- Optional time-based smoothing.

- Optional maximum-delta clamp.

- Independent X/Y inversion.

- Automatic fallback to native DirectInput motion if raw input cannot be

installed safely.

The default configuration enables adaptive scaling, the locked multiplier, and

raw mouse input. Acceleration, smoothing, clamping, and inversion remain

disabled by default.

### Controller input

- XInput processing for Steam 1. 0. 4. 0.

- Packet interpolation with synthetic packet numbers, preventing the game from

skipping intermediate filtered stick states when the native XInput packet

number has not changed.

- Independent radial deadzones for the left and right sticks.

- Independent anti-deadzones.

- Independent response curves.

- Per-axis sensitivity for both sticks.

- Optional time-based smoothing for each stick.

- Optional outer-stick acceleration.

- Configurable acceleration power and maximum gain.

- Trigger deadzone.

- Per-axis inversion for both sticks.

- Input filtering advances once per native game frame and reuses the same result

if the game polls XInput repeatedly during that frame.

- Native buttons, triggers, connection state, and vibration behavior remain

Controller processing and packet interpolation are enabled by default. The

default deadzones, curves, sensitivity, smoothing, acceleration, and inversion

values are neutral.

FF12 can also select a DirectInput controller backend. FPSUnlocked's controller

transformation is applied at the XInput boundary; the DirectInput controller

path remains native.

### Logging and input telemetry

- Optional runtime and timing diagnostics.

- Optional native-versus-modified mouse and controller value telemetry.

- Reports active controller backend polling when telemetry is enabled.

- Reports limiter transitions, simulation coefficients, cached animation

coefficients, animation corrections, input packets, and filter results.

- Log output is written to `FPSUnlocked.log` beside `FPSUnlocked.dll`.

Logging is disabled by default.

## Installation

Copy `FPSUnlocked.dll` into the FF12 External File Loader mod's `modules`

folder. FF12 External File Loader must already be installed. The FF12 EFL mod

is available from Nexus Mods.

OR

Use Nexus Mods Vortex to install the mod automatically.

On the first launch, FPSUnlocked creates:

modules\

├── FPSUnlocked.dll

└── config\

└── FPSUnlocked.ini

Configuration changes are read at startup. Restart the game after changing the

Original XIIHook/FPS Unlocker work by Drahsid and ffgriever.

Ported XIIHook/FPS Unlocker to the Steam 1. 0. 4. 0 executable and added the new

timing, animation, input, diagnostics, and compatibility

work by Zeneric.