README 14.3 KB
Newer Older
1
    FreedroidRPG: README
ahuillet's avatar
ahuillet committed
2 3
   ----------------------

4
0. Index
ahuillet's avatar
ahuillet committed
5
=========
6
  1. Introduction
7
  2. Install & Play
8 9 10
  3. Basic controls
  4. Known issues
  5. Screen resolution
11 12 13 14 15 16
  6. FAQ
     - Miscellaneous
     - Graphics
     - Sound
     - Level Editor & Developer
  7. Contact us
17
  8. License
18

ahuillet's avatar
ahuillet committed
19

20
1. Introduction
ahuillet's avatar
ahuillet committed
21
================
22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41
 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
 situations.

 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.
42

43

44
2. Install & Play
45 46
==================
 Last stable realase and prebuild Windows/MacOsx are at ftp://ftp.osuosl.org/pub/freedroid/
47
 For general help with installation, please refer to the INSTALL file located in the same folder as this file.
fluzz's avatar
fluzz committed
48 49 50
 For more information, please see also INSTALL.freedroidRPG
 Packages needed to build depends of your distribution. They are listed in INSTALL.freedroidRPG
 Basically, you then just have to
51 52 53 54

    ./configure
    make
    make install
55

56 57
 If you don't want to install the game, do not issue "make install", simply go to the src/ subdirectory, and run
    ./freedroidRPG
58
 For advanced options execute "freedroidRPG --help" (in a terminal) to get a list of command line options.
ahuillet's avatar
ahuillet committed
59

60

61
3. Controls
ahuillet's avatar
ahuillet committed
62
============
63
 Movement
ahuillet's avatar
ahuillet committed
64
 
65
  The game is controlled using the mouse. Left click onto the locations you want to move to.  Hold
ahuillet's avatar
ahuillet committed
66
  the button down to keep moving in that direction.  Holding down CTRL key will make you run.
67

68
 Attack
69

70
  Left clicking an enemy will cause Tux to come close to the droid and to start attacking it with the
ahuillet's avatar
ahuillet committed
71
  current weapon. If the current weapon is a gun then Tux will stand still and shoot the droid.
72

73
 Special functions
74

75
  Use the right click to activate the currently selected skill/program.
76

77
 Default keys (most keys can be reassigned with the in-game key chart - F1)
78

ahuillet's avatar
ahuillet committed
79
  Escape     ... Show main menu
stedevil's avatar
stedevil committed
80 81
  F1         ... Show keychart
  F2         ... Toggle fullscreen (Linux only)
82
  F3         ... Quicksave
stedevil's avatar
stedevil committed
83
  F4         ... Quickload
84
  F5-F12     ... Quick-select program 1 through 8
85

ahuillet's avatar
ahuillet committed
86 87
  I          ... Inventory panel
  C          ... Character panel
88
  S          ... Skills/Program panel
ahuillet's avatar
ahuillet committed
89 90 91
  Space      ... Close all open panels
  Q          ... Quest log
  0-9        ... Use quick-inventory items 0-9
92

93
  P          ... Pause
stedevil's avatar
stedevil committed
94
  Hold A     ... Attack while staying at the same position
ahuillet's avatar
ahuillet committed
95
  Hold Shift ... Keep current target selected when moving
96
  Tab        ... Toggle automap (if available)
97

ahuillet's avatar
ahuillet committed
98 99 100
  R          ... Reload weapon
  Hold Ctrl  ... Run
  U          ... Toggle always run
101

ahuillet's avatar
ahuillet committed
102 103
  Hold X     ... Show labels for items on the ground
  Z          ... Toggle show labels for items on the ground
104
  T          ... Toggle walls becoming transparent when Tux approaches
105
  Ctrl + Q   ... Quit the game
ahuillet's avatar
ahuillet committed
106
  Ctrl + G   ... Toggle grab input (prevent cursor from escaping the game window)
107 108 109 110 111 112 113
  Print      ... Take screenshot (saved into ./.freedroid_rpg/ folder of your home directory)

  Arrow keys ... Move
     Up      ...     North
     Down    ...     South
     Right   ...     East
     Left    ...     West
114

115

ahuillet's avatar
ahuillet committed
116
4. Known Issues
117
================
118
 General
119 120
   * 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.
121
   * When you start the game in OpenGL mode and something overlays the FreedroidRPG window while starting
122 123
	 up, the background images looks very strange. If you click on one of the menu items, it should return to
	 looking as intended.
124
   * Alt tab in/out of the game in OpenGL while a static popup is displayed makes the screen completely black.
125
	 Clicking or pressing the required key to close the popup will redraw/bring back the screen.
126

stedevil's avatar
stedevil committed
127
 Mac
