Simulator Controller is a modular and extendable administration and controller application for Sim Racing. At the core is a comprehensive plugin capable automation framework, which can use almost any external controller hardware, such as Button Boxes, to control typical simulator components such as SimHub, SimFeedback and alike. Beside that, Simulator Controller also comes with several voice chat capable Assistants, which are based on artificial intelligence technologies. The first, a kind of Virtual Race Engineer, will assist you during your races to keep the hands on the wheel. It will handle all the cumbersome stuff, like preparing a pitstop, take an eye on the weather forecast, calculate damage impact on your lap times, and so on. The second Assistant, a Virtual Race Strategist, will keep an eye on the overall race situation and will develop and adapt strategies depending on race position, traffic and weather changes. The next assistant, a Virtual Race Spotter will watch over your race and will warn you about crtical situations with nearby cars, and so on. Last, but not least, a Virtual Driving Coach will be your invaluable source for information about car handling and everything, you want to know about racing in the real world or in a simulation.

Beside that, Simulator Controller brings even a bunch of other functionality and features to make the life of all of us virtual racers even more fun and simple. You will find a comprehensive overwiew of all features later in this document, but first things first...

If you find this tool useful, please help me with the further development. Any donation contributed will be used only to support the project.

Another possibility is to use Patreon to give me a hug, and as a benefit, you might get access to the public Team Server for your multiplayer endurance races.

Thank you very much for your support!

Installation is very easy. For first time users I recommand using the automated installer below. But there are different download and installation options available. Please see the complete documentation on Installation & Configuration, where you also will find a quick start guide for new users, for more information.

The programming language used for building Simulator Controller uses some really nasty tricks to control Windows applications, tricks also used by malware. Therefore, depending on your concrete Antivirus program, you may get some warnings regarding the Simulator Controller applications. I can assure you, that there's nothing about it. But you can read about these issues in the forums of AutoHotkey itself. If your Antivirus programm allows exception rules, please define rules for the Simulator Controller applications, otherwise you need to have a beer and search for another Simulator Controller tool. Sorry...

If you don't want to use the automated installer (or you can't cause of your Antivirus protection), you can manually install one of the versions below. There are separate download links for the current development build and at least the two latest stable releases. Download one of these builds and unzip it anywhere on your hard disks. Beginnging with Release 3.5.2, you then need to run the "Simulator Tools" application in the Binaries folder. This will guide you through the remaining installation process. For release information, even for a preview on upcoming features in the next stable build, don't miss the Release Notes.

Simply download and run Simulator Controller.exe (you may have to deactivate your Antivirus or Browser download protection). This small application will connect to the version repository and will download and install the latest version automatically for you. If you want to install a version other than the current one, no problem. This is possible by downloading and installing one of the versions below manually, but consult the documentation beforehand.

Here is a short video which shows how to configure Simulator Controller for the first time with a few clicks:

VERY IMPORTANT (for users with an already configured installation of Simulator Controller): An automated update mechanism for local configuration databases exists since Release 2.0. Please read the information about the update process carefully before starting one of the Simulator Controller applications. It might also be a good idea, to make a backup copy of the Simulator Controller folder in your user Documents folder, just to be on the safe side. Also, if you have installed and used a prerelease version, it will be necessary to rerun the automatic update. Please consult the documentation mentioned above on how to do this.

5.9.3.0-release (Changes: Updated car meta data for R3E, Fixed selection of start stint pressures in "Team Center", Fixed an error in strategy simulation which did not respect the stint timer, Fixed saving of imported telemetry data, Spotter now compares lap time to that of the opponents, Optimized window resizing for "Session Database", Fixed configuration of booster actions, Fixed configuration of Reasoning Booster in "Simulator Setup", Weather-specific best lap times are now passed to the LLM of the Reasoning booster to work with, New race settings for ideal tyre temperature.)

