Home | Introduction | Installation | Troubleshooting | Script tutorial | Script basics | Script callbacks reference | Script API reference | Known bugs | Frequently Asked Questions

# Installation

## u61 and u61-data

### u61

The "u61" package contains:

- The u61 executable file. The one you have to run to play the game.
- A default theme. More themes are available in "u61-data".
- Some sample scripts. More scripts are available in "u61-data".

Basically, "u61" is the only required package since it contains the executable. It contains enough to give you a quick start with U61, and allows you to play without downloading tons of graphics with a 56K modem 8-)

If you download U61 from CVS, note that the CVS version does not contain any script or theme file.

### u61-data

The "u61-data" package contains:

- More themes. These cause the package to be quite big.
- More scripts. Any contributed script will be put there.
- Documentation. The docs are not included in the base "u61" package since someone who is interested in U61 is likely (in my opinion) to download the whole distribution.

Basically, "u61-data" is for those who like U61 and want more of it.

## Download instructions

U61 is freely available on the internet. As it is free software, you might also find it on a CD-Rom. If you do not have U61 and want to get it, try the following URLs:

- "http://www.ufoot.org/u61"
- "http://sourceforge.net/projects/u61"

You may also get "u61" and "u61-dat" from CVS, using the following commands:

    cvs -d:pserver:anonymous@cvs.u61.sourceforge.net:/cvsroot/u61 login
    cvs -z3 -d:pserver:anonymous@cvs.u61.sourceforge.net:/cvsroot/u61 co u61
    cvs -z3 -d:pserver:anonymous@cvs.u61.sourceforge.net:/cvsroot/u61 co u61-data

When you are prompted with a password, just press "ENTER".

## Required tools and libraries

### Libraries

These libraries are not required if you are installing a Windows binary distribution of U61, since everything is contained in the ".zip".

- zlib 1.1.3 : http://www.info-zip.org/pub/infozip/zlib/
- Hermes 1.3.1 : http://clanlib.org/
- Lua 3.2 : http://www.tecgraf.puc-rio.br/
- libMikMod 3.1.8 : http://mikmod.darkorb.net/
- ClanLib 0.5 : http://clanlib.org/

### Tools

These tools are required if you try to compile U61, if you got a binary distribution, you do not need them.

- C++ compiler : gcc under Linux, Visual C++ 6.0 under Windows.
- Python 1.5.2 : needed to compile the docs.
- LaTeX : needed to compiler the docs.

## Standard install under Linux

If there are no binaries for your Linux platform (which should be the case at the time I write this document since there are no binaries available at all), then you have to download a source tarball.

The files should be named:

- u61-?.?.?.tar.gz
- u61-data-?.?.?.tar.gz

U61 uses GNU autoconf. The install scripts I've prepared aren't perfect and do not check everything, but most of the problems should be detected. Let's say for instance that you are installing version 0.3.0. Once you got u61-0.3.0.tar.gz, type:

    gunzip u61-0.3.0.tar.gz
    tar xf u61-0.3.0.tar
    cd u61-0.3.0
    ./configure
    make
    su

Now you have to type your root password, then:

    make install
    exit
    u61

And if everything is all right, you should see the game running...

The installation of "u61-data" is pretty much the same, but keep in mind that:

- It makes no sense to install "u61-data" without "u61".
- "u61" and "u61-data" should have the same version. For instance u61-data-0.3.0.tar.gz is supposed to be installed with u61-0.3.0.tar.gz.
- If you change the default install directory, by using "configure --prefix=/usr/mydir/" for instance then you must use the same option with "u61" and "u61-data".

This documentation is also available on: www.ufoot.org.
Contact author: ufoot@ufoot.org