128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147
   * 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
	 /usr/local/share/freedroidrpg/graphics/obstacles/<filename>.png"
	 Solution:
		1) Check value of open files limit with $ ulimit -n
		2) Set new value for open files limit with $ ulimit -n 2048
	(issue #2913487)
   * 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
		#define SDL_BYTEORDER=1234
	says
		#define SDL_BYTEORDER=4321
	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.
148

149
 Linux
150 151 152
   * 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.
153
   * Intel 915/945/IDG graphics cards (EEE PCs, netbooks, etc): Mesa 7.9-devel has an issue which makes the game
154 155
   	 run slowly and consume a lot of memory. It is fixed by installing and launching 'driconf' and setting 
	 'Enable texture tiling' to 'No'.   
156
   * Due to hardware and software drivers, the "Gamma Correction" option may affect nothing.
157

158

159 160
5. Screen resolution
=====================
161
 There are a few hidden high resolution settings only accessible from command line. They are badly tested
ahuillet's avatar
ahuillet committed
162
 and thus generally considered to be buggy and are unsupported. They however can still be quite useful for
163
 many, especially for widescreen LCDs in fullscreen mode.
ahuillet's avatar
ahuillet committed
164

165
 To get an up-to-date list of available resolutions use "freedroidRPG -r99".
ahuillet's avatar
ahuillet committed
166

167
 Some known issues for the unsupported resolutions:
168 169 170
	- Portrait image in dialogs overflows its borders
	- Off center light radius
	- Incorrect text scrolling when talking to NPCs at times
171

172

173
6. FAQs
174
============
175 176
Miscellaneous FAQ:

177
	Q: Do I need to have Linux to try out FreedroidRPG?
178
	A: While using Linux is greatly recommended for the sanity of the system
179 180 181 182
	   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.
183 184

	Q: How can I subscribe/unsubscribe to the mailing list?
185 186
	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 
187 188
	   developer server and therefore usually only interesting for developers themselves.
	   In any case, you can subscribe, unsubscribe or change your membership options
189
			from the following web page:
190 191
	   http://sourceforge.net/mail/?group_id=54521

192

193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222
Graphics FAQ:

	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

	   freedroidRPG -n 

	   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,
	   i.e type

	   freedroidRPG -n

	   to start the game with OpenGL output disabled.  Graphics will revert to
	   pure SDL mode.
223 224 225 226 227 228 229 230 231 232
	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.
233 234 235 236 237 238 239

Sound FAQ:

	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
240
		    not a freedroidRPG related problem. In that case, you must install your
241 242 243 244 245 246 247 248
		    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:
249

250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269
		      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:

		      http://www.libsdl.org/projects/SDL_mixer/

		    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
		    recompile.

	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
270
	   like e.g. KDE start a sound daemon by default upon start up. To get rid of
271 272 273 274 275
	   the most common sound daemons, you can try (best as root)

	   killall -9 artsd
	   killall -9 esd
	   killall -9 yiff
276
	   killall -9 pulseaudio
277

278
	   After that, you might want to try freedroidRPG again. The sound lag should
279 280 281 282 283
	   not be present anymore.

Level Editor & Developer FAQ:

	Q: Is there a Level editor?
284 285 286 287 288 289
	A: Yes, we have a level editor integrated into FreedroidRPG. It can be accessed
       from the main menu or executing

		  freedroidRPG -e

       It has tooltips on every button to help you find your
290 291 292 293
       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?
294 295
	A: This is very simple when using Linux:
	      git clone https://gitlab.com/freedroid/freedroid-src.git
296
	   If you are using Windows we recommend using a tool like 
297
	      http://www.collab.net/downloads/giteye?CID=tigris
298
	   If you still run into problems, best again discuss it with the people on
299
	   the freedroid-discussion mailing list or ask for it on IRC channel as well.
300

301 302 303 304
	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.
305
	   Then the next thing to do is to get the latest development version of the game
306
	   from git, then to either make a small patch right away or to discuss anything
307 308
	   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
309 310 311 312
	   know what's going on and who is working on what.


7. Contact
ahuillet's avatar
ahuillet committed
313
===========
314
 Website       ................ http://www.freedroid.org
315
 Source project page   ........ https://gitlab.com/groups/freedroid
316
 IRC channel   ................ #freedroid on irc.freenode.net or
317
								http://webchat.freenode.net/?channels=freedroid (requires Javascript)
ahuillet's avatar
ahuillet committed
318
 Mailing list  ................ freedroid-discussion@lists.sourceforge.net
319
 Bug tracker   ................ http://bugs.freedroid.org/
stedevil's avatar
stedevil committed
320

ahuillet's avatar
ahuillet committed
321

322
8. License
ahuillet's avatar
ahuillet committed
323
===========
ahuillet's avatar
ahuillet committed
324 325
 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.