=How to create a new gametype=

I just want to share my experiences from creating Dynamicmatch as a c++ and orxonox newbie. Creating a new gametype is not very difficult - although you produce valuable content for Orxonox.

==Where are the concerning source files?==
../src/orxonox/gametypes[[BR]]
All gametypes are stored in this folder. The most important source files are Gametype.<cc/h> All gametypes inherit the Gametype class. So most of your coding work is just to rewrite some functions.

==Strategy==
Don't reinvent the wheel - try to copy and modify as much code from other gametypes as possible.
#Know what kind of gametype you want to create.
#Play existing gametypes and check which parts you want to adopt.
#Search in the concerning source files for code you can adopt.
#Start with the basic concept and add features later. (A Todo-List for the features would be nice.)

==Gametype-Level==
*Level are stored in "../data/levels". You need a level to test your gametype.
*For testing purposes just copy an existing Level and rename it.
*Don't forget to set "gametype = YourGameType" in the <level> tag.
*Put "create a level for my new gametype" on your todo list :-) Later you should try to create a level that is optimized for your new gametype.

==Change the AI-behaviour==
*The concerning file is in "../src/orxonox/controllers", called "ArtificialController.cc".
*You can make the bots stop shooting at certain targets by adding some lines of code in the "bool ArtificialController::sameTeam"-function as displayed above. The function should return true, if a bot shouldn't attack a certain target. (Since the AI-player is in the same "team".)

==Miscellaneous==
*Don't forget to add your gametype to the CMakeLists.txt or it won't compile.
*Compiling with the terminal. Go to the folder of your orxonox branch. The command for compiling is
{{{
cmake -j3}
}}.
*Don't forget to backup your code via svn. Open a terminal, go to your orxonox branch-folder and type
{{{
svn ci -m "reason for commitment or summary of latest changes"
}}} .
*Gamecommands: to add 2 new bots enter "addbots 2", to remove one of them enter "killbots 1". To display the scoreboard hit "F2".

== Important functions inherited from Gametype ==
||'''Function name'''||'''Effect'''||
||allowPawnHit||Whenever a player would recieve a hit this function is called - if the function returns false a hit is not possible||
||allowPawnDamage||Whenever a player would recieve damage this function is called - if the function returns false damage is not possible||
||allowPawnDeath||Whenever a player would die this function is called - if the function returns false death is not possible||
||playerEntered||what should happen, when a player entered the "battefield"?||
||playerLeft||what should happen, when a player left the "battefield"?||
||setConfigValues||interface for menue - to set the config values; ConfigValues are stored in a log file||
||tick||this function is called whenever a new frame is rendered; dt is the value how much time has passed since the last frame||