$Id: linux-build-howto.txt,v 1.3 2005/08/27 19:13:37 Platyna Exp $
PLANESHIFT LINUX BUILD HOWTO by Platyna.
1. Build requirements:
- CVS client - if you want to get source from CVS not from Planeshift Warehouse
repository (you may find it on your distribution FTP or CD. If you are using
Slackware you may find it on CD in the directory slackware/d/ or at
http://ftp://ftp.slackware.at).
- Jam build tool (can be found at:
http://ftp://ftp.perforce.com/pub/jam/, install it
system wide).
- LibCURL (for the updater, get from should be on your distribution FTP or CD).
2. Download source files:
- From CVS using following commands:
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/cal3d co cal3d
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/crystal co CS
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/cel co cel
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/planeshift co planeshift
Source from CVS comes from developers sandbox - it may not work, may not even compile.
Copy your CS and CEL directory to the directory with Planeshift source, so everything
is kept in one place. Here were are assuming it is /home/platyna/planeshift.
3. Prepare required enviroment by setting variables:
export CRYSTAL=/home/platyna/planeshift/CS
export CSCONFPATH=/home/platyna/planeshift/cel
export CEL=/home/platyna/planeshift/cel
Add these lines to your shell startup scripts which can be found in your home directory,
if you are using Bash (most likely you do) these files are named .bashrc or .bash_profile.
4. Compile Cal3d library.
I am always compiling it for system wide install and I strongly advice you to do the same.
./autogen.sh && ./configure --prefix=/usr && make
If you are using Slackware and you want to keep your system clean and easly update
cal3d (here is version 0.10.0) later, make yourself a Slackware package:
make install DESTDIR=/tmp/cal3d
su -
cd /tmp/cal3d
makepkg cal3d-0.10.0-`uname -m`-1.tgz
installpkg cal3d-0.10.0-`uname -m`-1.tgz
If not then only run:
su -
make install
5. Compile Crystal Space engine.
CS and CEL cannot be installed system wide and has to be in same dir where is the PS source.
If you are planning to trace bugs and help PS developers add to each configure a flag --enable-debug.
cd $HOME/planeshift/CS
./configure
jam libs
jam plugins
jam cs-config
6. Compile CEL.
cd $HOME/planeshift/cel
./autogen.sh
./configure
jam libs
jam plugins
jam cel-config
7. Compile Planeshift.
cd $HOME/planeshift
./autogen.sh
./configure
jam -a
8. Get current art and data files.
You have to edit the file updaterconfig.xml and make sure your mirror settings line looks like that:
then edit
section to get only data and art directories and run the updater:
./updater --auto
9. Fix planeshift.cfg:
Find a line (it should be at the beggining of the file):
PlaneShift.GUI.Imagefile = /planeshift/data/gui/imagelist.xml
Comment it out by putting a ; in the beggining of line and add below:
PlaneShift.GUI.Imagefile = /planeshift/data/gui/releaselist.xml
10. Edit psclient.cfg:
Replace line:
Planeshift.GUI.Skin.Ingame = cvs
With:
Planeshift.GUI.Skin.Ingame = default
Or:
Planeshift.GUI.Skin.Ingame = elves
Now you should be able to run the game by typing ./psclient.
Good luck.
Edit: Removed now obsolete info. All other instructions are ok. -Xordan