Please read the Release Notes and - sometimes even more important - the release specific Update Notes of this version and all the versions you might have skipped, before installing and using this version.

5.9.2.2-release (Changes: Lap telemetry opened from "Session Database" show the driver name, New telemetry fields LatG, LongG and Curvature, Support to import telemetry data from "Second Monitor", Fixed iRacing Spotter, Multiple telemetry selection support when loading telemetries, Colorized Track Automation state display on Button Box, Telemetry Viewer usable in "Setup Workbench", Renamed "Telemetry Analyzer" to "Issue Analyzer", Renamed "Telemetry Browser" to "Telemetry Viewer", Track map support in Telemetry Viewer, Select position on track by clicking in telemetry graph, Telemetry Viewer shows rotating ball when collecting telemetry, Startup simulator option moved to Startup Profiles.)

5.9.1.0-release (Changes: Open telemetry in the "Session Database", Telemetry Browser for "Team Center", Optimized database performance, Full translation for the Italian language, Fixed memory runaway in changing weather, Added a credits page in the documentation, Support for language mixing in speech generation, Reduced Jitter in telemetry chart, Fixed saving session w telemetry in "Solo Center".)

5.9.4.0-dev (Early build for 5.9.4. Changes: Layout settings for telemetry viewer, Fixed standings with duplicate race numbers, Fixed grid size and positions for R3E, Moved Spotter lap time announcement to Opponent Information group, Horizontal shifting of telemetry graphs, Save selected zoom factor for telemetry graphs, Independent horizontal and vertical zooming for telemetry graphs, Lap telemetry importer for MoTeC, Multi upload in session database, Upload telemetry can import from MoTeC and alike.)

Please read the Release Notes and - sometimes even more important - the release specific Update Notes of this version and all the versions you might have skipped, before installing and using this version.

A very extensive Documentation of more than 400 pages will guide you through the configuration process and will help you to understand the inner concepts and all the functions & features of Simulator Controller. For developers, who want to create their own plugins, a complete developers guide & reference is available as well.

The markdown files, the so to say source code of this documentation Wiki, can be found in the Docs folder.

Beside the quite extensive documentation (more than 500 pages - I know, nobody reads documentation these days), we also have a list of video tutorials, which are recordings of live coaching session in our Discord community.

1. Quick start guide - This video shows you how to create your first running configuration with a few clicks.

2. Setup and Configuration - You will learn a lot about the general setup and configuration of the Simulator Controller suite. The Setup Wizard "Simulator Setup" is introduced, but we will also take a look at the low level configuration tool "Simulator Configuration".

3. Managing Button Boxes and Stream Decks - Here we go a lot more into the details how to configure your available hardware controllers like Button Boxes, Stream Decks and Steering Wheels.

4. Voice Control - In this session you will learn the capabilities of voice control, beginning with the simple standard configuration up to a full configuration with individual names, voices and languages for all the different Assistants.

5. Pitstop Automation using Race Engineer - We will take a look at pitstop automation using the Race Engineer. You will learn everything about the necessary configuration and see and hear the Race Engineer in action on the track.

6. Managing Settings - This video gives an introduction into the settings used by the Virtual Race Assistants and how to manage these settings in the most efficient way.

7. Using Strategy Workbench - In this video we take a walk in "Strategy Workbench", the premium fuel calculator of the Simulator Controller suite. You will also learn, how to use the created strategies in "Team Center" and using the Virtual Race Assistents.

8. Introduction to Team Races - In this video, all the functionality of the Simulator Controller suite come together to manage and control your team races. You will learn how to setup everything, how to use the services of the Race Assistants during a team race and how to remote control the pitstop settings for the currently driving team mate.

9. More about the Race Assistants - After learning a little bit here and there about the Race Assistants in the last videos, this one is completely dedicated to the Race Assistants.

10. Working with the Setup Workbench - The Setup Workbench is a tool which helps you with your car setup work. It takes your handling problems and comes up with recommendations how to fix those. For a couple of simulators, setup files can loaded, modified and written back after automatically having applied the recommendations.

