Skip to content
Jussi Lind edited this page May 1, 2015 · 6 revisions

General

Dust Racing 2D is a tile-based, cross-platform 2D racing game written in C++, Qt and OpenGL. Dust Racing comes with a Qt-based level editor for easy level creation. Dust Racing 2D uses a custom physics engine for car models and collisions.

License

Dust Racing source code is licensed under GNU GPLv3. See COPYING for the complete license text.

Dust Racing includes the source code for the GLEW library. See src/game/MiniCore/Graphics/glew/glew.h for the license text.

Dust Racing includes the source code for the GLM library. See src/game/MiniCore/Graphics/glm/ogl-math/glm/glm.hpp for the license text.

All image files, except where otherwise noted, are licensed under CC BY-SA 3.0: http://creativecommons.org/licenses/by-sa/3.0/

Playing

Controls

The default controls for player one (the pink race car):

Accelerate Brake Turn left Turn right
Up Down Left Right

The default controls for player two (the grey race car):

Accelerate Brake Turn left Turn right
W S A D

The key configuration and game mode can be changed in the settings menu.

ESC or Q exits the race and also the current menu.

P pauses the game.

Races

In the race modes there are always 12 cars. By finishing in TOP-6 a new track will be unlocked.

The record times and best positions are stored separately for each lap count.

Pit stops

Your tires will wear out as the race progresses. This causes more and more sliding.

Fortunately there's a pit (the yellow rectangle). By stopping on the pit your tires will be repaired.

Custom track files

Dust Racing searches for race tracks also in ~/DustRacingTracks/ where you can place your own race tracks.

Changing the graphics mode

  • Selecting a resolution in "Settings" => "GFX" => "Windowed resolution" forces the game into the windowed mode

  • Selecting a resolution in "Settings" => "GFX" => "Full screen resolution" forces the game into the full screen mode

Command line options

--lang [lang] forces the language. Currently available: fi, cs, it. English is the default.

E.g. ./dustrac-game --lang it

Performance

Dust Racing 2D tries to render at least at 60 fps. If you experience very slow performance, try first to set vsync off (Settings => GFX => Vsync).

Another option would be to force Vsync off via your driver settings.

The fullscreen mode is usually much faster than the windowed mode.

Development

Dust Racing 2D is currently being developed on Ubuntu. Building the project on Windows with the (sound) dependencies is a bit annoying, so the Windows builds and installers are also compiled on Ubuntu 14.04 LTS with the aid of MXE. The resulting Windows builds are completely statically linked. This works great and is super-easy as also the NSIS installer can be created on Ubuntu.

Building

Please refer to INSTALL document in the sources for detailed build instructions.

Basically on Linux you just:

$ ./configure $ make $ ./dustrac-game

The configure script is just a wrapper for CMake. You can also open the top-level CMakeList.txt in QtCreator. For MXE builds there are separate .pro-files. They can be also used for Linux and they assume Qt5.

The project compiles without modifications at least with GCC, MinGW and Clang. Building the project with MS Visual C++ is also possible and it works, but there's currently no packaging or deployment configuration for it.

Contribution

Want to contribute (translations, patches..) ?

The preferred forms of contributions are pull requests or Git patches against the dev branch.

E-mail: juzzlin@gmail.com.

Release Schedule

The aim is to release a new version every 1-2 months.

Clone this wiki locally