Particiaption - involvement - community

FAQ

The following section is intended to cover any initial questions you may have regarding our applications. Please see other sections of this website for more information.

Overview

Our applications are software plugins for use exclusvely with the iRacing.com Motorsports Simulation

Our aplications extend the information provided by the simulation to better your real time awareness and make race changing descisions about your racing.

Availability

Free To Use - Our applications and simulation plugins are available for everyone to use with all its features enabled for personal use and evaluation.

Software

Our applications are built with standard industry programming languages and require a users computer to have runtime support for these. typically, most users will already have them installed.

Environment

Unlees otherwise noted, Our applications require a running instance/session of the iRacing.com Motorsports Simulation on your (Microsoft Windows) computer to interact with and able to connect to the internet.

Getting started with our applications is easy and requires no technical or computer specific skills.

QUICK START
Download it, Run it. Know you're going to make it. :)

Or for those who prefer instructions;
SETUP

1. Download our applications from the 'GET' link above.

2. Save the .ZIP archive to a easy to get to place on your computer.

3. Locate and Right Click, Extract Files.

USE

1. Run the (RaceToy 'Launcher') application, and/or Toney before or during your iRacing,com Simulation session is running on your computer.

The Race Toy launcher will keep RaceToy up to date as updates to the plugin are released.

You will hear some voice/audio feedback from the application that it is loaded and running once it see's an active iRacing.com Simulation session on your computer.

2. Enter a driving session, Practice, Qual, Testing, Race. You will hear audio feedback from the application that it is active and managing your car's on track telemetry data.

3. You can leave the aplication running at any time, can exit at any time. Be mindful, it will only be managing your car's data once it is running in conjuction the sim

Windows 10 Smart Screen Notes
It has been sometimes seen where some users get warnings from Windows 10 Smart Screen and Defender antivirus warnings with either the download or the first time use of the plugin/s.

Being an executable program on the internet, its valid for these warnings to be seen sometimes for such things. See this Download Help for a bit of a walk through on how to let it complete and should after that no longer nag the user.

For more information about how and what each application does, see the plugins section.

Usage Note

The applictions themselves do not require you to login directly to them for them to function. They just need to run when and or while the sim has a running session that you have joined.

Data projection

Without publishing our own Thesis (although, we probably can and should) on the sheer volume of research we've poured into the development and design of our applications core functions and features, we would like to touch on the concepts, theories, and practical design we've put into our applications to make sure you're going to make it.

Data modelling

In the context of motorsports, in relation to competitive outcomes through real-time evaluation of evolving data, simulation and modelling, we've designed our approach from numerous sources, race proven strategy examples and other proven theories, including but most certainly not limited to;

  • Interactive data, dependencies and fluidity
  • Real time statistical analysis, projection and change forecasting
  • Historical data analytics
  • Near field, multi system data matrixes and interconnected impact
  • Moral Relativity, Human interpretation and decision making influences in relation to dynamically favourable outcomes
  • Object Relativity, Mathematical extrapolation, extrusion, correlation and convergence

Confused yet?

For a user friendly overview of the theory basics, comprehensively extended as exercised in our applications, see;

No.

Our applications use only functions and information provided by the iRacing.com simulation and only in ways they are intended to be used.

Every care has been taken in the development and design of our applications to keep within the bounds of sportsmanship and strictly aheading to the iRacing.com Sporting Code and Terms and Conditions of the service.

We have sought clear and explict written permission for our applications with the senior staff at iRacing.com and have written approval for the use of our applications and the design and intent to which they are provided for use and that our applications do not in any way breach the iRacing,com conditions of use and is in the best interest of open fair play and good sportsmanship.

updates and ongoing development

While we are continually developing our platform, plugins and applications we need to remind users that from time to time the simulation updates the data (Telemetry) that is presented to our plugins and depending on any changes to this provided data how that may or may not affect our plugins and how they behave.