11. Working with data from multiple Drivers - This time you will learn how to work with data from multiple drivers in your telemetry database and how to create team strategies from this data. You will also see, how you can export and import data from and to your telemetry database.

12. Track Mapping and Track Automation - This video shows you how to create a track map for any track in any simulator and where you can use these track maps. A special usage is the automation of in-car settings like traction control or ABS depending on your location on the track, which will be demonstrated on-track at the end of the video.

13. Tyre Compounds and Weather Model - This session covers the handling of simulator specific tyre compounds. You will learn how to configure the available compounds for your car of choice and we will take a look at the weather model of Simulator Controller and learn how this is used together with the tyre compounds in strategy simulations.

14. Team Data Replication - This video shows you how to share telemetry and other data in your team using the Team Server. This data can then be used to create team strategies or lookup tyre pressures for an unplanned pitstop in a team race and so on.

15. Analyzing Driving Style and Handling Issues - This video shows you how to use the all new issue analyzer, which will automatically detect handling issues of your setup (or your driving style) while you are driving. The handling issues can then be transferred to the Setup Workbench to create a modification of the car setup.

16. Expert guide to race settings - This video will give you a complete overview over all the settings used by the Race Assistants, for example all the stuff needed by the Race Engineer to handle a successful pitstop in even the worst conditions.

17. Create your own voice commands - In this video you will learn how to define your own voice commands to control not only any part of Simulator Controller, but also all functionalities of your simulation games.

18. Strategy Development Revisited - This video covers a couple of new capabilities for strategy development and handling during the race including a demonstration in ACC.

19. Race handled fully by AI - This video gives you a full demonstration of a race under complete control of the AI Assistants. No driver interaction was necessary during this 3-stint race. Fully supported in solo as well as in multi player team races.

20. Defining custom Button Box Modes - This video demonstrates how you can define your own Button Box layers with custom commands.

21. Unboxing Solo Center - We are taking a detailed look at the "Solo Center", which lets you organize your practice sessions and solo races, as well as the data collected during those sessions.

22. Updating your configuration to 5.3 - This video shows you how to update your configuration to use the new capabilities of "Simulator Setup", which simplify many configuration tasks significantly.

23. Your personal Driving Coach - Demonstrates a general interaction with Aiden, the Virtual Driving Coach.

24. Car meta data - This video introduces you to car meta data and all the secret knowledge needed when extending the "Setup Workbench" for modded cars.

25. Using the Startup Profiles - This video explains the Startup Profiles in detail, which let you define configuration and enable or disable many important functions for different types of sessions.

26. Strategy Development Revisited again - This video will take another look at the "Strategy Workbench" and demonstrates a couple of new options, which allow you to create very special strategies.

27. Connecting Assistants to GPT - We introduce the new GPT-based Conversation Booster for the Assistants. Using this booster you can create a very life-like communication with the Assistants.

28. Extending and customizing Assistants using GPT - You will learn how to define your own events and actions to be used by an LLM to create custom behavior or change existing behavior.

29. Managing telemetry data - This video demonstrates the telemetry data system and shows how the different applications collect telemetry and what you can do with it.

This list will be extended from time to time to cover new functionalities.

If you want to become a part of the small and very young Community for Simulator Controller on Discord. Here you will also find a large collection of FAQs and you will be able to attend live coaching sessions each Monday. Please use this invitation to join the Discord Server.

Simulator Controller comes with a set of virtual Assistants to guide you throughout your races. To control the Assistants, you can use controllers like Button Boxes or interact with them directly in a natural voice dialog. In addition, several built-in applications assist you with setup and strategy development, or support you in monitoring and controlling your races and so on.

