TGM Assistant

gerald gandeboeuf

Registered
rF2 TGM Assistant is a free desktop tool created as a gift for the rFactor 2 modding community.
Its goal is to make tyre development easier, clearer, and less intimidating.
The TGM system is one of the most powerful parts of rFactor 2, but also one of the hardest to understand.
This application helps modders work with TGM and TBC files through a visual interface.
Instead of editing complex physics values blindly, users can adjust human-readable sliders.
The app then translates those changes into technical tyre parameters.
It includes dynamic graphs to help visualize grip, temperature, pressure, wear, slip, and load behavior.
It also includes tools to compare generated values with the original file.
The application can load existing TGM and TBC files, preserve the original data, and export modified versions safely.
A local tyre library is included to help users start from the closest available tyre dimensions.
The software is designed to work locally, without cloud APIs or mandatory online services.
The installer also supports language selection and rFactor 2 ModDev path configuration.
This is a V1.0 release, so some mappings are still approximate and need real-world validation.
The objective is not to replace expert knowledge, but to make experimentation faster and more understandable.
Advanced users can still inspect the generated TGM and TBC content directly.
New users can learn step by step without being forced to edit every raw parameter manually.
Feedback from the community is very important for improving formulas, mappings, and usability.
If you find a bug, please send screenshots and explain exactly what you changed before the issue appeared.
If possible, include the original TGM/TBC files and the exported result so the problem can be reproduced.
This project is built to grow with the community and make tyre development more accessible to everyone.
1783108644618.png

1783108676524.png

1783108707702.png

1783108743362.png

 
Last edited:
Great, thanks

Just had a very quick play. I'm really impressed and can see this getting a lot of use!

The language setting is not respected throughout the tool (yet) - a lot of the notes/explanations remain in French. Pas de probleme, mais... ;oP
 
Last edited:
So I've been having a bit of a play today as I have some tyres that I need to tweak to reduce overheating...

I'm a bit confused because if I make various changes to the graphs etc., synchronise the TBC and TGM files, export them, close the tool, reopen...

...the graphs etc. show no changes...

Do you have to export each graph JSON and re-import it? Is the data not baked into the TBC/TGM combo?

Thanks once again.
 
If you modify a TBC or TGM value, go to the corresponding TBC or TGM page. The modified value will be displayed in green.
Then, click “Export TBC” or “Export TGM”, as appropriate.


If you have modified both TBC and TGM values, click the “Synchronize TBC with TGM” button. Then, export the TBC file from the TBC page and the TGM file from the TGM page.


P.S. Some sliders have not yet been calibrated for certain ranges. When a file is imported, these sliders default to the center position.
 
Are there any updates yet (e.g. calibrated sliders)? I've been using your tool for the last few weeks and would love to see the next iteration...
 
Thank you for the work on this so far. One question on the dimensions tab, where it seems like it must always load a preset instead of loading the dimensions and values from the TGM, and it thus impact the resulting tire in the export. Is there a way to not force presets to be applied on that tab and for it to display the actual loaded TGM's values? And if editing manually on the TGM/TBC tabs, the new values should be entered on the "Result" column, correct?
 
Thank you very much for this detailed and constructive feedback. It was very helpful and pointed out an important issue in the Dimensions tab.

You were right: the tool should display the actual values loaded from the TGM instead of falling back to preset values. This feedback helped improve the next update, so thanks again for taking the time to explain it clearly.


rF2 TGM Assistant V1.0.6

- Fixed problem: the Dimensions tab could load preset/default values instead of the actual values from the loaded TGM. The tool now reads the TGM values correctly
- Recommended update for users on V1.0.3.
- Improved slider ranges.
- Redesigned sliders for more precise tuning.
- Added separate - / + buttons for small adjustments.
- Numeric values are easier to read in the interface.
- Added dynamic color zones directly on the sliders.
- Green / yellow / orange / red zones help identify safe or sensitive settings.
- Color ranges adapt to the tyre usage family.
- Examples: formula, prototype, GT, road, rally, wet, etc.
- Better highlighting of tyre weak points.
- Extreme settings are more clearly flagged before export.
- Tooltips better explain each parameter and which files are modified.
- Added automatable tTool tests for the main checks.
- Static Load: fixed load and deformation measurement.
- Test Footprint: footprint geometry and pressure.
- Test Spring Rate: multiple loads and stiffness calculation.
- Test Rolling Radius: QSA, then Realtime check.
- Lateral Stiffness: lateral force and displacement.
- Longitudinal Stiffness: longitudinal force and displacement.
- Camber Test: SurfaceCamberDegrees series.
- Pressure Sweep: AirCavityAbsPressure series.
- Load Sweep: Load value series.
- Added automatic validation of generated curves after tTool auto-test.
- Report with pre-export score.
- Suspicious, fragile, or blocking curves are flagged.
- Versioned TGM export without overwriting the source TGM.
- Example: mytyre.tgm becomes mytyre.V0.1.tgm, then mytyre.V0.2.tgm.
- Automatic update of the TGM reference inside the TBC.
- Automatic TBC backup before modification.
- Popup after export to directly launch a ModDev test.
- Fixed ModDev launch through Steam with +modmode.
- Reduced freeze when loading TGM/TBC files.

