Download

From Post-Apocalyptic RPG wiki

This article describes all aspects of downloading the latest version of PARPG and how to get it running. All of the following steps are mandatory to get PARPG running on your system, therefore none of them can be skipped.

Installing Python & Python-libraries

As PARPG is written in Python, you'll need a working Python interpreter installed to run the game. Furthermore PARPG utilizes the pyyaml Python library and therefore does not run without it.

Linux

For Linux make sure that you install the latest release of the Python 2.5.x or 2.6.x branch. Py3k will NOT work. On most distros this should be the norm: open up a console and type python --version to check.

Instructions for installing PyYAML in linux can be found on the PyYAML wiki. Just download the sources, extract them and run as root:

python setup.py install

If you are using a debian based system you can grab it from your repositories with the following command.

sudo apt-get install python-yaml

Win32

1. Download and install ActivePython 2.6. Note: this is of course only needed if you don't have Python 2.6 installed yet. Python <= 2.5 as well >= 3.0 will NOT work.
2. Once you've installed Python, grab the latest release of PyYaml for Python 2.6 and install it: http://pyyaml.org/download/pyyaml/PyYAML-3.09.win32-py2.6.exe

Getting the game engine

PARPG is based on the open source game engine FIFE. In the current stage of development we're using the latest SVN snapshot of FIFE for PARPG. You'll need a Subversion client to get your hands on the latest version of the engine.

Linux

Firstly you'll need svn, so for Debian and variants (including Ubuntu) firstly:

sudo apt-get install subversion

After that:

svn co http://fife.svn.cvsdude.com/engine/trunk/ FIFE

Win32

1. If you don't have an SVN client installed yet, download and install TortoiseSVN.
2. Once you got your SVN client installed create a new folder for the game engine (called <FIFE> from now on) and enter (change directory to) it. Important: you should avoid non-ASCII characters in the FIFE directory path. The build process is known to be prone to errors caused by unconventional characters in the directory path.
3. Download the latest FIFE version by checking out the content of http://fife.svn.cvsdude.com/engine/trunk/ into <FIFE>.

Getting PARPG

Now we'll grab the PARPG specific code and assets from their Subversion repository. You can now check out the PARPG files into whatever directory you like as paths are NOT hardcoded anymore.

Linux

1. svn co http://parpg-svn.cvsdude.com/parpg/trunk/game/ parpg

Win32

1. Create a <parpg> folder somewhere on your HDD
2. Check out the latest version from http://parpg-svn.cvsdude.com/parpg/trunk/game/ into <parpg>

Building the game engine

As PARPG is based on the FIFE game engine, we'll need to build the engine from sourcecode first before we can actually test PARPG. Don't worry: it sounds way more complicated than it is in reality. Simply stick to the following steps, depending on the operating system that you're running.

Linux

1. Install the dependencies listed here: http://wiki.fifengine.de/Build_dependencies
2. CD into <FIFE> and run:

   scons ext && scons

3. Followed by

   sudo scons install-python

Mac OS X

by your self

1. use mac ports and scons
2. follow these instructions: http://wiki.fifengine.de/Building:Mac:Scons
3. do not use scons ext, just scons to build, use ports to install the libraries (same as linux)
4. There was some issue with this on 10.6 but I think it has been fixed since.

via mac ports

1. sudo port install fife
2. ...
3. profit
4. Notes: (only tested on 10.5.4) The only sticky bit is that it installs ALL the prereqs (including python26) into your ports directory (default /opt/local). It installs FIFE in the standard libraries for THIS installation.

That means you have to make sure that the mac ports python 26 is your default python (or ideally, only python - but with mac good luck with that, I think I have 4 pythons) and your sys.path points to the correct place.

Win32

1. Get the latest version of FIFE Win32 DevKit. The DevKit is a complete package to build FIFE from source on Win32 systems. It contains needed build tools (mingw, scons, swig), all dependencies as precompiled static and dynamic libraries and their corresponding headers. You can grab the latest version here:
   • Zip archive version: http://sourceforge.net/projects/fife/files/active/sdks/FIFE_Development_Kit_Jan2010.zip/download
   • Installer version: http://sourceforge.net/projects/fife/files/active/sdks/FIFE_Development_Kit_Jan2010.exe/download
2. Unpack / install the Win32 DevKit to <FIFE>\build\win32
3. Enter <FIFE>\build\win32\build_environments\scons\ and run install_engine.bat. FIFE will now get built using the mingw compiler that comes with the DevKit. Other compilers and IDEs are supported as well (Code::Blocks, MSVC2005, MSVC2008) but the build process for them is not explained in the detail here. If you would like to build FIFE with a different compiler, check out the build guides at the FIFE wiki: http://wiki.fifengine.de/Guides_%26_tutorials#Win32
4. Wait until the console window that has popped up after you ran logbuild_engine.bat has closed again. FIFE should have been successfully compiled now. A detailed build report is written to <FIFE>\build\win32\build_environments\scons\engine_build_log.txt

Starting PARPG

We're ready to start PARPG now! Caution: not much to see at this point as we're still moving towards a first techdemo release; so don't be disappointed due the lack of any gameplay at the moment.

Linux

1. cd <parpg>

2. run.py

Win32

1. Enter <FIFE>\build\win32\binaries\mingw and run oalinst.exe if you're running PARPG for the first time. This will install OpenAL drivers to ensure that the sound is working fine.
2. Enter <parpg> and run the Python script run.py by doubleclicking on it. It should be automatically associated with the Python interpreter of your system in case you're using ActivePython. If you're using a different Python distribution you might need to manually associate Python scripts with the interpreter on your system.