• Connect all your external controllers, like Button Boxes, Stream Decks, and so on, to one single center of control

  • An unlimited number of layers of functions and actions, called modes, can be defined for your controller. Switch between modes simply by pushing a button or switch a toggle on your controller. Here is an example of several layers of functions and actions combined in five modes:

  

  • Modes are defined and handled by plugins, which can be implemented using an object oriented scripting language.

• Configurable, visual feedback for your controller actions

  • Define your own Button Box visual representation and integrate it with the Simulator Controller using the simple plugin support and a graphical layout editor. Depending on configuration, the Button Box window will popup whenever an action is triggered from your controller, even during active simulation, or it might stay open all the time, if you have anough screen space, for example a second monitor.

  

  • Code your own functions to be called by the controller buttons and switches using the simple, object-oriented scripting language

• Configure all additional applications to your taste, including the simulation games used for your virtual races

  • Start and stop applications from your controller hardware or automatically upon configurable events
  • Add splash screens and title melodies using a spedial editor for a more emotional startup experience
  • Full support for sophisticated application automation - for example, start your favorite voice chat software like TeamSpeak and automatically switch to your standard channel

• Several plugins are supplied out of the box:

  • Support for Assetto Corsa, Assetto Corsa Competizione, rFactor 2, Le Mans Ultimate, iRacing, Automobilista 2, RaceRoom Racing Experience, Project CARS 2 and Le Mans Ultimate is already builtin, other simulation games will follow, when they become available
  • Fully customizable plugins supplied for total control of SimHub and SimFeedback - change your settings while racing using the dials and switches on your favorite Button Box
  • Control the calibration curves of your high end pedals by a simple button press with the plugin for the Heusinkveld pedal family
  • Send your predefined kudos and rants to the ingame chat without touching the keyboard

• Additional support to trigger every function and action from external sources like a voice or gesture recognition software to always keep your hands on the wheel

• Builtin support for visual head tracking to control ingame viewing angle - see third party applications below

Simulator Controller offers a virtual pit crew based on an AI powered chatbot engine. At the heart of this engine is hybrid rule engine coupled with voice recognition and voice synthesis. A rule engine is very suitable for the tasks of a typical pit crew, since all actions are event based and use large amounts of data.

You can communicate with the crew members using voice and natural language. Voice commands are pattern-based but you can connect each pit crew member (called Race Assistant in Simulator Controller) optionally to a GPT service and use the natural language capabilities of an LLM (aka large language model) to boost the conversational expertise of the crew members.

According to the maturity scale of attractive.ai (one of several hundreds maturity models that can be found on the net), the Race Assistants of Simulator Controller are somewhere between level 3 (Assistance) and 4 (Autonomy). They observe your racing, can give recommendations and take responsibilty for certain tasks like strategy management and pitstop planning and preparation.

The Assistant is based on text-based GPT technology and uses a publically available large language model which has been trained with vasts amount of information. Using this knowledge, this Assistant behaves as your personal driving coach. Although the Driving Coach is not a part of your active crew, you can ask him anything about racing, car handling and driving techniques and you will probably will get an interesting answer.

Click on the picture to hear an actual conversation with the Driving Coach:

The Virtual Driving Coach can use LLM runtimes of OpenAI, Mistral and alike, but if your PC is powerful enough, you can also use an integrated runtime for a variety of LLM architectures, like Llama, Falcon, Mistral, GPT, and so on, as long as they are available in GGUF format.

An AI based Race Engineer with fully dialog capable voice control will guide you through your race, warn you about critical technical issues and will help you with the pitstop, whereas the Race Strategist keeps an eye on the race positions, develops a pitstop strategy, and so on. These smart chat bots are independent applications, but are integreated with the ACC and other simulation game plugins using interprocess communication right now. An integration for a new simulation games requires some effort, especially for the necessary data acquisition from the simulation game, but a knowledged programmer can manage it in about three to four hours.

Based on the data sets, that are acquired during your sessions by the Virtual Race Assistants, a very flexible tool allows you to analyze your performance and the performance of your opponents in many different ways.

