App R3E Toolbox

R3E Toolbox - Comprehensive Race Management Suite for RaceRoom

Hello RaceRoom community!

I'm excited to share a project I've been working on: R3E Toolbox - a complete suite of tools designed to enhance your RaceRoom Racing Experience.

What is R3E Toolbox?

R3E Toolbox is a free, open-source desktop application (also available as a web app) that brings together multiple utilities to help you manage AI difficulty, fix race results, and create professional championship standings.

⬇️ Download the latest version here (Windows installer + portable version)

Or try the web version (works on any platform: Windows, macOS, Linux)

Key Features

1. AI Management

Based on the excellent work from pixeljetstream's r3e-adaptive-ai-primer, this tool helps you:

• Analyze your aiadaptation.xml file
• Use linear regression to predict lap times for unmeasured AI difficulty levels
• Validate fit quality and detect outliers
• Generate optimized AI settings for all your track/class combinations
• Remove synthetic data and re-fit with real race data
• Remove your own player lap times

Perfect for league organizers or anyone who wants consistent AI competition across different tracks and classes.

2. Fix Qualy Times ⏱️

RaceRoom sometimes saves race results with missing qualification times. This tool:

• Reads your qualification session file
• Matches drivers between quali and race sessions
• Patches the race results with correct qualification lap times
• Generates a corrected file ready for your records

3. Build Results Database

Inspired by pixeljetstream's r3e-open-championship, this feature:

• Analyzes multiple race result files from a folder
• Supports both standard race result files and dedicated server event files (JSON exported by RaceRoom servers) — import several at once in a single pick
• Calculates championship standings with points, wins, podiums
• Generates beautiful HTML reports with official RaceRoom car and track icons
• Caches assets for offline use
• Creates standalone HTML files you can share with your league

4. Results Database Viewer

• Browse all your saved championships
• Search and filter by car, track, or championship name
• View detailed driver, team, and vehicle standings
• Set a custom points system (F1/DTM presets) and apply time or points penalties per driver
• Export HTML reports or JSON data

5. Settings & Configuration ⚙️

• Customize fitting parameters
• Configure validation thresholds
• Manage game data files
• Clear cached assets when needed

Technical Highlights

• Cross-platform: Desktop app (Electron) or web browser
• Modern tech stack: React + TypeScript with a clean, responsive UI
• Local storage: All data stays on your machine (electron-store for desktop, localStorage for web)
• No backend required: Completely self-contained application
• Auto-updates: The desktop app checks for new releases automatically and updates in one click
• Persistent logging: Detailed logs saved to disk via electron-log for easy troubleshooting
• Open source: MIT License - contributions welcome!

Credits

This project builds upon the fantastic work of pixeljetstream:

• AI fitting algorithms from r3e-adaptive-ai-primer
• Championship standings logic from r3e-open-championship

The toolbox consolidates these tools into a single, user-friendly interface with additional features and enhancements.

Getting Started

1. Download the Windows installer or use the web version
2. Load your r3e-data.json file (the app can auto-detect it from your RaceRoom installation)
3. Choose your tool from the sidebar and start processing your race data!

Full documentation and user guide are built into the app (Help section) and also available in the GitHub repository.

What's Next?

I keep improving this tool in my spare time and would love to hear your feedback. Whether you're:

• A league organizer managing championships
• A solo racer fine-tuning AI competition
• A data enthusiast tracking your stats

I'd be grateful for any suggestions, bug reports, or feature requests.

☕ Support the Project

If this tool saves you time and enhances your RaceRoom experience, consider supporting it as a thank-you:

Buy me a coffee on Ko-fi ☕

Links

• GitHub Repository: https://github.com/deggesim/r3e-toolbox
• Support on Ko-fi: https://ko-fi.com/C1C11UJY38
• Download Latest Release: https://github.com/deggesim/r3e-toolbox/releases/latest
• Web Version: https://r3e-toolbox.up.railway.app
• User Guide: Built into the app (also in the GitHub repository)

Version History

Currently at v1.8.0. Key milestones since the initial release:

