8 releases
0.2.3 | Feb 16, 2024 |
---|---|
0.2.2 | Nov 3, 2023 |
0.2.1 | Sep 16, 2023 |
0.2.0 | Jul 19, 2023 |
0.0.3 | Jan 14, 2023 |
#53 in Simulation
177 downloads per month
265KB
6K
SLoC
simetry
Rust library for interfacing with telemetry of various racing and driving sims.
The library is under active development, and the generic interface for handling all sims is yet to be designed.
Currently supported sims:
- iRacing
- Assetto Corsa
- Assetto Corsa Competizione
- rFactor 2 (extra steps for enabling described below)
- DiRT Rally 2.0
- Euro Truck Simulator 2 (extra steps for enabling described below)
- American Truck Simulator (extra steps for enabling described below)
Beyond that, an interface for a generic HTTP server exists, allowing you to easily emulate any sim to see the functionality of your software that way, instead of having to run the sim and replicating scenarios manually.
All implementations provide a Client
which retries connections forever with Client::connect()
and
generates its own SimState
.
Besides that, iRacing provides a DiskClient
for reading recorded telemetry data,
and commands
for sending commands to iRacing.
Examples of capabilities are available in examples
.
The most generic way of use is using simetry::connect
to connect to whatever
sim is currently running with a generic client, and querying that way.
That generic way currently only supports some basic capabilities, and if you need more than what's present there, you can use the interface of the individual sims.
Extra Configuration
rFactor 2
Requires adding the DLLs from https://github.com/TheIronWolfModding/rF2SharedMemoryMapPlugin.
Euro Truck Simulator 2 and American Truck Simulator
Requires adding the DLLs from https://github.com/RenCloud/scs-sdk-plugin.
Alternatively supporting also https://github.com/Funbit/ets2-telemetry-server
via simetry::truck_simulator::json_client::Client
.
Dependencies
~144MB
~2.5M SLoC