Every effort is made to ensure prompt and reliable corrections of the provided data (Telemetry) and the calculations they depend on. We appreciate your understanding and patience when this occurs, and your constructive feedback and observations are always welcome.

If you've spotted something that’s not functioning as expected or would like to provide feedback please drop by and let us know about it do we can ensure we can work to resolve it, by getting involved

Licensing

Used under https://www.fmod.com/licensing FMOD Indie License for permission to distribute.

Attribution

Made with FMOD Studio by Firelight Technologies Pty Ltd.

Development Notes


DIVISION 3 - DIGITAL DEVELOPMENT AND SIMULATION TECHNOLOGY, PLUGINS AND TOOLS FOR IRACING

RaceToy represents one of the key components of our dynamic data engine to monitor your racing telemetry data in real-time in order to
accurately predict and action strategy changes for favourable race outcomes.

Through managing reflective comparative data, on the fly pattern recognition and projection, we make race-changing real time decisions
and influence how your race plays out.

Designed from the ground up to cater for both VR and non-VR drivers RaceToy seamlessly monitors and manages driver fuel loads, tire life
and pit strategy for both sprint and endurance races.
No more thinking about your fuel or tires or fumbling with controls, just leaving you to drive flat out.

In development and fine tuning since 2008, hundreds of hours of in-race testing with both team and individual driver events have
proven the algorithm accuracy and reliability of RaceToy to manage fuel loads, deliver accurate fuel levels and make the right call on
tires to maximise your time on the track, and minimise time lost on pit road.

FEATURES INCLUDE

* Real time fuel and tire usage monitoring and projections
* VR / Non-VR enabled fuel and tire management and information
* Fuel and tire stop assisted decision automation: accurate preconfigured settings, fuel used, needed, tire wear, life etc
* Pit Box guides: counting you down to your pit stall
* On-Demand communication about live fuel and tire data
* Out-of-car and in-garage fuel load and pressure tire calculations
* Practice, Qualify, Race and Testing session fuel and tire usage data and projections
* Serial Port output telemetry interface (work in progress)


DEVELOPMENT ROAD MAP AND NOTES (RACETOY, RDI PLATFORM AND PLUGIN)

RaceToy - is in ongoing development, accepting user feedback and feature suggestions to automate your pit procedures within the spirit of the simulation.
RDI - is a data pool of like session samples derived from RaceToy's sample gathering. It is a data pool used for machine learning and adaptive analysis and projection, in addition to real time data monitoring of the driver.

Pending Feature Integration / Work in Progress / Exploring Machine LEarning for competative onm track outcomes;
- RDI data query to pool and reply to analyse against real time data to better project current session scenarios. (Working well for the AI Tires)
- Logic for Logging pool data on session conclusion (race flags, session laps and time remain check) - (Working well)
- Analytics pool data, push pull scenarios in real time vs in car activity. undercut, overcut strategy – (Work in progress)
- Strategic competitor mapping, car in front, behind, pit windows, needed vs wanted change - (Work in progress)
- Real time monitoring of potential gains through various strategic actions. (Monte Carlo simulation) – (Work in progress)
- Race Assistant plugin, RDI pool push pull, local once ok, link with RaceToy, or as transponder - (Work in progress)
- RA/RDI projection, based on last sample, assumptions, 'Monte Carlo simulation' mappings. (strategic) – (Work in progress)


RUNTIME USE NOTES

When out of car, or in garage; (This feature is being moved into incar voice feedback at the moment, but reamins in place while in development)

Example: Weather Air: 30.2 (4.7) Track: 44.5 (4.5) %10.1 Warmer, Suggest (kPa) 149.50 (From: 155.05) -1.4 Clicks

Assuming your setup was made using default weather and track conditions, this is advising that the current conditions, altitude, air pressure, track and air temperature, that you should take 1.4 click out of your tires, all around.
Dev note: it isn’t yet tracking your changes, so this is something to be aware of. e.g., it will always say to do the above even if you already have. - to fix soon.

