Forza Styled Speedometer by RexMods

========================================


This mod adds a Forza Horizon 5 style speedometer into your game.

When you get into a vehicle, the needle sweeps up and down once like turning on the ignition. After the sweep is completed, press Z to start the engine. The needle moves with RPM, wobbles at redline. 
The speed shows up as three digits just like in forza. ABS, TCR and Launch Control icons blink when they are active.

Driving Aids:

- ABS (Assisted Braking System) helps you stop faster. Slim mode = moderate stop, Aggressive = faster stop.

- Launch Control stops the wheels from spinning when you floor it from a dead stop.

- Traction Control cuts power and prevents wheelspin during hard acceleration until your tires regain grip with the road.

Both LC and TCR have two modes: Sport and Aggressive.

- The manual reverse mode turns off the game's default reverse feature when you hit the 's' key or the down arrow (you can turn this off in the menu)
 and if this is enabled, you can toggle into reverse mode by pressing the 'L' key.

Press F11 to open the settings menu. You can move and resize most part of the speedometer and adjust the wobble strength.

There is also a log file at scripts\FFSlog.txt that generates when the mod starts up which records the script startup, key presses and any crashes (helps with troubleshooting).

========================================
CHANGELOG v1.1
========================================

- Added support to change between KM/H and MPH modes.
- Improved font for gear position indicator and gauge dials.
- Better Redline Wobble: Needle vibrates like a real fuel cut limiter when you hit max RPM.
- Class Based Sweep Speeds: Supercars sweep faster, normal cars take medium and heavy trucks slower.
- Two Needle Motor Modes: "PMDC" makes the needle fall slowly (old school feel). "Stepper" tracks RPM more precisely.
- Smooth Engine Off Glide: The needle now slides gently back to zero instead of jumping.
- Burnout Mode: Hold accelerate + brake at very low speed – all assists are disabled temporarily so you can spin the tires freely.
- Refined TCS & Launch Control: Sport mode allows light wheelspin for an aggressive feel. Aggressive mode gives maximum grip.
- Manual Engine Trigger: If you use other realism mods that handle ignition, you can turn off manual start option.
- Cleaner Menu & Logging: Menu labels are now simpler.

========================================
LIMITATIONS
========================================

- The font looks similar but wont look as identical to the original ones. 

========================================
INSTALLATION (New Users)
========================================

Step 1 – Install required tools:
   - Script Hook V
   - Script Hook V .NET
   - LemonUI (put LemonUI.SHVDN3.dll in your "scripts" folder)

Step 2 – Copy the mod files:
   - Place FSS.dll and FSS.ini into your "scripts" folder.

Step 3 – Install the texture pack (OpenIV required):
   - Open OpenIV and navigate to:
       mods\update\update.rpf\x64\data\cdimages\scaleform_generic.rpf\
   - Drag and drop the new ForzaSpeedometerFH5.ytd into this folder.
   - (If the file already exists, replace it.)

Step 4 – Launch the game and press F11 to open the menu.

========================================
UPDATING FROM v1.0
========================================

If you already have v1.0 installed, follow these steps carefully.
(Skip this section if this is your first time installing the mod.)

1. Delete the old script files:
   - Go to your "scripts" folder.
   - Delete FSS.dll and FSS.ini completely (do not just overwrite).

2. Add the new script files:
   - Copy the new FSS.dll and FSS.ini from this download into the "scripts" folder.

3. Replace the texture pack (IMPORTANT):
   - The old .ytd file does not contain the new overlays or updated fonts.
   - Open OpenIV, go to:
       mods\update\update.rpf\x64\data\cdimages\scaleform_generic.rpf\
   - Right‑click on ForzaSpeedometerFH5.ytd and choose "Replace".
   - Select the new ForzaSpeedometerFH5.ytd from this download.

4. Check that the update worked:
   - Inside OpenIV, double‑click the replaced .ytd file.
   - Look for "fh5_kmh" and "fh5_mph" textures.
   - If you see them, the update is successful. If not, repeat step 3.

Once done, launch the game. The speedometer will now use the improved
physics, new fonts, and MPH/KMH toggle textures.

========================================
DEFAULT CONTROLS (can be changed in FSS.ini)
========================================

F11       – Open settings menu
Z         – Start / stop engine
Numpad1   – Toggle Launch Control
Numpad2   – Toggle Traction Control
Numpad3   – Toggle ABS
L         – Toggle reverse mode (if manual reverse is enabled)
========================================
CREDITS
========================================

Created by Rex Mods (code , textures, logging system)

Special thanks to:
- JulioNIB
- justalemon (LemonUI)
- Alexander Blade (Script Hook V)
- ScriptHookVDotNet team

Font License: The Secuela font used on the gauge dials and gear position indicators are licensed under the SIL Open Font License (OFL).

========================================
SUPPORT
========================================

If something crashes, check scripts\FFSlog.txt for details.
Incase of any bugs please report it in the mod page comments.

Please respect the time and effort put into this project by not re uploading this mod to other websites or including it in public mod packs without asking first. You are completely free to use this mod, but please do not distribute altered versions of the mod or claim the work as your own. If you want to share this mod with others, please link them directly to the original download page.