Project CARS 2 Randomizer API

Desktop Cell Basic

Updated March 11, 2020

The randomizer was created to add some fun and variety into race nights. Want to level the playing field? Nobody practices Indycars on an RX track...in the rain.

Even if you're just looking for a random car, some random classes, anything - the randomizer is designed to make those decisions for you.

Updated for v. 1.7.1 - notes at the bottom. Contact me via email at JasonArizona[at]duck[dawt]com with all feedback. Made in Arizona and free to use. Enjoy!

• API
• Samples
• Chat Bots
• Notes

API

Path

All calls are made to https://pc2randomizer.azurewebsites.net/api/PC2Randomizer

Flags

Default values are bold. Order does not matter.

format

Determines output from API. No default; required.

• string xml - xml output
• string html - tall html output (cell phone)
• string htmlw - wide html output (web/stream)
• string track - returns a single random track
• string car - returns a single random car
• string tt - returns a single random car and track time trial suggestion

images

Include images in HTML output. The default may change if it is expensive for me.

• string true / false

dlc

Include DLC cars and tracks.

• string true / false

karts

Include kart tracks.

• string true / false

rx

Include rally cross tracks.

• string true / false

snow

Chance of snow on a track that would allow it. If Fuji is randomly chose, there is a chance of snow being chosen as the season. "Snow" is a season type
different from the snow weather type. If this is set to false, snow can still fall but the track will not be pre-covered in snow.

• string true / false

snowpct

If the above is true, this is the likelihood of snow being chosen if the track supports snow. By default, this is 30 percent. For no snow, set above flag to false.

• int 1...30...100

laps

This sets the maximum number of laps. This number is used to calculate the race time also, guessing an average speed of 90mph. This is wildly inaccurate
so consider it just another alternate recommendation for the race length.

• int 1...50...999

avs

Average speed in MPH used to figure race length. Default is 90. Take a good guess!

• int 1...90...250

Samples

Car and Track

• This is being used for a possible streaming bot or to integrate with a different API. Accepted arguments for car are dlc and karts. Returns XML.
  https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=car&karts=false&dlc=false
https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=track

XML

• Default flags, XML output for you to parse:
  https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=xml
  Sample output (no cr/lf):
  <?xml version="1.0" encoding="UTF-8"?><pc2randomizeroutput><flags><run>xml</run><images>false</images><DLC>false</DLC><karts>false</karts><rx>false</rx><snow>true</snow><snowpct>10</snowpct><maxlaps>300</maxlaps></flags><track><country>North America</country><tname>USA - California Highway - Stage 1</tname><lenMI>4.11</lenMI><lenKM>6.62</lenKM><type>Point-to-Point</type><TDLC>Standard</TDLC><snowtype>No Snow</snowtype><Timagename>california-highway_orig</Timagename></track><car><year>2013</year><make>Oreca</make><model>03 Nissan</model><class>LMP2</class><CDLC>Standard</CDLC><Cimagename>oreca_03_livery_51-1</Cimagename></car><raceclasses><carclasscount>4</carclasscount><classes>GTE/LMP2/Road F/WR</classes><averagespeed>20</averagespeed></raceclasses><environment><season>Spring</season><date>May 21</date><time>5 PM</time><timeprogression>10x</timeprogression><laps>150</laps><totMI>616.5</totMI><totKM>992.56</totKM><Wprogression>30x</Wprogression><weathercount>1</weathercount><weatherslots>Blizzard</weatherslots></environment><dlcused></dlcused><contact>Email: JasonSandwich[at]outlook[dawt]com</contact></pc2randomizeroutput>
• All options custom:
  https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=xml&images=false&karts=false&rx=false&snow=true&snowpct=10&laps=300&avs=20&dlc=false

HTML

• Pre-formatted HTML Wide - small but easy to scale for OBS view:
  https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=htmlw (here)
  
• Pre-formatted HTML Tall - decent for Cell portrait view:
  https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=html
  Sample use: <head><title>Project CARS 2 Randomizer</title> <script> function GetRando() { var xmlHttp = new XMLHttpRequest(); xmlHttp.onreadystatechange = function () { if (this.readyState == 4 && this.status == 200) { var outstring = xmlHttp.responseText outstring = outstring.slice(0,-5); outstring = outstring.substring(1); document.getElementById("randoutput").innerHTML = outstring; } }; xmlHttp.open( "GET", "https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=html", true); xmlHttp.send(); } </script> </head> <body bgcolor="black" link="yellow" vlink="red" text="white" onload="GetRando()"> <input type="button" value="Roll The Dice!" onClick="window.location.reload()"> <p style="font-size:20px" id="randoutput"></p> </body> </html>

Chat Bots

To use the random car and track call with a command chat bot, add these custom commands. Accepted arguments for car are dlc and karts.

• Nightbot (Twitch): $(urlfetch https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=car&karts=false&dlc=false)
• Deepbot (Twitch): @customapi@[https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=car]
• Streamlabs Chatbot (Twitch): $readapi(https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=track)
• Streamlabs OBS (Twitch): {readapi.https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=tt}
• Botisimo (Twitch/Discord/YouTube): $(fetch https://pc2randomizer.azurewebsites.net/api/PC2Randomizer?format=$(query))

Notes

Latest at top

1. 20231102 - removed link to forum
2. 20200311 - updated output contact info as well. i forgot api put out my discord name which is now dead.
3. 20191209 - changed contact info. getting rid of discord, added outlook email
4. 20190524 - added sample code for Stream Labs OBS (SLOBS) and indicated testing for pc2rando.com
5. 20190310 - added "tt" as an input, creates a car/track suggestion for time trial and some emoji to the tt, car, and track output for some color
6. 20190224 - minor change, track and car output now use square brackets
7. 20181022 - fixed a dumb bug, didn't consider LeMans vintage track dlc as dlc and fixed a typo
8. 20180916 - added Ferrari DLC
9. 20180722 - added km to track output for single use "track", best for chat bots, changed some brackets to ">" because bots make emojis with ")"
10. 20180721 - added info for joining Botisimo
11. 20180720 - changed "Average Speed" to "Average MPH" on both the cell and desktop landing page
12. 20180717 - added "car" and "track" to output, a single element returned and provided custom bot use commands
13. 20180628 - primary landing page redirected to mobile site if narrow display is detected
14. 20180604 - added le mans legend dlc
15. 20180601 - added dlc flag to documentation and updated examples, forgot to include it with initial documentation
16. 20180528 - added avs argument to feed average speed, changed assets to transfer via https only