2. Install & Play
3. Basic controls
4. Known issues
5. Screen resolution
- Level Editor & Developer
7. Contact us
The game tells the story of a world destroyed by a conflict between
robots and their human masters. Play as Tux in a quest to save the
world from the murderous rebel bots who know no mercy. You get to
choose which path you wish to follow, and freedom of choice is
everywhere in the game.
FreedroidRPG features a real time combat system with melee and ranged
weapons, fairly similar to the proprietary game Diablo. There is an
innovative system of programs that can be run in order to take
control of enemy robots, alter their behavior, or improve one's
characteristics. You can use over 150 different kinds of items and
fight countless enemies on your way to your destiny. An advanced
dialog system provides story background and immersive role playing
The game is complete, fully playable, and can provide about 10 hours
of fun. It is still being actively developed, and help is welcome in
many areas. People having - or trying to acquire - programming, map
editing, or writing skills will find FreedroidRPG to be an exciting,
fast-moving project in which they can fully express their creativity.
2. Install & Play
For general help with installation, please refer to the INSTALL file located in the same folder as this file.
Specific instructions for Ubuntu: http://ubuntuforums.org/showthread.php?p=6127097#post6127097
To run the game you normally just have to launch the executable.
For advanced options execute "freedroidRPG --help" (in a terminal) to get a list of command line options.
The game is controlled using the mouse. Left click onto the locations you want to move to. Hold
the button down to keep moving in that direction. Holding down CTRL key will make you run.
Left clicking an enemy will cause Tux to come close to the droid and to start attacking it with the
current weapon. If the current weapon is a gun then Tux will stand still and shoot the droid.
Use the right click to activate the currently selected skill/program.
Default keys (most keys can be reassigned with the in-game key chart - F1)
Escape ... Show main menu
F1 ... Show keychart
F2 ... Toggle fullscreen (Linux only)
F3 ... Quicksave
F4 ... Quickload
F5-F12 ... Quick-select program 1 through 8
I ... Inventory panel
C ... Character panel
S ... Skills/Program panel
Space ... Close all open panels
Q ... Quest log
0-9 ... Use quick-inventory items 0-9
P ... Pause
Hold A ... Attack while staying at the same position
Hold Shift ... Keep current target selected when moving
Tab ... Toggle automap (if available)
R ... Reload weapon
Hold Ctrl ... Run
U ... Toggle always run
Hold X ... Show labels for items on the ground
Z ... Toggle show labels for items on the ground
T ... Toggle walls becoming transparent when Tux approaches
Ctrl + Q ... Quit the game
Ctrl + G ... Toggle grab input (prevent cursor from escaping the game window)
Print ... Take screenshot (saved into ./.freedroid_rpg/ folder of your home directory)
Arrow keys ... Move
Up ... North
Down ... South
Right ... East
Left ... West
4. Known Issues
* Some melee and ranged weapons still have placeholder laserswords/rifles for their Tux holding
and attack animations. If you are skilled with 3D modeling, please help us out to fix this.
* When you start the game in OpenGL mode and something overlays the FreedroidRPG window while starting
up, the background images looks very strange. If you click on one of the menu items, it should return to
looking as intended.
* Alt tab in/out of the game in OpenGL while a static popup is displayed makes the screen completely black.
Clicking or pressing the required key to close the popup will redraw/bring back the screen.
* Open Files: OSX max number of open files defaults to 256 (as of 10.6). This can lead to errors when
loading images: "In Function: get_iso_image_from_file_and_path. Could not load image
1) Check value of open files limit with $ ulimit -n
2) Set new value for open files limit with $ ulimit -n 2048
* Font rendering: If you get no fonts in the main menu with SDL or if in openGL mode, the game dies
with the error message "In Function: PutCharFont. Surface for character 46 was NULL pointer!",
check your display configuration and set the color profile to sRGB.
(issues #2913485 and #2913484)
* SDL installed via MacPorts: SDL installed via MacPorts will give freedroidRPG wrong information
about the byteorder if you have a big-endian (PowerPC) CPU, so the colors may be wrong and you
probably couldn't start a new game because FreedroidRPG crashes.
To fix it, with root privileges edit the /opt/include/SDL/SDL_config.h file so the line
After editing and saving the file recompile freedroidRPG and it should work correctly.
Using SDL compiled from source instead of from MacPorts will work as well.
* Pulseaudio: Using SDL-pulseaudio you are currently likely not to get sound. This has nothing to do
with FreedroidRPG but with Pulseaudio and its plugins still in general being immature. We recommend using
e.g. SDL-esd or SDL-alsa until these problems has been fixed upstream.
* Intel 915/945/IDG graphics cards (EEE PCs, netbooks, etc): Mesa 7.9-devel has an issue which makes the game
run slowly and consume a lot of memory. It is fixed by installing and launching 'driconf' and setting
'Enable texture tiling' to 'No'.
* Due to hardware and software drivers, the "Gamma Correction" option may affect nothing.
5. Screen resolution
There are a few hidden high resolution settings only accessible from command line. They are badly tested
and thus generally considered to be buggy and are unsupported. They however can still be quite useful for
many, especially for widescreen LCDs in fullscreen mode.
To get an up-to-date list of available resolutions use "freedroidRPG -r99".
Some known issues for the unsupported resolutions:
- Portrait image in dialogs overflows its borders
- Off center light radius
- Incorrect text scrolling when talking to NPCs at times
Q: Do I have to have Linux to try out FreedroidRPG?
A: While using Linux is greatly recommended for the sanity of the system
administrator, FreedroidRPG has MS-Windows executables available.
Note that since the FreedroidRPG development team doesn't use
MS-Windows, it gets much less testing. Help with testing and feedback
from Windows users thus is greatly appreciated.
Q: How can I subscribe/unsubscribe to the mailing list?
A: FreedroidRPG has two mailing lists. One is for discussing stuff related to
FreedroidRPG, the other one is a list with auto-generated change logs from our
developer server and therefore usually only interesting for developers themselves.
In any case, you can subscribe, unsubscribe or change your membership options
from the following web page:
Q: The game is *extremely* slow on my system running Windows and using OpenGL output.
A: It might be that you're using the OpenGL drivers that came with your
operating system from Microsoft. These drivers don't use hardware acceleration
and are therefore extremely slow. You'll have to download and install a real
OpenGL capable driver for you graphics card. Usually these can be downloaded
from the home page of the graphics chip manufacturer, typically Nvidia, AMD/ATI,
etc. Note, that if you do absolutely cannot get OpenGL working reliably on your
system, you can still run the game in pure SDL output mode. For this, you
must either use a 'MS-DOS command line prompt' and type
inside this command line, or you can also make a link to freedroidRPG.exe
and then edit the link properties and add the -n after freedroidRPG.exe in
the link properties dialog box.
Q: The game is *extremely* slow on my Linux machine with OpenGL enabled.
A: The reason for this might be that you're not using hardware accelerated OpenGL.
Software OpenGL should be avoided. If you don't have hardware-accelerated
OpenGL on your system (because e.g. your graphics card manufacturer doesn't
make suitable Linux drivers), you might be much better off when disabling
OpenGL support altogether. For this, you can use command line switch -n,
to start the game with OpenGL output disabled. Graphics will revert to
pure SDL mode.
Q: I run Linux with multiple monitors in TwinView (Xinerama) mode, however fullscreen
mode is centered over the break between the two monitors. I would rather it be
centered on one of the screens.
A: To have the game use only one monitor for fullscreen mode, do the following:
1) Make certain you use SDL version >=1.2.14.
2) Set the environmental variable "SDL_VIDEO_FULLSCREEN_DISPLAY" to the number corresponding to
the monitor you wish to use: 0 is your first display, 1 is your second, etc.
If that does not work you may have to add single-monitor metamodes to your xorg.conf file.
Modifications to xorg.conf require a restart of the X server before they take effect.
Q: My sound isn't working with FreedroidRPG. I don't hear anything.
A: 1.) Make sure your sound is working with other applications. If you
don't hear anything when trying to play simple mp3 files or ogg files,
then the sound system on your machine is not properly set up and it's
not a freedroidRPG related problem. In that case, you must install your
sound card properly first.
2.) See if you have the SDL_mixer libraries installed. You might want
to use "locate SDL_mixer" and see if you get a lot of results. If
not, then the missing SDL_mixer library is the problem.
Also check if you have libogg and libvorbis installed.
3.) If you're compiling from source, make sure the ./configure script has
properly detected the SDL_mixer library. Just look at the ./configure
output. There should be a line like:
checking for Mix_ChannelFinished in -lSDL_mixer... yes
If you get instead something like
checking for Mix_ChannelFinished in -lSDL_mixer... no
then the ./configure script didn't detect your SDL_mixer
installation. You might want to make sure you've got SDL_mixer and
SDL_mixer_devel packages installed or install SDL_mixer from source.
You can download everything from here:
If you compiled from source, you'll have to recompile now, because the
previous compile didn't include the sound module of FreedroidRPG. If
the SDL_mixer stuff is installed properly, it should work after the
Q: My sound is lagging behind. Every sound seems to be somewhat out of sync.
A: There might be a sound daemon running on your system. Many window managers
like e.g. KDE start a sound daemon by default upon start up. To get rid of
the most common sound daemons, you can try (best as root)
killall -9 artsd
killall -9 esd
killall -9 yiff
killall -9 pulseaudio
After that, you might want to try freedroidRPG again. The sound lag should
not be present anymore.
Level Editor & Developer FAQ:
Q: Is there a Level editor?
A: Yes, we have a level editor integrated into FreedroidRPG. It can be accessed
from the main menu or executing
It has tooltips on every button to help you find your
way. Play around with it a bit by yourself and don't hesitate to ask for
assistance on IRC or the mailing list.
Q: How can I get the latest development version of the game?
A: This is very simple when using Linux. You can find the details here:
If you are using Windows we recommend using a tool like
If you still run into problems, best again discuss it with the people on
the freedroid-discussion mailing list.
Q: I want to help out with FreedroidRPG development. What should I do first?
A: First, we recommend to read http://www.freedroid.org/developer-area/contribute/
Second thing is to contact us. This can be done via IRC (see 'Contact' beneath)
or using the freedroid-discussion mailing list.
Then the next thing to do is to get the latest development version of the game
from git, then to either make a small patch right away or to discuss anything
bigger you have in mind with the people on the discussion mailing list or IRC, so
it can be assured that all the developers are pulling in the same direction and
know what's going on and who is working on what.
If you are new to the Sourceforge, you should also take at least a brief look
at our Sourceforge project pages. You can find the main page here
and other relevant pages should be reachable from there.
Website ................ http://www.freedroid.org
IRC channel ................ #freedroid on irc.freenode.net or
Mailing list ................ email@example.com
Sourceforge project page ... http://sourceforge.net/projects/freedroid/
Bug tracker ................ http://bugs.freedroid.org/
The game itself is licensed under GPL. Some other tools use a more permissive license,
please refer to the FILES file located in the same folder as this file.