Download

This article describes all aspects of downloading latest stable PARPG release and how to get it running. It furthermore explains how to get your hands on the latest SVN revision of PARPG. All of the following steps are mandatory to get PARPG running on your system.

TODO: The mac OS X instructions need some work.

Techdemo 1 Release
The Techdemo 1 release of PARPG is based on FIFE SVN revision 3236. There isn't much to see at this point, but the user interface and basic dialogue system is up and running.

Install Prerequisites

 * 1) Install the latest release of the Python 2.6.x or 2.7.x branch. Python versions earlier than 2.6 and Py3k will NOT work. On most distros Python 2.6 should be the norm. To check which version of Python is running on your system open up a console and type:
 * 2) Install the PyYAML library. Instructions for installing PyYAML in linux can be found on the PyYAML wiki. Just download the sources, extract them and run as root:   If you are using a debian based system you can grab it from your repositories with the following command:   Alternatively, the easy_setup.py script can be used to automatically install PyYAML:

Build FIFE

 * 1) Install the dependencies listed here: http://wiki.fifengine.de/Build_dependencies;
 * 2) Download the FIFE source package from https://sourceforge.net/projects/parpg/files/techdemo1/fife_r3236_src.tar.gz/download and unpack the archive to a location of your choice (called  from now on);
 * 3) CD into  and run:
 * 4) You can optionally install FIFE using the command   If you choose not to install FIFE, you may have to manually configure PARPG to find your FIFE build (see below);

Download PARPG

 * 1) Download the PARPG source package from https://sourceforge.net/projects/parpg/files/techdemo1/parpg_td1_r522_src.tar.gz/download and unpack the archive to a location of your choice (called  from now on);
 * 2) If you chose not to install FIFE in a standard location, you may need to configure PARPG to find the FIFE binaries. To do this, create a blank config.py text file in /game/ and put the following lines in it:   where  is the location where you built FIFE.

PARPG is written completely in Python, so there is no need to build the sources.

Run PARPG

 * 1) Run   replacing  with the location where you unpacked the PARPG source package.

Windows

 * 1) Download https://sourceforge.net/projects/parpg/files/techdemo1/parpg_td1_r522_win32.exe/download;
 * 2) Start the installer and choose to download and install ActivePython 2.6, PyYAML for Python 2.6 & OpenAL if you haven't installed them yet;
 * 3) Install the FIFE package that ships with the PARPG win32 installer;
 * 4) Install PARPG to a location of your choice (called  from now on);

Run PARPG

 * 1) CD into the  directory 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.

By yourself

 * 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 macports

 * 1) Run

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.

SVN
The SVN version of PARPG relies upon the latest SVN snapshot of FIFE, so you'll need a Subversion client to get your hands on the latest version of the engine.

Install Prerequisites

 * 1) Install the latest release of the Python 2.6.x or 2.7.x branch. Python versions earlier than 2.6 and Py3k will NOT work. On most distros Python 2.6 should be the norm. To check which version of Python is running on your system open up a console and type:
 * 2) Install the PyYAML library. Instructions for installing PyYAML in linux can be found on the PyYAML wiki. Just download the sources, extract them and run as root:   If you are using a debian based system you can grab it from your repositories with the following command:   Alternatively, the easy_setup.py script can be used to automatically install PyYAML:

Install Subversion

 * 1) Install subversion, if it isn't already installed, either from your package manager or by downloading a binary package from http://subversion.tigris.org/;

Checkout and Build Latest FIFE From SVN

 * 1) CD into the directory where you want FIFE to reside and run:   This will checkout the latest FIFE revision and place it in a subdirectory under the current working directory;
 * 2) Install the dependencies listed here: http://wiki.fifengine.de/Build_dependencies;
 * 3) CD into  and run:
 * 4) You can optionally install FIFE to a standard location by running   however this is not required and may not be desirable since you'll likely be updating FIFE often;

Checkout Latest PARPG from SVN

 * 1) Run   to checkout the latest PARPG revision into a subdirectory under the current working directory;

Install Prerequisites

 * 1) Download and install ActivePython 2.7 if you don't already have Python 2.7 installed.
 * 2) Grab the latest release of PyYAML for Python 2.7 and install it: http://pyyaml.org/download/pyyaml/PyYAML-3.09.win32-py2.7.exe

Note: The FIFE Win32 DevKit needed to build FIFE from source on Windows currently only runs on the Python 2.7.x branch. Python versions earlier than 2.7 and Py3k will NOT work on Windows source builds.

Install Subversion Client

 * 1) If you don't have an SVN client installed yet, download and install TortoiseSVN;

Checkout and Build Latest FIFE From SVN

 * 1) Create a new folder for the game engine (called  from now on) and enter (change directory to) it. Important: you should avoid non-ASCII characters in the FIFE directory path as the FIFE build process is known to be prone to errors caused by unconventional characters in the directory path.
 * 2) Download the latest FIFE version by checking out the content of http://fife.svn.cvsdude.com/engine/trunk/ into  using your chosen SVN client;
 * 3) 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:
 * 4) * Zip archive version: http://sourceforge.net/projects/fife/files/active/sdks/FIFE_Development_Kit_Nov2010.zip/download;
 * 5) * Installer version: http://sourceforge.net/projects/fife/files/active/sdks/FIFE_Development_Kit_Nov2010.exe/download;
 * 6) Unpack / install the Win32 DevKit to \build\win32;
 * 7) Enter \build\win32\build_environments\scons\ and run:   FIFE will now be 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;
 * 8) Wait until the console window that has popped up after you ran install_engine.bat has closed again. FIFE should have been successfully compiled now;

Checkout Latest PARPG From SVN

 * 1) Create a new folder for PARPG (we'll refer to this folder as  from now on) and CD into it;
 * 2) Check out the latest version from http://parpg-svn.cvsdude.com/parpg/trunk/ into  using your SVN client;
 * 3) Enter \build\win32\binaries\mingw and run   if you're running PARPG for the first time. This will install OpenAL drivers to ensure that the sound is working fine;

Run PARPG

 * 1) Enter <PARPG> and run the Python script   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.

By yourself

 * 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) zenbitz confirms that rio_de_hola FIFE demo runs under OS X 10.6.5 using Xcode 3.2.5 and ONLY mac ports installed as the wiki link above details.  Note that this is post guichan 0.82 on mac ports.

Via macports

 * 1) Run

Note: (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.