*************************************

*                                   *

*        Commander Genius           * 

*         (CloneKeenPlus)           *

*                                   *

*    (c)2008-2009  Gerstrong        *

*    (c)2009       Pickle           *

*    (c)2009       Tulip            *

*    (c)2009       DaVince

*    (c)2003-2005  Caitlin Shaw     *

*      Released under GNU/GPL       *

*                                   *

*        Prerelease v0.3            *

*                                   *

*************************************



Welcome to Commander Genius (aka CloneKeenPlus)



Commander Genius is an almost complete open-source clone of

the old classic DOS game, Commander Keen: Invasion of the

Vorticons by ID Software. Commander Genius requires the original game

data files to work. You can play all three episodes of the game and

some fanmade mods.



Commander Genius currently runs under Linux/X11 and Windows with SDL. 

In Mac OS X it also runs, but we are still looking for a distributor.

Check our website to get CG running on MacOs X Systems.



Commander Genius tries to mostly replicate the original game,

however there are also a number of improvements like:

- smoother scrolling

- MMX Support

- OpenGL Acceleration (through Hardware on some systems)

- better graphic effects (transparency, fading)

- 2-player support (still incomplete)

- high quality packs (for better sounds and music)

- games menu

- gamepad support (Assing your input devices as you want)



and much more!



To my knowledge this is the only released attempt at

writing a third-party Keen game that has reached this

stage of completeness.



Commander Genius is a new edition of CloneKeenPlus.

The reason I call it is because this version is compiled

with GNU C++ (previously GNU C). Some functions are 

now classes. The idea behind that is to provide a faster

and more stable program. Features like the implementation

of resolution changes was achieved through classes. 

Although it looks very similar the skeleton of the 

program is very different to the one in CloneKeen. 



The Commander Genius source code may be freely distributed and

modified as per the GPL, just please remember to give

credit to the original authors.



Commander Genius has been developed by Gerstrong togther 

with Pickle and Tulip implementing mayor improvements 

basing on the original source code of CloneKeen 

by Caitlin Shaw. Many thanks to him, 

for bringing us this great program.



Obviously it is not the original version of CloneKeen 

or any update. It is another version from a different

author. Other guys and me had many improvements and 

I tried to post them to the author. However, until 

today he has not responded. It is also known, that there

have not been updates of CloneKeen since 2005. It stayed

in beta 0.83.

 

I also would like to see those changes and improvements 

(or some of them) in his original project.

So I hope he will contact me some day. Most of the code is

based on his work and I acknowledge him a lot for that!





Setting up the data of the game:



 * Copy all of the data files from the original game(s) into the

   "./data" folder. This means all of the files with the extension

   .ck?. If you have the registered versions, you can play the whole game,

   otherwise download the shareware version and copy the data from it.

   You also can use mods.

 * If you want to use some patched mods, you can put them into subdirectories.

   You only have to modify the "games.cfg". 

 * Go into the Release folder and start the interpreter. If you have downloaded 

   the binary version of Commander Genius (for Windows, Linux32/64), then you 

   will find the executable in the root directory of the extracted game.

   Under Linux it is called "CommanderGenius", under Windows "CGenius.exe".    

 * If you want better sounds and music, please download the high quality pack (HQP).

   Extract its contents to the "data" directory together with your game data.

 

