Skip to main content

Library to work with Free Rider HD Tracks

Project description

A Python library for working with Free Rider HD Tracks.

pip stable type sdist license MIT


Free Rider HD is an online HTML5 + JS game where users can draw bike tracks, upload them to a community of players, and ride them. (Go try it out!)

When drawing a track, you can import track code from a file or from your clipboard. This library (as of now) allows you to generate that code.


Fire up a terminal and run:

pip install frhdtools

You should be good to go.


Example 1: Straight Line

When you start, you’ll want to import frhdtools:

import frhdtools

Next, you should create a Track class. This will hold all of your track’s objects and code.

my_track = frhdtools.Track.Track()

Now that you’ve done that, you can add a line:


This line goes from (-40,50) to (100,50). What is the ‘p’, you ask? That corresponds to the type of line. In this case, it means a physics line. More on types of lines later.

Now, lets generate our code:

This will generate the code stored in my_track and print it to stdout.
In my case, the code was this:
-18 1i 34 1i,###

Don’t worry what the code means just yet. First let’s plug it into FRHD to see if it works.

In the Track Editor, click “Import” at the top of the editor:

Click Import at the top of the screen.

Then paste in your generated code at the window that pops up.

After it loads your file, the track should look exactly like this:

The imported track.

Wondering about the helmet? It’s just swag.

Congratulations! You’ve just finished you first line segment. It will get easier, I promise. :wink:

Example 2: Scenery Line

Remember how I mentioned that there were different types of lines? Well here’s what they are.

In the last example we used a physics line. The rider can interact and ride on those.

In this example you’ll make a scenery line. A scenery line is a line that the rider cannot ride on. It is purely just for scenery. Also, scenery lines are gray instead of black.

It’s really easy to make a scenery line. Instead of using the code from last time:

import frhdtools
my_track = frhdtools.Track.Track()

We change the ‘p’ to an ‘s’ in my_track.insLine:

import frhdtools
my_track = frhdtools.Track.Track()

(FYI: The code should be #-18 1i 34 1i,##)

Now, when you plug the code into FRHD, you will get this:

A scenery line.

Note: the rider will fall through the line as it does not have physics. This is normal.

Now you have made a scenery line. Great!

Example 3: Boost

In this example, you will learn how to make a boost powerup.

To start, let’s take our code from the first example:

import frhdtools
my_track = frhdtools.Track.Track()

and add my_track.insBoost(90,-10,90)

import frhdtools
my_track = frhdtools.Track.Track()

This will spawn a boost powerup at (90,10). It will be rotated 90 degrees.

** By the way, the code should look like this: -18 1i 34 1i,##B 2q a 2q,#

Plug that into FRHD, and you’re left with this:

A boost powerup.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

frhdtools- (4.9 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page