link for first installation
 
@gerald gandeboeuf I didn't try the Tool, but from what i read, did you consider, to also load the Flex Chassis.ini into you Tool, to take into Account the Mass and Inertia of the Wheels?

The Problem is, that, if you e.g. want to change the Tires of an existing Mod, it can lead to Errors, that make the DevMode crash, caused by not matching Mass and Inertia between the Wheels in the Chassis.ini and the same Values in the*.tgm File.

In that Moment, when one of these Values of the *tgm is higher than the Values that are in the Chassis.ini, the Problem appears.
 
V1.0.8
added/modified:
HDV loading triggered at the initial popup for existing projects.
Automatic detection of Chassis.ini via the UltraChassis=... entry in the HDV.
Pre-filling of the Chassis.ini path in the tTool preparation window.
Saving of the chassis_path in the tTool configuration.
Inclusion of Chassis.ini in the tTool test plan report.
Chassis.ini check performed during TGM export.
Automatic comparison between TGM and chassis:
TotalMass, RingMass, TotalInertiaStandard, RingInertiaStandard.
Accounted for MassInertiaMultiplier if present in the TGM.
Detection of *_WHEEL bodies in the Chassis.ini.
Front/rear targeting based on the exported tire.
If chassis is OK: displays "Chassis.ini Check: OK".
If correction is required: displayed in the "Test Tire" popup.
No more silent modification of the original Chassis.ini.
If the user confirms, a versioned chassis file is created:
ChassisName.V1.01.ini, then V1.02, etc.
Correction applied only to this new versioned file.
Automatic HDV update:
UltraChassis="ChassisName.V1.01.ini".
Automatic HDV backup before modification.
ModDev launch occurs after chassis validation/correction.
Chassis status added to the export popup.
Chassis status added to the export report.
Tests added for chassis inspection (read-only).
Tests added for versioned correction (V1.01/V1.02).
Tests added for automatic UltraChassis update.
Tests added for TGM mass/inertia limit calculations.


 
Last edited:
This is craziest thing. I would love to test it properly so badly right now, what is this all about and where this could lead to. Must find time for this asap. Has anyone tested this app already ?
 
This is craziest thing. I would love to test it properly so badly right now, what is this all about and where this could lead to. Must find time for this asap. Has anyone tested this app already ?
Only in its original form - I'll test the latest updates with anticipation shortly!

My main stumbling block has been / was that the sliders etc. do/did (I'll drop the dual tense at this point!) not seem to read from the uploaded files - so if you tweaked something, tested it, needed to tweak further or revert - you had no idea where you were in relation to your last version. I ended up taking a workflow of always starting with my baseline tyre and then recording offline what changes I made. If I needed to change something, I started with the baseline tyre again (rather than the latest tweaked version) and just applied fresh changes based on my notes.

After a while, I had to take a break and go back to @redapg 's online tools as they at least showed what was currently baked into the files. I'm looking forward to see how @gerald gandeboeuf 's latest changes have moved things on though as it has the potential to tie so much together and help visualise the model. Thanks Gerald!
 
rF2 TGM Assistant V1.0.12

Fixed several issues related to loading and installation.
Improved update system security.
The embedded TGM library is no longer exposed as an easily accessible folder within the installation.
Fixed the update manifest to prevent application-side read errors.
Improved display of "raw" slider values.
Coefficients such as x0.01, x0.001, x1000, etc., are now displayed as their actual readable values.
Example: 707 x0.001 becomes 0.707.
Example: 550 x1000 becomes 550000.
Added a "+ Detail" button to sliders that modify both TGM and TBC files.
The detail view now allows for separate values for the TGM file and the TBC file.
If no specific value is set, the main slider value applies to both.
TGM and TBC exports automatically use the separate values when they exist.
Added tooltips to explain which file is modified by each slider.
Added translations for the new detail controls.
Improved export behavior after modifying a tire.
TGM/TBC references are better preserved during versioned exports.
TGM/TBC consistency checking is now clearer for the user.
Added unit tests to validate the new real values and separate TGM/TBC values.
Full pre-release validation: unit tests, application self-test, updater self-test, and setup verification.
Add markers to the sliders based on the original value and exports to track the history.
 
Last edited:
Back
Top