Skip to content

mika-n/User.RBRCustomReader

Repository files navigation

User.RBRCustomReader

Custom Richard Burns Rally (RBR) data reader plugin for SimHub. This plugin adds new properties to be used by SimHub dashboards.

  • RBRCustomReader.RSFCarName = The true car name as shown in Rallysimfans (RSF) car selection screens.
  • RBRCustomReader.RSFCarID = RSF car ID (not the same as 0..7 car slot ID)
  • RBRCustomReader.ExternalRaceTime = External race timer

SimHub addon plugin installation:

  • Close SimHub application
  • Download the latest SimHubPlugin_User.RBRCustomReader_versionTag.zip file from Releases page (see the right frame and Releases link)
  • Extract the downloaded zip file or navigate inside of it using FileExplorer to see files in the zip file
  • Copy User.RBRCustomReader.dll file into the SimHub application folder (ie. the folder where you have SimHubWPF.exe. For example c:\apps\SimHub\ folder)
  • Launch SimHub and it will probably notify you it detected a new addon plugin
    • Enable the RBR Custom Reader plugin
    • No need to tick Show in left menu option
  • The plugin should be now shown as enabled in SimHub/Settings/Plugins tab page

How to use new custom properties in SimHub dashboard layout

  • Add a text object into SimHub dashboard layout and set the text object to use NCalc formula with RBRCustomReader.RSFCarName, RSFCarID or ExternalRaceTime property reference.
  • You should see these custom properties (variables) in SimHub NCalc expression editor if you press "Insert property" button and search for "RBRCustomReader" properties.
  • For example the following SimHub NCalc expression formats the external raceTimer to use precision of 2 decimals, no sign, zero minutes and hours are not shown:
    • toshorttime( [RBRCustomReader.ExternalRaceTime], 2, false, false )

License

Copyright (c) 2023-2024 mika-n, www.rallysimfans.hu. No promises and/or warranty given what so ever. This may or may not work. Use at your own risk.

WTFPL licensed to public domain, free for commercial and personal use, modifications and redistribution allowed. http://www.wtfpl.net/

If you modify and create a derivated version using this app then please leave the above shown copyright text in the derived work as a credit to the original work (readme.txt and source code files).

NCalc example

About

Custom RBR data reader plugin for SimHub

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages