Here are some instructions for installing and using the game. You can also read the README which is included in the game but this documentation could be newer than the included.

• Requirements
• Tested
• Installation
• Start
• Controls
• FAQ (Frequently asked questions)
• Contact

To compile openshooter on windows, you need:

• Microsoft Visual C++ 6.0 or higher (if another compiler works then write to me)
• OpenGL and GLU library (should be included with the compiler)

To compile openshooter on Linux or Unix, you need:

• a C compiler (like gcc)
• GNU make (only Unix/Linux)
• GL library and header files
• GLU library and header files
• JPEG library and header files
• SDL library and header files

To compile openshooter on MacOS X, you need:

• Apple XCode
• OpenGL, Cocoa, Foundation and AppKit framework (should be included)
• SDL framework (download the development libraries at http://www.libsdl.org)

openshooter 0.3.1 was successfully tested on several operating systems:

• Windows 98 SE
• FreeBSD 5.1-RELEASE
• MacOS X 10.3.2

openshooter 0.3 was successfully tested on several operating systems:

• Windows 98 SE
• Windows 2000
• Windows XP
• FreeBSD 5.1-RELEASE
• Linux 2.4.23 (Debian Sid)

If you have another platform openshooter works on then write to me.

First you need to unpack the archive: To unpack a .tar.gz archive on Linux/Unix type: 'tar xzvf file.tar.gz'. To unpack a .tar.bz2 type 'tar xjvf file.tar.gz'. On Windows use a program like WinZip to unpack it. If you are using MacOS X then StuffIt Expander should expand the stuff for you ;-)
 
If you are using Windows then you should run the binary. If you really want to compile it then use the Microsoft Visual C++ compiler (if you can compile it on an other compiler then write to me). Simply click on the project file (.dsp) to open it it press CTRL+F5 to compile and run. There is currently no graphical installer. If you want to make one then write to me.
 
MacOS X users should run the binary, too. If you want to compile it, then double click on 'openshooter.xcode' and press Apple+B to compile it.
 
On Linux/Unix you can edit the Makefile if you want to change some pathes. Then type 'make' to compile, 'make install' as root to install it and 'make clean' to clean unnecessary binaries. To uninstall type 'make uninstall'.
 
If you run FreeBSD then use the Makefile.freebsd: type 'gmake -f Makefile.freebsd' to compile and 'gmake -f Makefile.freebsd install' to install.
 
If you have errors while compiling then check whether all required libraries are installed. If you still have errors then check the Makefile. If you still have errors then write to me ;-)

To start openshooter under Windows simply double click on 'openshooter.exe'.
 
On MacOS X double click on 'openshooter'.
 
On Linux/Unix type 'openshooter' in an xterm (or add it into your windowmanager menu)

a) Menu
select next menu item:	down arrow or 'S'
select previous menu item:	up arrow or 'W'
choose a menu item:	space or enter
exit:	escape
b) Walking around
turn left/right:	left/right arrow or mouse
look up/down:	page up/down or mouse
walk forward:	up arrow or 'W'
walk backward:	down arrow or 'S'
"strafe" left/right:	'A' or 'D'
c) Other
go in the console:	'X'
exit the console:	escape

Question:

• When I try to start openshooter I get 'Xlib: extension "GLX" missing on display ":0.0".'
• After starting openshooter I see the menu screen but I must press enter very long to enter the game and I get only 1 Frame per second.
• After starting openshooter I see nothing (the screen is black)

Answer:

• You have no 3D acceleration drivers installed. Do other OpenGL programs work (try glxgears on a Unix system)? Install some 3D acceleration drivers and send me an e-mail if it still doesn't work.

---

Question:

• After typing 'make' I get: '/bin/sh: line 1: sdl-config: command not found'
• After typing 'make' I get: 'gl_headers.h:38: SDL.h: No such file or directory'

Answer:

• The SDL library is not (fully) installed. You can get the SDL library from http://www.libsdl.org/index.php (Debian users should try apt-get install libsdl1.2-dev). If you are using FreeBSD try 'gmake -f Makefile.freebsd'.

---

Question:

• I have my GL/JPEG headers in /path/to/include!

Answer:

• Append -I/path/to/include to CFLAGS in the Makefile.

---

Question:

• The SDL/X11 library is in /path/to/lib!

Answer:

• Append -L/path/to/lib to LIBS in the Makefile.

---

Question:

• When compiling openshooter on MacOS X I get 'table of contents for archive: lib/libjpeg.a is out of date; rerun ranlib(1) (can't load from it)'

Answer:

• Go into the Terminal and go into the project directory. Then type 'ranlib lib/libjpeg.a'

You can contact me via e-mail (tom at eggdrop.ch) or ICQ (166514901).
Don't forget to visit my site www.eggdrop.ch
 
Have a lot of fun!