Uses live weather from the sim, both session and live telemetry. weather DOES change, track temp changes by use, time of day and weather.
This is part of the tire development in relation to endurance racing where it will be tracking your tires and weather and making psi adjustments when the weather changes enough to need it (work in progress).

MACHINE LEARNING

Much of RaceToy's R3 platform has a number of machine learning teachnolgies built into it.

Ideally, it's learning how you race, how others race, how races play out and how best to forecast sitations for on track gain.
As with any machine learning system it can only learn from what it sees and what it knows. It has a comprehensive pool of learned knowledge and is learning everytime it goes on track.

FUEL: With years of fuel data behind it, its currently doing a great job of nailing that nearly everytime. obviously, circumstance in real time can change and it handles this well when it can.

TIRES: Tire metrics have come along way with RaceToy and while theres more room to go, it has some more to learn. it is getting better.

TRUST: Humans aren't so welcome of machines to do things for them, but while this isn't Skynet, I trust it and let it do the thinking while i just drive my race, and it's doing a great job so far.


DIAGNOSTIC TEXT DISPLAYS (FUEL)

Fuel L:79.508 U:0.492 0.36L/Laps SL: 6 FL: 1 EL:223.90

Is displayed in car on the application console, mostly as a visual reference.
Typically, the driver doesn’t need to see this as its more for diagnostics.

Fuel:
L: Level of fuel in the tank
U: Used fuel from last pit/exit
x.xx/x current fuel burn per minutes/laps
SL: Session laps, laps driven in this session
FL: Fuel Laps, how many laps driven on this fuel load.
EL: estimated/calculated laps left of fuel in the tank.

Any other text is for development and diagnostic use between versions and will be removed as things progress.


OPTIONAL PLUGIN CONTROLS (Keyboard fixed settings)

RaceToy - Optional Controls: (When on track, and in-car)

RCTRL + ARROW_LEFT = Manual Fuel Numbers Reset. (Diagnostic action)
RCTRL + ARROW_RIGHT = Read out current fuel numbers. (Voice Feedback)
RCTRL + ARROW_UP = Tire Control Toggle ON (Default state - Does manage Tires)
RCTRL + ARROW_DOWN = Tire Control Toggle OFF (Does Not manage Tires)
RCTRL + RSHIFT + PAGE_UP = Plugin Volume Up
RCTRL + RSHIFT + PAGE_DOWN = Plugin Volume Down
RCTRL + RSHIFT + INSERT = Weather Report (From baseline weather conditions)
RCTRL + RSHIFT + DELETE = Last Read Tire Report (From last read in garage, last pit stop Work in progress) (Voice Feedback)
RCTRL + RSHIFT + END = Cycles through active Fuel Plan Modes A through D. (Work in progress) (Voice Feedback)
RCTRL + RSHIFT + HOME = (Spare unsed)


OPTIONAL PLUGIN CONTROLS - Buton Box / Controller button mapping feture. - BETA - (When on track, and in-car)

This feature is for mapping game controllers, such as burron boxes and where supported sim wheel buttons to plugin functions.
Current build ships with setting default set with Setupcomplete=1 and not prompt for buttion mappings unless the user chooses to reconfigre it.

Currently on startup if 'D3_RaceToy_Launcher.ini' file has Setupcomplete=0, it will walk through mapping the 8 controls (listed below) of RaceToy binding them to selected controller or button box buttons.
Supports a generic range of 3rd party wheels, jopystick and button box controllers, however testing has been posative on most consumer wheels and button boxes so far.

Current mappable controls are;

