Installation Guide for the Required Software


This page lists the details on how to install all the required software on Linux operating systems.

To run CSMonopoly, you need to have Python 2.4+,  Crystal Space, Python Imaging, CEGUI 0.5+, CEGUI 0.5+ Python Binding,  libPNG, and FreeImage installed. To run the map editor, you need to have Sun's JDK1.5+ and Jython 2.2+ installed.

To compile Crystal Space, you need to also have SWIG.

Now, some of these listed packages can be installed via your package manger such as apt or yum. In my experience, you should install Python, Python Imaging, libPNG and SWIG with your package manager, and if your package manger can install FreeImage, that would be good too. You might also be able to install JDK with your package manger, but I know not all Linux distributions let you do that.

I'm running Ubuntu, and I know that you can install Crystal Space and CEGUI using apt, but the installed Crystal Space does not have python plugins for CEGUI which the game needs for its Graphical User Interface, and that's a problem. It is also possible that my Ubuntu is rather out dated and the newer versions would have everything compiled. To make sure of this, you can just install them, then got to /usr/share/crystalspace-1.2/bindings/python/ to see if you have the files "pycscegui.py" and "_pycscegui.so", if you do, then you can probably skip the rest of this page.

However, if you don't, then here is what I would do to install FreeImage, CEGUI and Crystal Space -- this is the order in which they should be installed.

FreeImage

After downloading it from the website, you should unzip/untar it into a new directory, let's say it's /home/user/freeImage, then you just need to do the following:
  1. change to the directory that contains the file README.linux
  2. run "make" to compile everything,
  3. become the super user using the command "su"
  4. run "make install"
That's it.

CEGUI

After downloading it from the website, you should unzip/untar it into a new directory, let's say it's /home/user/cegui, then you just need to do the following:
  1. change to the directory that contains the executable file "configure"
  2. run "configure", this should config the build and tells the installer to install everything to you /usr/local directory, you should check the output of the script to make sure that it will compile with FreeImage
  3. run "make"
  4. become the super user using the command "su"
  5. run "make install"
That's it.

CEGUI Python Binding

After downloading it from the website, you should unzip/untar it into a new directory, let's say it's /home/user/cegui_python_binding, then you just need to do the following:
  1. change to the directory that contains the executable file "boostrap"
  2. run "bootstrap", this should generate all the usual configuration files
  3. run "configure", this should config the build and tells the installer to install everything to you /usr/local directory, you should check the output of the script to make sure that it will compile with FreeImage
  4. run "make"
  5. become the super user using the command "su"
  6. run "make install"
That's it.

Crystal Space


After downloading it from the website, you should unzip/untar it into a new directory, let's say it's /home/user/cs, then you just need to do the following:
  1. change to the directory that contains the executable file "configure"
  2. run "configure", this should config the build and tells the installer to install everything to you /usr/local directory, you should check the output of the script to make sure that it will compile with CEGUI and libPNG.
  3. run "make" to compile everything, this may take a while
  4. become the super user using the command "su"
  5. run "make install"
That's it.

Now, when I compiled crystal space on one of my computers, there was an error when it tried to compile the Java binding. If this happens, you can rerun the configure script with the "--with-out-java" option, and rerun "make".

CS should now be installed in /usr/local. Now, there should be a directory called "/usr/local/share/crystalspace-1.2/", go to that directory there should be a "bindings" subdirectory which in turn contains a "python" subdirectory which contains all the python bindings for CS. The Python bindings should contain the following files:

user@machine:~$ ls -l /usr/local/share/crystalspace-1.2/bindings/python/
total 28920
-rw-r--r-- 1 root root      544 2007-12-14 15:13 cshelper.py
-rw-r--r-- 1 root root   819731 2007-12-14 15:13 cspace.py
-rwxr-xr-x 1 root root  7227580 2007-12-14 15:13 _cspace.so
-rw-r--r-- 1 root root 20783544 2007-12-14 15:13 _cspace.so.dbg
-rw-r--r-- 1 root root     8367 2007-12-14 15:13 pyceguitest.py
-rw-r--r-- 1 root root     5153 2007-12-14 15:13 pycscegui.py
-rwxr-xr-x 1 root root    90096 2007-12-14 15:13 _pycscegui.so
-rw-r--r-- 1 root root   546684 2007-12-14 15:13 _pycscegui.so.dbg
-rw-r--r-- 1 root root     5403 2007-12-14 15:13 pysimp2.py
-rw-r--r-- 1 root root    11160 2007-12-14 15:13 pysimpcd.py
-rw-r--r-- 1 root root     1480 2007-12-14 15:13 pysimp.py
-rw-r--r-- 1 root root     3297 2007-12-14 15:13 tutorial0.py
-rw-r--r-- 1 root root     8350 2007-12-14 15:13 tutorial1.py
-rw-r--r-- 1 root root     9506 2007-12-14 15:13 tutorial2.py
-rw-r--r-- 1 root root     7598 2007-12-14 15:13 tutorial3.py

If you don't have the bolded files, then you have a problem. To test that everything is installed, run one of the tutorial?.py files.