v1.8.0 — Results Database: import several dedicated-server event files at once, set a custom championship points system (F1/DTM presets), and apply time or points penalties per driver
v1.7.0 — Server event file import in Results Database (supports JSON files exported by RaceRoom dedicated servers)
v1.6.2 — Internal migration to electron-vite with full TypeScript and shared IPC contracts for improved stability
v1.6.1 — Built-in user guide (Help section integrated directly in the app)
v1.6.0 — Performance optimizations (React Compiler + useMemo), improved AI fitting accuracy
v1.5.0 — Comprehensive logging system with electron-log (persistent log files on disk)
v1.4.0 — Automatic updates via electron-updater, enhanced logging configuration
v1.3.x — Floating processing logs, application menu, human player detection fix in standings
v1.0.0 — First stable release with all core features

---

Feel free to try it out and let me know what you think! Questions, suggestions, and contributions are always welcome.

Happy racing!

Simone De Gennaro

 

Sounds great! It's really cool that people create things like that for this game.

 

Thanks a lot for this app

 

How can i try the web version?

 

Here -> https://r3e-toolbox.up.railway.app/

 

I try that, but when i download a json files i can't go further

 

Your user guide link is dead but this forum wont let me even show you a scrreenshot of the link I mean.
I am looking for a way to set the adaptive ai to about 100% across the whole grid without me have to race every track and car.

 

I have to fix initial post.
Anyway the guide now is a page of the app: https://r3e-toolbox.up.railway.app/#/help

 

Do you mean download of r3e-championships-json file?

 

Ah thanks, after looking and trying I dont think it can do what I want it to do. I am finding every race I try the adaptive ai is too slow and rather than just setting to the AI 100% and then having to change that as I progress, I wanted to set the adpative AI at 100% as a starting point on all cars and tracks.

 

I uploade the wrong file.

But another question.
When i'm on https://r3e-toolbox.up.railway.app/#/build-results-database en uploaded some .json files off race results, i can't go to step 3

 

Hello
Just a quick question.
I’m currently testing on the Salzburgring with the F4.
I’ve done three short solo races of six laps each, but I haven’t got any AI level data.
My lap times are being recorded properly, though.
The other tests I’ve done start working after about 12 laps.
Is that normal?
Thanks

 

Can you please upload your txt/json file so I can test locally?
If the file isn't recognized as a race file, you can't proceed to step 3.

 

When I testd AI adaptation I noticed two laps were enough to feed the file.
Of course more laps, more accuracy in the process.
It's strange you don't have data in your aiadaptation.xml file.
Are your laps valid in the race?
Try also another combination of car/circuit/layout and let me know.

 

Sorry, my English isn't great lol
It works on all the other combos I’ve tested; I can clearly see my lap times recorded in your app.
But the AI level (the right-hand column in your app) only shows values once you’ve completed about 10 laps.
In this case, it took me 24 full laps for that column to fill up with the F4+Salzburgring combo

 

@deggesim
json file can't be downloaded here on the forum.
I made it to an txt file

 

Why the file you downloaded doesn't work with r3e-toolbox

The file you downloaded (202604170943.txt)
This is the official RaceRoom online leaderboard format. It contains all sessions (Practice, Qualifying, Race) with aggregated data from all drivers. It's designed to display global rankings.

What the r3e-toolbox tool expects
Files like Race1.txt or Race2.txt - these are exports of a single race from the RaceRoom client. They contain complete details: lap times for every lap, qualifying data, full driver information for that race.

The main differences

• The leaderboard is organized by sessions, the tool wants one single race
  
• The leaderboard only has best lap time, the tool needs the time for every single lap
  
• The leaderboard is for global rankings, the tool is for building a single race database
  

How to get the correct files

1. Play a race in RaceRoom (Practice, Qualifying, or Race)
   
2. At the end, RaceRoom automatically creates Race1.txt in your client
   
3. Download the file from Documents\RaceRoom\Results\
   
4. Upload it to the Build Results Database tool
   

 

Anyway, it could be interesting to manage this type of file.
I hope I can work on it in the following days

 

I have to test this combo.
Can you also share your settings of the app?

 

I will try some things this weekend.
The leaderboard step gives me 0 cars and tracks.
I can upload a race.txt file but after clicking on the green button nothing happens