Howto use Commander Genius (If you didn't compile it):

 * Under Windows you start "cgenius.exe", under Linux "./CommanderGenius"



Howto compile it under Ubuntu (testet on Intrepid):

 * As I know which packages are needed, because I use Ubuntu, here is an extra guide. 

 * Install through Synaptic or "sudo apt-get install" following packages:

 	- build-essential

 	- libvorbis-dev

 	- libsdl1.2-dev

 	- libgl1-mesa-dev

 * extract my source code into "ckp".

 * cd into the "cpk/Release" subdirectory.

 * Run "make".

 * Then, you can run "CommanderGenius". Copy the files, wherever you want them together 

   with the data directory. "make install" does not work though.



Compiling CG on Linux/UNIX (other than Ubuntu):

 * If you want to compile the game, you need to have all the standard .

   development libraries and GNU C Compiler (at least version 4) installed 

   on your system.

 * You need to install the "vorbis", "SDL" and "Mesa/OpenGL" development libraries to get 

   it successfully compiled.

 * extract my source code to "ckp". 

 * cd into the "ckp/Release" subdirectory.

 * Run "make".

 * Then, you can run "CommanderGenius". Copy the files, 

   wherever you want them together with the data directory. 

   "make install" does not work though.

   

- VIDEO SYSTEM -

Being cross-platform, there are many methods to detect different resolutions on a system.

SDL uses one function to detect them but it doesn't seem to work properly on any system.



Gernerally it is not necessary, because many resolutions are already supported, but if 

you want to support other resolutions that you don't find in the options list just modify the

"resolutions.cfg" file by hand.



Caution: This is recommended for advanced users who now what they do. The team won't take responsabilities 

if you use a wrong configuration.



   

- GAME PLAY -

Before you play the game, you should take a look at the controls. Normally RAlt, Ctrl, Space and Enter

are the action keys. On some systems (specially Windows) it may be different. So check it out!



There are some keys, which cannot be changed and are part of the game



KEY        	ACTION             DESCRIPTION

LALT+Q	   				       Both Keys make you quit the game. Depending where you are in the game

LALT+F4		quit			   it will ask you, if you really want that

LALT+Enter	fullscreen/        This will change between fullscreen and window-mode

            windows			   

   



HINTS & SECRETS





- CHEAT CODES -



There are a full assortment of cheat codes available. Some cheats must first

be enabled with -cheat or through the options->game menu. C+T+SPACE and G+O+D will

always work.



KEY        	ACTION             DESCRIPTION

G+O+D	   	godmode			   In god mode you are invincible!

C+T+SPACE  	All Items          Gives all items, similar to the original.

LSHIFT+TAB 	Skip Level         Holding down this key you can skip levels and walk through tiles

							   on the map.

TAB			No clipping		   If you hold down this key you will disable clipping.

							   However, you cannot fall though floors. 



- SAVE/LOAD GAME -



The game can be saved by pressing F3 at any point during the game. The game will

be saved in the exact position it was left (unlike the original which only

allowed save at the map).



- DEMO -



Demo doesn't work until you record some. If you want to do that start the interpreter with "-rec" as argument.

For example: "CGenius.exe -rec -game1 -level01" and you should be off to go recording in game 1 level 1.



When you exit, the demo should be recorded. Restart the interpreter/game and wait a while at 

the tile screen and the game will cycle through several demos, an added feature not found on the original game.



You can also see them using the demo option in the main menu. Have fun!



- FAQ -

Q: When I change to opengl-mode, the screen gets white and I can't do anything! I have to kill the program.

   What can I do to restore the normal mode?



A: You can delete "cgenius.cfg" or change it the way you need it! Just put "opengl = 0" and it should normal

   with your previous settings. I'm going to fix that soon! The white screen means, that your graphic card

   doesn't support NPOT Textures, which is required. A video card with OpenGL 2.0 or later support should not

   have that problem anymore.

   

Q: Why not to use POT-Textures?

A: Because it requires more memory to write, and the game would get slower than with software rendering.

   I'm working on a new method to get it working with POT Textures and faster, but for now I cannot

   support it. 



Q: Commander Genius is slow? Please help!

A: You can increase the frameskip under settings->video or you can enable automatic frameskip, what is very

   recommended for any system. OpenGL may also help, but you must have a gfx-card that support NPOT-Textures.

   (OpenGL 2.0 or later). Try to lower the resolution, a lower filter, or decrease some stuff in the sound section.

   Stereo sound requires additional calculations than mono sound. There are many things you can do, to speed up

   the program.



- BUG! -



So you really found one or more bugs? Please report me those per e-mail (gerstrong@gmail.com)

and they will be checked. You can also submit them through the bug tracker at Sourceforge.net.

Depending on the priority, I'm going to fix them as soon as possible. 

Sending me the "CGLog.html" file might help tracking the error.



- ACKNOWLEDGEMENTS -

Many thanks to people who has helped me so far in this project with their

suggestions:





Sciz CT

DaVince

Commander Spleen

Malvineous

Tulip

Hans de Goede

Levelass (Keen EXE-Information)

ZidaneA (For his music tracks!)

Iv4n



Special thanks to Tulip, who has been supporting me all the time in testing

the Windows version of CKP. Without you it wouldn't be so great now! 



I'm sure, there were more people who helped me and I forgot to mention, but

many thanks to them, too.



Many thanks to all of you, the project has gone farther, and will be a nice

port to Commander Keen!

                            

****************************************************************************

For questions, comments, or updates to the source tree

please contact: gerstrong@gmail.com or go thru

SourceForge at http://clonekeenplus.sourceforge.net/

****************************************************************************