                           +---------------+
                           | B A L A Z A R |
                           +---------------+

*** What is Balazar???

Balazar is a 3D adventure and roleplaying game!

Balazar is currently available only in French ; an English version
will arrive soon.



*** Help needed !

We espescially search for graphists and network coders.

We also search people for porting Balazar to other OS.



*** Requirement

 * Python 2.3.x (the latest is the best; tested on 2.3.4)
   INCLUDING the files for compiling python modules in C,
   e.g. , on Linux Mandrake, you need to install the package :
   'libpython2.3-devel-2.3.3-2mdk' (version numbers may change)

 * OpenGL (tested with Radeon DRI and NVidia dirvers; hardware
   acceleration is heavily advised, though not strictly required)

 * SDL (http://libsdl.org/)

 * Glew (http://glew.sf.net)

 * OpenAL (www.openal.org), PyOgg and PyVorbis (www.xiph.org) for
   sound support.

 * Cal3D <= 0.9.1 (cal3d.sourceforge.net), but NOT Cal3D 0.10 !
   
 * Twisted (http://twistedmatrix.com)

The Balazar tarball comes with all other dependencies (including Soya
3D and Tofu).



*** Installation

tar -xvzf Balazar-XXX.tar.gz
cd Balazar-XXX

 * Do:

python ./setup.py build

 * Do AS ROOT:

su
python ./setup.py install

You may get the following warning:

  warning: install: modules installed to '/usr/share/',
  which is not in Python's module search path (sys.path)
  -- you'll have to change the search path yourself

You can safely ignore the warning !



*** How to launch Balazar ?

Just type "balazar" on a console !

There's also a command line interface, see "balazar --help" for more
information.



*** Common troubles

 * Sound problems : OpenAL may not support your sound card (e.g.
   sound quality is poor, and you get some error printed on the
   console, about "native_blitbuffer: Assertion `0' failed" or "fcntl:
   Invalid argument"). Some people has obtained good result by forcing
   the use of esd. For that, edit ~/.openalrc, and write in it :
   
     (define devices '(esd))

 * ImportError: libGL.so.1: cannot handle TLS data
   This problem occurs typically on Debian with NVidia cards.
   Just install the "nvidia-glx" Debian package.


   
*** Contacts and website

jibalamy@free.fr

http://balazar.nekeme.net