Manual Fuel Numbers Reset. (Diagnostic action)
Report current fuel numbers. (Voice Feedback)
Tire Control Toggle ON (Does manage Tires - Default state)
Tire Control Toggle OFF (Does Not manage Tires)
Plugin Volume Up
Plugin Volume Down
Report current track weather difference to iRacing default weather conditions. (Voice Feedback)
Report Last Read Tire wear levels. As measured last seen in pit box, garage, as read from the Tires black box page. (Work in progress) (Voice Feedback)
Fuel Pan Cycle. Cycles through active Fuel Plan Modes A through D. (Work in progress) (Voice Feedback)

Note; You can map only selected ones, and optionally set others to '0' in the 'D3_RaceToy_Launcher.ini' after you've run throught the mapping of the 8 functions.
Eg, only map 'Report current fuel numbers. (Voice Feedback)', and once completed dummy mapping the rest, open the 'D3_RaceToy_Launcher.ini' file and set the rest to 0, saving your changes.


FUEL PLAN FEATURE NOTES - WIP (May 2020)

The Fuel Plan feature is a fuel delivery plan mode setting. Primarily for a driver to choose how the fuel levels delivered is configured.
Typically used for situations where a driver wants to choose to pit early in a stint, late, or balance out the fuel delivery over shorter stops, reconfiguring the plugin's normal fuel metrics.

Current plans metrics are;
0 = 100% Fuel plan, normal fuel needed metrics. (Default setting)
1 = 25% fuel plan, 1/4 fuel needed delivery, stop early, run long.
2 = 50% fuel plan, 1/2 fuel needed delivery, balanced half now, half later.
3 = 75% fuel plan, 3/4 fuel needed delivery, run long, short fuel later.

Conceptually the fuel plans are relavent to when tanks for fuel needed is less than 2, as normally, these would be tank and a bit type situations.
This feature will also have a 'take tires or not' function added to align with this fuel planning.
Currently not live as it is in development, however the mode toggle controls are live and can now be assigned for when the feature is made live in a coming update.


AUDIO INTERFACE NOTES

Current R3 build is now using the FMOD sound engine and ships with default set to 0 for auto windows default audio unless the user chooses to reconfigre it.
For most users this is fine and does nto need to be changed, unless users want to change an audio out where RaceToy audio goes to, such as front, rear, specific headphones, etc.

If you want to specify a audio interface each time it loads instead of picking it, open the 'D3_RaceToy_Launcher.ini'
in notepad, and set;
PreferedDevice=1024
Setting 1024 and running the launcher will send it into listing available audio interfaces for you to choose to set it to.
Example, if you want to set it to use windows current default audio out, set;
PreferedDevice=0
and save it.
Feature pending shortly is for it to save your last chosen interface as the default. - yet to be done, work in progress there.


FUEL AND TIRE ANALYTICS

These are performing well, in additional to background cloud machine learning analytics data is being looked at experimentally.
Such as the Cloud Data check for fuel burn high previous session, logging these observations to D3_RaceToy_Plugin.log when you come down pit road.
I'm interested to see the D3_RaceToy_Plugin.log after you have a run to see how thats travelling.
In this release (3.023 onwards) it is active and recalculating fuel needed as you come onto pit road. in testing
this has proven to resolve 'faster last stints'. be mindfull, it is experimental, as is machine learning it's only able to learn what you teach it.


ON TRACK
While most of RaceToy's learning is on track, its still learning to mimic human descision making habits, most notable in the space for Oval Racing.
It's getting better, but has a way to go before its learnt more, so remember, its learning, help itlearn by showing it how you strategically race. :-)


LOG FILE

On application startup, it clears any previous log file and creates a running log of application logging for situational events.
Such as, when pitting, a log is written of its actions and selected values for diagnostic purposes, and logs for feature experiments.

If you have any issues, its important to ensure you grab a copy of this file before starting RaceTOy again so i can see these logs.


CONTACT

Your feedback and questions is appreciated. you can Contact us via our DISCORD COMMUNITY CHANNEL ( https://discord.gg/pse5eGS )


Readme updated May 2020.


Updated: May 10, 2020

If you have any quieries not covered in this section, or other sections of this website, please contact us.