Another capability of the Virtual Race Strategist is to support you during the development of a strategy for an upcoming race using the telemetry data of past sessions on the same track in similar conditions.

You can even use all these functionalities during multiplayer team races using the Team Server, which handles the state and knowledge of the Race Assistants and share this information between all participating drivers. The Team Server is the backend for the so called "Team Center", a console, which can be used by any team member (even if not an active driver) to gather all kind of session data and remote control various aspects of the session, for example the settings for an upcoming pitstop.

Simulator Controller also comes with a Virtual Spotter, which will keep an eye on the traffic around you and will warn you about critical situations. You can fully customize the information provided by the Spotter to your specific needs and taste.

Beside the typical duties of a Spotter, this Assistant is also able to automate various actions depending on your location on the track. For example, it can automatically reduce the traction control, when approaching a tight turn.

Another very useful tool of the Simulator Controller suite is the Setup Workbench. This tool is based upon the AI technology which is used by the Race Assistants and generates recommendations for changing the setup options of a car based on handling problems described by the driver.

• Configurable and automated build tool for developers
• Sophisticated logging, tracing and debug support to track down any errors while developing your own plugins
• Fully graphical configuration utilities

• Last, but not least, a versatile monitoring tool, which gives you insights into the current operation and the health state of all components

Simulator Controller has been implemented to great extent in AutoHotkey, a very sophisticated and object-oriented Windows automation and scripting language, which is capable to connect keyboard and other input devices to functions in the script with a simple macro language. On the other hand, AutoHotkey also has a lot of robotics capabilities to automate software packages, which do not provide external APIs, by simulating mouse clicks and keyboard input. You can write your own plugins using the AutoHotkey language. To get you started, full source code for all bundled plugins with different complexity from simple to advanced is included.

You will also find a lot of C#, C++ and even C code for the low-level stuff like telemetry data acquisition or connecting to cloud services on the Azure cloud, for example. Here also, all the sources are open and free to use. Last, but not least, and not for the faint-hearted, there is a hybrid, forward and backward chaining rule engine used to implement the Virtual Race Assistants. It uses a modified RETE-algorithm to be as efficient as possible when using large numbers of facts.

These plugins are part of the Simulator Controller distribution. Beside providing functionality to the core, they may be used as templates for building your own plugins. They range from very simple functional additions with only a small number of lines of code up to very complex behemoths controlling external software such as SimHub.

The following applications are not part of the distribution and are not strictly necessary for Simulator Controller. But Simulator Controller is aware of these components and will integrate them for a better overall experience, if available.

1. Connection between the "Motion Feedback" plugin and SimFeedback has some stabilty issues. Looks like the root cause is located in the SFX-100-Streamdeck extension. For a workaround click on "Reload Profile..." on the Extensions tab in SimFeedback, if you see strange numbers in the Button Box "Motion" mode page.

For new features coming in the next release, take a look at the Release Notes.

Want to contribute? Great!

• Build your own plugins and offer them on GitHub or join the Discord community and post your plugin in the #share-your-mods channel. Contact me and I will add a link to your plugin in this documentation.
• Found a bug, or built a new feature? Even better. Please contact me, and I will give you access to the code repository.

Heads Up: I am looking for a co-developer for some fancy upcoming AI stuff.

After firing out one release per week during the last few weeks, the project will slow down a little bit from now on. But the development of Simulator Controller still goes on, and I am sure that we will end up in a two weeks cycle in the long run. My own list of ideas in the backlog is always long enough for at least three more releases and if you want to propose a feature to be included in the backlog, you can open an enhancement issue on GitHub or join the Discord community and post your idea on the #request-a-feature channel...

This software is provided as is. You are free to use it for any purpose and modify it to your needs, as long as you do not use it for any commercial purposes.

(2024) Creative Commons - BY-NC-SA - by Oliver Juwig (TheBigO)