Basic PPS Tutorial

This is a basic tutorial for new PPS students to get familiar with our framework and build environment. The process is described for tardis here. If you use another system first go to the [download] page and make sure you have all dependencies installed.

Preparations

We check out the source and media repository and build for the first time

1. Go to / create your orxonox directory:

   mkdir ~/orxonox
   cd ~/orxonox
   

2. Now check out the latest revision of the media repository (you will probably be asked for a username and password once):

   svn co https://svn.orxonox.net/data/Media
   

3. Now get the latest revision of the trunk:

   svn co https://svn.orxonox.net/orxonox/trunk
   

4. Prepare to build:

   mkdir trunk/build
   cd trunk/build
   cmake ..
   

5. Now build for the first time (may take some time, further builds will be faster):

   make -j4  #-j4 means to create 4 parallel compile processes
   

6. Additionally you can use KDevelop3? as IDE to develop (if you don't want to use the console )

Start the game for the first time

7. Enter to the appropriate folder and start the game. You will see a menu popping up, just press the Standalone button.

   cd ~/orxonox/trunk
   ./run
   

Now we extend the Ship As you might have recognized some features of the Ship were missing:

• You can't fire (quite limitating)
• …

In order to change this there are a few steps required:

1. Open the files TutorialShip.cc and TurorialShip.h (in trunk/src/orxonox/objects) with your favorite IDE or console
2. (???)
3. …
4. Now edit the levelfile ( Media/levels/sample.oxw ) to use TutorialShip instead of SpaceShip instead
   • find the line where the the SpaceShip gets loaded
   • change SpaceShip to TutorialShip
   • add the new parameters (???)
   • save and close the levelfile

Now start the game again and do some fancy in-game-stuff

1. (???)