rFactor 2 Results Parser

This is a small package that will allow you to transform a results file generated by the popular racing sim, rFactor2.

As of today the file generated is given to us a very heavy XML document, which is usable, but at the same time probably gives us more information than we need at any given time.

This utility will allow you to pass in a results file and it will parse it into a usable JSON format for you whilst also getting rid of any cruff you may not need right away.

Installation

NPM

npm install rf2-results-parser --save

Yarn

yarn add rf2-results-parser

Usage

Import (CommonJS)

const parseResults = require('rf2-results-parser');

Import (ES6)

import { parseResults } from 'rf2-results-parser';

Using the funtion

How you supply it the file is up to you, but chances are you will be using it within an API. Here is an example when using Node's FS module:

fs.readFile('./race-example.xml', (err, data) => {
  const resultsData = parseResults(data);
  console.log(parsedData);
});

For now the function only takes 1 arguement which is the data from the file you supply. An arguement for certain options will be added in due course.

Response

Here is an example response for a race session:

{ event: 
   { name: 'GPVWC SL Lights Round 7',
     location: 'Istanbul Park (2019)',
     session: 'Race' },
  result: 
   [ { position: '1',
       name: 'Cristian Pasqual',
       team: 'TR Bluvos Motorsport',
       car: 'GPVWC Superleague Lights 2019',
       raceTime: '01:07:28.205',
       lapsCompleted: '47',
       gapToFirst: null,
       pitstops: '2' },
     { position: '2',
       name: 'Mark Hutchinson',
       team: 'Idos Motorsport',
       car: 'GPVWC Superleague Lights 2019',
       raceTime: '01:07:28.599',
       lapsCompleted: '47',
       gapToFirst: '00:00:00.393',
       pitstops: '2' },
     { position: '3',
       name: 'Laurent Keersmaekers',
       team: 'Holland Racing Team',
       car: 'GPVWC Superleague Lights 2019',
       raceTime: '01:07:36.392',
       lapsCompleted: '47',
       gapToFirst: '00:00:08.186',
       pitstops: '2' },
     { position: '4',
       name: 'Michi Hoyer',
       team: 'Red Arrow Racing',
       car: 'GPVWC Superleague Lights 2019',
       raceTime: '01:07:41.912',
       lapsCompleted: '47',
       gapToFirst: '00:00:13.707',
       pitstops: '2' },
     { position: '5',
       name: 'Matthew Williams ',
       team: 'Red Arrow Racing',
       car: 'GPVWC Superleague Lights 2019',
       raceTime: '01:07:45.566',
       lapsCompleted: '47',
       gapToFirst: '00:00:17.361',
       pitstops: '2' },
     { position: '6',
       name: 'Noah Chilla',
       team: 'Cenobite Motorsports',
       car: 'GPVWC Superleague Lights 2019',
       raceTime: 'DNF',
       lapsCompleted: '38',
       gapToFirst: 'DNF',
       pitstops: '1' },

Options

points

Type: object

Description: This will apply a points score based on race position. YOu can also setup bonus points should you wish to award points for things like pole position or fastest lap

Usage:

const points = {
  racePosition: {
    "1": 10,
    "2": 8,
    "3": 6,
    "4": 4,
    "5": 2,
    "6": 1,
  }
  bonus: {
    polePosition: 1,
    fastestLap: 1,
  }
}

const resultsData = parseResults(data, { points: points });

Response:

  { position: '5',
    name: 'Matthew Williams ',
    team: 'Red Arrow Racing',
    car: 'GPVWC Superleague Lights 2019',
    raceTime: '01:07:45.566',
    lapsCompleted: '47',
    gapToFirst: '00:00:17.361',
    pitstops: '2',
    pointsAwarded: {
      racePosition: 2
    }
  },