FAQ
This is the document presenting the Frequently-Asked-Questions about Super Tux Kart (also called STK). Should your question not be answered here, feel free to contact us!
About SuperTuxKart
General questions about SuperTuxKart (STK for short).
What is SuperTuxKart
SuperTuxKart is a Free 3d kart racing game; we want to make the game fun more than we want to make it realistic. You can play with up to 4 friends on one PC, racing against each other or just try to beat the computer. (a network multiplayer feature is under development)
See the great lighthouse or drive through the sand and visit the pyramids. Race under water or in space, watching the stars passing by. Have some rest under the palms on the beach (watching the other karts overtaking you :) ). But don't fall into the volcano.
You can do a single race against other karts, compete in one of several Grand Prix, or try to beat the high score in time trials on your own.
What is the history of STK?
First there was TuxKart. Work on this happened (roughly) between April 2000 and March 2004. In June 2004, the 'Game of the Month' project of the Linux Game Tome decided to improve Tuxkart. This was done between June and December 2004. Unfortunately, this projected ended in a big disagreement, and it was finally decided to save the current state as 'SuperTuxkart'. While some graphical improvements were done, the code base itself was very unstable and basically unplayable. Nobody worked on (Super)Tuxkart till 2006.
Joerg Henrichs (aka hiker) picked up SuperTuxKart in 2006, fixed the outstanding bugs and performance issues without any further involvement of the original game designer or the GotM project. With the help of Coz a first release of STK was done in September 2006.
In May 2007 version 0.3 was released, adding highscore lists, a new track (Island) and the bomb, MacOSX and OpenAL support.
February 2008 saw the 0.4 release, which used bullet physics to improve the collision handling. Auria joined and started improving tracks (Shifting Sand, Lighthouse).
Version 0.5 was released in May 2008, and it included may improved tracks, challenges that need to be unlocked, the Follow-the-leader game mode, and translations.
Version 0.6 is now out. It will have significantly improved gameplay: more physics, using nitro and skidding. The sound system was improved, more interesting music was added, and many new tracks and karts were added. It also saw the first special multi-player map for 3-Strikes battle, and new items to use.
How can I install STK ?
Detailed instructions are on our Installation page.
Who is behind STK?
Page About us contains this information
Playing STK
Questions often asked when playing STK.
Wheelies don't work anymore!
With the 0.6 release we replaced wheelies with the use of nitro: collect nitro bottles, which gives you energy (see energy meter on the right side of the screen), which can then be used to give you an extra boost.
I can't jump anymore!
Jumping was removed, instead we added 'drifting' or sharp turning.
The computer shot backwards - how can I do this?
Some items (bowling ball and plunger) support to be used backwards. Just fire while looking backwards. Note: cakes still fly forwads.
What does the plunger do?
The plunger has two different ways of working: if shot forwards, it will come with a rubber band attached to it. If you hit another kart, you will be pulled forwards toward the kart, and the other kart will be pulled backwards. Ideal to overtake an opponent if executed skillfully. You can also shoot the plunger backwards - if you hit a computer the kart will be confused, and accelerate and steer less. If a player is hit, you will see a big plunger in the middle of the screen, and can't see the road anymore :)
Certain keys don't work if I use the keyboard!
This problem is reported in several different variations: e.g. you might not be able to skid when turning left, or you can't shoot when turning right etc. Basically, certain keys don't work all the time. Unfortunately, this is a hardware restriction of your keyboard: most keyboards can not report all keys pressed at the same time, see Keyboards are evil for details. The only solution is either to try different key combinations till you find one that works (the default ones work on nearly all platforms), to get a special gamers keyboard (that can report all key pressed, independent on the number of keys and what keys are pressed), or to use a gamepad.
The AI cheats, I can't push their karts, while my kart is very often pushed and even starts to rotate
The AI is using the same commands (for e.g. steering and acceleration) a player can use, and the physics does not differentiate between a player and AI karts. So there is no cheating for the AI. But the AI can change the steering direction much more frequently than a player can, and so can react to being pushed and correct its course much easier and more precise. You can see this effect in certain situation where the AI starts to 'shake' because it frequently changes direction. This is at the moment necessary to make the AI competitive. Once the steering algorithm is improved, we can hopefully reduce the shaking (which then would also make the AI karts easier to push).
Steering uphill or downhill is uncontrollable
the kart easily loses control especially when using a zipper while going uphill. You can't steer for a while, and suddenly the kart rotates and can't be stopped anymore. The reason for this is basically the physics simulation, and the track design: some tracks have parts that are too steep (uphill and downhill). In sections that are too steep downhill, the kart would fly (just above the ground), and you would not be able to steer. That might not be easily visible in the graphics (which not necessarily accurately reflect the physics). Then due to the simulation of the suspension the kart would touch the ground, lose contact again etc. - basically bounce a bit. If you steer while the kart is just touching the ground, the kart accumulates a certain rotational velocity, and therefore would keep on rotating while in the air, resulting in the rotations that can't be controlled (since the wheels are not touching the ground).
We actually tweaked the physics to make certain downhill parts more driveable by simulating really long suspensions (example the first downhill section in xr591). So in most tracks the downhill section is not a problem (or it is so steep that it is obvious and intended that a kart is flying). In reality the problem is more the track design, which just contains parts that are too steep. We are in the progress of updating the tracks to reduce this behaviour, too.
The same issue happens on uphill sections: the suspension is being compressed when accelerating, which then results in a push up of the kart, so that its wheels lose contact to the ground. And again, if the kart was rotating before, the rotational velocity of the kart would be responsible for the karts to keep on rotating while in the air, without any influence of the player (since all wheels are in the air). It might be possible to tweak the physics parameters to reduce this effect, e.g. make the karst heavier. But all physics parameters influence each other (heavier karts mean less acceleration, so the engine power needs to be increased, ...), and it's a lot of work finding a set of parameters that works fine. If you are interested in tweaking the settings, have a look at the file .../data/stk_config.data - all physics parameters for the karts are defined there, and can easily be changed with any text editor. If you have a better set of parameters, please let us know!
I found a bug, how should I contact you ?
First, look at the STK Bugs page and submit a new one if it is not a duplicate.
I suddenly got a big red circle on my screen, what's that?
Someone shot a plunger at your face =) You can do that to others by throwing the plunger backwards (see the FAQ entry about throwing items backwards)
I want to help! what can I do ?
- Sign to the mailing list at https://lists.sourceforge.net/lists/listinfo/supertuxkart-devel . More than 90% of the STK development communications are transmitted through it, so it's pretty important if you ever plan to tell something to the development team =]
- Decide how you want to help; making tracks/karts or music/sound effects, programming, improving the website, testing for bugs... just pick what you like best, or that you think that needs most help.
- Look into our TODO list to know what we need help with, thought you might find out of other issues through the mailing list. However, if you want to improve something not the the TODO list, go ahead! also, if you have done any private improvements already, we usually integrate them with the rest of the game if asked.
- Contact the STK developer team through the mailing list's e-mail, or if you aren't too patient you can try your luck and try to find a developer on IRC (irc.freenode.net #stk). Please tell us how you want to help.
- There are some task specific things to know:
- If you want to help with programming or test the game, you will need to create a building environment for STK; you can get the sources from SVN.
- If you want to help with visual art or audio art, you will need to check the Tools page.
- And no matter what you want to do, check the Developer's documentation for more task specific information.
Technical questions, compiling etc
Issues arising when compiling STK.
What are the dependencies of STK ?
The current dependencies for the SVN STK are :
I compiled STK myself, but it crashes at the start.
Version 1.8.4 of plib contains a bug which causes loading of the kart models to fail on windows (at least with Visual C++ compiler). This error was apparently fixed in the latest 1.8.5 release. If you prefer using 1.8.4, either download the custom version from our download page, or modify plib in order to work correctly. In PLIB_ROOT/src/ssg/ssgLoadAC.cxx replace:
loader_fd = fopen ( filename, "ra" ) ;
with
loader_fd = fopen ( filename, "r" ) ;
This should fix the crash.
I am compiling a current SVN version and I get "*** No rule to make target ... , needed by ... " error messages.
This happens if you update your SVN installation, and some files were moved since your last update: the (invisible) dependency files are not correct anymore and need to be updated. Please do a "make distclean" (followed by ./autogen.sh etc), this will delete all dependency files and and forces them to be recreated correctly. It is recommended to subscribe to the stk-devel email list, we usually post a warning if files are moved and a 'make distclean' is necessary.
Problems
General problems when playing STK - most of the bugs here are rather old and fixed.
I have frequent crashes with my self compiled binary
It appears that openal, esp. on x86_64 Linux systems, has some severe bugs, which are triggered by STK (see this bug report for details). To confirm this, first try running with music and sound effects disabled. If this helps, try our linux static binary. It uses OpenAL-soft instead of the old 0.0.8 version of openal, and apparently fixes all those crashes. You can also compile and install OpenAL Soft.
I have no sound or music in STK
There can be several reasons for this - obviously first check that your sound works with other applications, and make sure that no other application is using sound at the same time (which can be a problem with linux).
Recently, a bug on OpenSUSE 10.2 on ppc was discovered: to fix this, comment out the first line of /etc/openalrc:
;;(define devices '(alsa native))
The 0.5 release crashes if I move the cursor over some of the cups.
You have installed 0.5 on top of a previous release. Some of the data files have changed, and the left over data files can cause a crash. You have to either remove this previous installation, or install 0.5 in a different directory. Note that version 0.6 can be installed on top of an older installation. You might get some warnings printed to the terminal when running STK, but that is all that happens.
I get "FATAL: ssgInit called without a valid OpenGL context."
This message is usually caused by problems with your opengl version or your graphics driver (esp. on Linux). If you are compiling SuperTuxKart yourself, make sure that you are using the right include files (which match the opengl library you are linking); and using proprietary video drivers seems to remove this error message as well.
I'm getting rescued on top of the road without any reason!
Apparently, GCC 4.2.x decided it doesn't likes STK, so when STK is compiled with it in some tracks (like the star track) you will get rescued as if you were falling off the road. Try using the official binary for your system or compile the game with another version of GCC.
Thanks to hussam in the IRC channel for this.