Spring - User contributions [en]

SetupGuide

2007-07-28T22:18:08Z

Quilted: /* TASClient */

== Linux Setup Guide ==

=== Which Version To Install ===

'''0.75b* has just been released. This affects some parts of this guide. Currently this guide is PARTIALLY updated. I will remove this notice when the pages are fully up to date.'''

To play online, you must have the same version as everyone else in the game.

Most people should get the current release, version 0.75b2. There are usually
between 100 and 200 people online in the lobby, and if you want to play with
them, you need this.

Older versions should only be interesting to software archeologists.

If you want to see the bleeding edge, you can checkout svn head of spring, but
it can not be used to play with people who have the release, so you are
practically limited to playing against nemo. This is mainly interesting for
people who want to contribute to the project, for testing, finding bugs and
fixing them, and implementing new features. Head can be seriously broken from
time to time, or not even compile.

=== Installing With Package Managers On Various Distributions ===

If there is a package for your distributions preferred package manager, it is
recommended to use it instead of compiling the program yourself from sources.

==== 0.74b3 For Etch (Debian 4.0 Stable) With APT ====

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb etch spring" >> /etc/apt/sources.list
aptitude update
aptitude install spring spring-data
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring </code> and
read-only data in <code>/usr/share/games/spring</code>.

==== 0.74b3 For Sid (Debian Unstable) With APT ====

The current .deb for Sid is broken, because it depends on some boost packages
of version 1.33 that are not installable on sid, which has only 1.34. A
slightly more complex way to install is necessary:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
echo "deb-src http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
aptitude update
aptitude install dpkg-dev devscripts
apt-get source spring
apt-get build-dep spring
cd spring-0.74~b3/
debuild -us -uc
debi
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring </code> and
read-only data in <code> /usr/share/games/spring</code>.

==== 0.74b3 For Ubuntu (any version) With APT ====

If you have boost 1.33, then all you need is:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
aptitude update
aptitude install spring spring-data
</pre></code>

If you have boost 1.34, you have to do it the same way as debian unstable:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
echo "deb-src http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
aptitude update
aptitude install dpkg-dev devscripts
apt-get source spring
apt-get build-dep spring
cd spring-0.74~b3/
debuild -us -uc
debi
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring</code> and
read-only data in <code>/usr/share/games/spring</code>.

==== 0.74b3 For Gentoo With Portage ====

Make an overlay for portage, download the ebuilds, and extract to populate the overlay:

<code><pre>
mkdir -p /usr/local/portage
echo 'PORTDIR_OVERLAY="/usr/local/portage"' >> /etc/make.conf
wget http://download.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2 ||
wget http://download2.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2
tar xjf spring-ebuilds-0.74-r3.tar.bz2 -C /usr/local/portage/
</pre></code>

If you are not running unstable (~x86), do the following:

<code><pre>
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-base-ota ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-xta ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-gundamrts ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-nanoblobs ~x86" >> /etc/portage/package.keywords
</pre></code>

Some packages need to be built with certain use flags set, this makes sure it happens:

<code><pre>
echo "media-libs/libsdl X opengl" >> /etc/portage/package.use
echo "dev-libs/boost threads" >> /etc/portage/package.use
emerge media-libs/libsdl dev-libs/boost
</pre></code>

Add yourself to the group <code>games</code>. Don't do this as root, do this as
the user you normally use to play (you have to relogin afterwards to make it
work):

<code><pre>
gpasswd -a $(whoami) games
</pre></code>

And finally emerge spring itself, along with some datafile packages (ignore the
use flags for spring ebuild):

<code><pre>
emerge unzip spring spring-base-ota spring-mod-xta spring-mod-gundamrts
emerge spring-mod-nanoblobs
etc-update
</pre></code>

Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and
read-only data in <code>/usr/share/games/spring</code>.

=== Installing 0.74b3 From Source ===

If there is no package tailored for your distribution, you have to install from sources manually. Doing this for distributions where packages are available is not recommended.

==== Getting The Source ====

You can either download the source as a 4.7MB tarball (recommended) or get it
from the subversion repository. Either way, the result is the same for 0.74b3.

===== Downloading A Tarball =====

<code><pre>
cd /tmp
wget http://spring.clan-sy.com/dl/spring_0.75b2_src.tar.bz2
tar xjf spring_0.75b2_src.tar.bz2
cd spring_0.75b2
</pre></code>

===== Checking Out From Subversion =====

<code><pre>
aptitude install subversion # if you are not on debian, figure it out
svn co https://taspring.clan-sy.com/svn/spring/tags/taspring_0.74b3 /tmp/spring_0.74b3
cd /tmp/spring_0.74b3
</pre></code>

==== Getting The Dependencies ====

For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the
following to be the minimal set that is necessary to get. I have not tested
with any version of Ubuntu, but the line is probably almost identical if not
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007 WORKS.

<code><pre>
aptitude install scons build-essential zlib1g-dev libfreetype6-dev
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev
aptitude install python2.4-dev zip
aptitude install libsablevm1-dev
</pre></code>

This has been tested to work with a clean install of gentoo 2007.0:

<code><pre>
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost
emerge media-libs/devil app-arch/zip
</pre></code>

Users of other distributions should be able to figure out the correct package
names from this. The scons configure will whine if you forget something, but it
does not check if you remembered to install zip, even though you still need it.

==== Building And Installing ====

The build will spew out warnings like the following, which you can safely ignore:

<code><pre>
warning: division by zero
warning: 'q' may be used uninitialized in this function
</pre></code>

Configure, build and install:

<code><pre>
scons configure
scons
scons install
mkdir -p /etc/spring
echo '$HOME/.spring' > /etc/spring/datadir
</pre></code>

Your paths are: Spring executable in <code>/usr/local/games/spring</code> and
read-only data in <code>/usr/local/share/games/spring</code>.

== Finalizing installation ==

Now all the things you needed to run as root have been done. Some stuff needs to be done by the user who is going to play spring.

I'm assuming bash here, but you can use anything you like to do it of course.

=== Making Data Directories ===

<code><pre>
mkdir -p ~/.spring/{base,maps,mods}
</pre></code>

=== Getting Maps ===

You need at least one map to succesfully run spring.

Go to [http://spring.unknown-files.net/category/13/Maps/ Unknown Files, Map Section] and download at least one map. Save it under ~/.spring/maps/ without unpacking the file in any way.

Hint: If you know the map name you want, there is a Quick Search in the top right corner of the page. Just write a part of the name, like one word, and you'll easily find what you were looking for.

=== Getting Mods ===

You need at least one mod to successfully run spring.

Go to [http://spring.unknown-files.net/category/14/Mods/ Unknown Files, Mod Section] and download at least one mod. Save it under ~/.spring/mods/ without unpacking the file in any way.

Hint: If you know the mod name you want, there is a Quick Search in the top right corner of the page. Just write a part of the name, like one word, and you'll easily find what you were looking for.

If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:

<code><pre>
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip
unzip -d ~/.spring/base base-ota-content.zip
</pre></code>

Note that you need to own a copy of Total Annihilation, to download this file legally.

If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.

=== Editing Settings ===
Defaults should be usable, so you can ignore this until you want to maximise your eye candy or fps :)

When you run spring the first time, it creates ~/.springrc which contains all the settings. It is a simple text file with name=value lines, most of which are pretty obvious and can be edited by hand.

If you want a tool for editing the file, you can use Kloot's [http://members.chello.nl/mjtobi/Settings++.tar.gz Settings++]. Untar it anywhere and open it by typing "./Settings++" and edit away.

=== Using LuaUI ===

Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.

Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI.

Lua scripts for LuaUI can be found in [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section].

TODO need more stuff here.

=== Installing Lobby Client ===

To setup online games, you need a lobby client. There are several options to choose from.

You can also use lobby client to setup single player matches against the AI. TODO more information about setting up tasclient to play against AI.

==== Omni ====

This project has been abandoned, and you should not use it.

==== UnityLobby ====

This project has been abandoned, and you should not use it.

==== SpringLobby ====

This project is very promising, but not yet ready enough for production use.

Homepage of SpringLobby is [http://tc.serveftp.net/trac here].

==== AFLobby ====

This project is very promising, but is still in beta development. However, is usable for online multiplayer. See forum thread: http://spring.clan-sy.com/phpbb/viewtopic.php?t=8691

==== TASClient ====

This is a windows program, but it works just fine under wine in linux, and can be used together with native linux spring. I use it myself and recommend to use this temporarily until we all can migrate to SpringLobby or AFLobby.

The only two downsides in using this are that you have to use wine (which should not be a big problem) and your rank won't increase as long as you use it (also because of win-linux binary interaction).

Download the installer of Spring for Windows, and run it in wine:

<code><pre>
wget http://spring.clan-sy.com/dl/spring_0.75b2.exe
wine spring_0.75b2.exe
</pre></code>

No configuration of wine should be needed, if your distribution is sane.

Complete the install, and let it install to the default location, which is Program Files\Spring.

Assuming you completed the earlier step of creating the data directories, now we need to link the windows and linux data together:

<code><pre>
WINESPRING=~/.wine/drive_c/Program\ Files/Spring
NATIVE=~/.spring/maps

touch "${WINESPRING}/script.txt"
ln -s "${WINESPRING}/script.txt ${NATIVE}/script.txt"

rm -r "${WINESPRING}/maps"
ln -s "${NATIVE}/maps ${WINESPRING}/maps"

rm -r "${WINESPRING}/mods"
ln -s "${NATIVE}/mods ${WINESPRING}/mods"

rm -r "${WINESPRING}/base"
ln -s "${NATIVE}/base ${WINESPRING}/base"
</pre></code>

For the windows-TASClient to be able to launch native linux spring, we need a wrapper exe in between them. Source code for wrapper exe is:

<code><pre>
#include <windows.h>
#include <stdio.h>
#include <tchar.h>

#define NATIVE_SPRING_LOCATION TEXT("/usr/games/spring")
#define SPRING_VERSION_REPLY "Spring 0.75b2"

int main (int argc, char **argv)
{
if (argc > 1 && !strcmp(argv[1], "/V"))
{
puts(SPRING_VERSION_REPLY);
return 0;
}

STARTUPINFO si;
ZeroMemory( &si, sizeof(si) );
si.cb = sizeof(si);

PROCESS_INFORMATION pi;
ZeroMemory( &pi, sizeof(pi) );

// Start the child process.
if (!CreateProcess(
_tcsdup(NATIVE_SPRING_LOCATION), // No module name (use command line)
GetCommandLine(), // Command line
NULL, // Process handle not inheritable
NULL, // Thread handle not inheritable
FALSE, // Set handle inheritance to FALSE
0, // No creation flags
NULL, // Use parent's environment block
NULL, // Use parent's starting directory
&si, // Pointer to STARTUPINFO structure
&pi)) // Pointer to PROCESS_INFORMATION structure
{
printf( "CreateProcess failed (%d).\n", GetLastError() );
return 1;
}

// Wait until child process exits. Wine actually does not know how to wait
// for native linux process, so this will return instantly and your gametime
// counter does not increase so you don't get any rank.
WaitForSingleObject( pi.hProcess, INFINITE );

// Close process and thread handles.
CloseHandle( pi.hProcess );
CloseHandle( pi.hThread );

return 0;
}
</pre></code>

You might need to modify the define-lines in the beginning to match your location and version. Remember, the version reply must be exactly right, or your game just breaks totally in multiplayer or you can't even login to lobby server.

Save this code to spring.cc for example, and then we need to install a windows-crosscompiler and compile a windows binary from it inside our linux box like this:

<code><pre>
aptitude install mingw32
i586-mingw32msvc-g++ spring.cc -o ~/.wine/drive_c/Program\ Files/Spring/spring.exe
</pre></code>

This assumed debian for installing the crosscompiler, but mingw32 is probably simple to install on other distributions as well.

TODO should provide binary packages for this launcher, as all people don't have the possibility to set up cross compiler.

Then you should make a script for launching TASClient. The script can be named tasclient for example, and just put it somewhere in your path and make it executable. The script code is:

<code><pre>
#!/usr/bin/env sh
cd ~/.wine/drive_c/Program\ Files/Spring
wine TASClient.exe
</pre></code>

Now you should be able to type tasclient on the command line, and the lobby appears. '''This cd operation is necessary. If your working directory is not the same as TASClient.exe's location, it will just give access violations to you.'''

Note that every time when you have added new maps, the lobby client caches them and this will take some time, or a long time if you downloaded many maps since last time. Just wait patiently.

Then you should register an account and login with it, and you should be ready to join an online multiplayer game from the list that appears.

It's likely that you don't have the correct map or mod at this point, so just get them and join the game. You don't need to restart your lobby client after downloading the files.

It's recommended that you spectate a couple of high rank games first, to get some idea of how the game should be played. Some hosts don't allow spectators, but most do.

=== Troubleshooting ===

==== game dies with sounds/button9.wav "cant find wav file" ====

This or any similar error of not being able to find a specific file are usually because the mod you are using needs ota content, download & install as explained earlier in this document.

==== Problems With Boost 1.34 ====

If you get an error message when starting spring, which looks like the following but can be from any tdf file and the line numbers don't need to match either:

<code><pre>
Parse error in gamedata/explosion_alias.tdf at line 48 column 34 near
</pre></code>

Then you need this patch:


<code><pre>
Index: rts/System/tdf_grammar.hpp
===================================================================
--- rts/System/tdf_grammar.hpp (revision 1919)
+++ rts/System/tdf_grammar.hpp (revision 3798)
@@ -99,6 +99,7 @@
section(self.section)
| gather_junk_line // if this rule gets hit then section did not consume everything,
)
+ >> end_p
;

gather_junk_line =
</pre></code>


Save it to a file and go to spring source directory and say:

<code><pre>
patch -p0 < mypatchfilename
</pre></code>

You need to have patch installed to be able to do this. After successfully patching, compile and install.

==== If You Still Have Problems ====

Join to #taspring on Freenode and tell me (semi_) that you have problems with installing, and I'll try to improve this guide to solve your problem, if I have time.

However, generic linux problems not really related to installing this should be asked elsewhere.

Prepare to tell me your distribution, which installation method you used, and what exactly is the error. Don't ask if I'm here or not, just state your problem there and I'll look into it when I come back.

Other common problems and solutions coming soon.

==== Can't See Configure Options Before Configuring ====

If you want to see the configure options, because of a bug in the buildsystem you have to have spring configured first. But if configure fails, you are out of luck. So I have listed the options here:

<code><pre>
$ scons --help
scons: Reading SConscript files ...
make: Nothing to be done for `all'.
Succes building streflop!
Updating bitmaps.sdz
Updating springcontent.sdz
scons: done reading SConscript files.

platform: Set to linux, freebsd or windows
default: None
actual: linux

debug: Set to yes to produce a binary with debug information
default: 0
actual: 0

syncdebug: Set to yes to enable the sync debugger
default: False
actual: False

optimize: Enable processor optimizations during compilation
default: 1
actual: 2

profile: Set to yes to produce a binary with profiling information
default: False
actual: False

cpppath: Set path to extra header files
default: []
actual:

libpath: Set path to extra libraries
default: []
actual:

fpmath: Set to 387 or SSE on i386 and AMD64 architectures
default: 387
actual: 387

prefix: Install prefix used at runtime
default: /usr/local
actual: /usr/local

installprefix: Install prefix used for installion
default: /usr/local
actual: /usr/local

datadir: Data directory (relative to prefix)
default: share/games/spring
actual: share/games/spring

bindir: Directory for executables (rel. to prefix)
default: games
actual: games

libdir: Directory for AI plugin modules (rel. to prefix)
default: lib/spring
actual: lib/spring

strip: Discard symbols from the executable
(only when neither debugging nor profiling)
default: True
actual: True

disable_avi: Set to no to turn on avi support
default: False on windows, True otherwise
actual: True

use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation
default: False
actual: False

use_mmgr: Use memory manager
default: False
actual: False

cachedir: Cache directory (see scons manual)
default: None
actual:

Use scons -H for help about command-line options.
</pre></code>

==== LuaUI Crash Ingame ====

LuaUI can crash during game, because some lua script you use has a bug. 0.75 should be resistant to this problem, but 0.74b3 is not. After crash, you won't see the bottom left tooltip box and top right resource bar anymore. Fear not, help is near:

<code><pre>
/resbar 1
/tooltip 1
</pre></code>

These might not be necessary in 0.75 anymore at all.

Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.

=== Tips ===

* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.

* Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo) <code>(define devices '(alsa)) (define speaker-num 2) (define alsa-out-device "hw:0,0") (define alsa-in-device "hw:0,0")</code> Adventurous people with an emu10k1 based card (sblive) can try the accelerated openal version. http://www.lost.org.uk/openal.html , don't submit audiobugs if you do.

* If you really can't figure out how to get spring compiled, or you think there's a bug in the code or the buildsystem...
:* Just poke any developer on IRC:
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].

''' [[Main_Page|<- Back to Main page]]'''

[[Category:Linux Port]][[Category:Playing]]

SetupGuide

2007-07-28T20:13:30Z

Quilted: /* Getting The Dependencies */

== Linux Setup Guide ==

=== Which Version To Install ===

'''0.75 has just been released. This affects some parts of this guide. Currently this guide is NOT updated. I will remove this notice when the pages are up to date.'''

To play online, you must have the same version as everyone else in the game.

Most people should get the current release, version 0.75b2. There are usually
between 100 and 200 people online in the lobby, and if you want to play with
them, you need this.

Older versions should only be interesting to software archeologists.

If you want to see the bleeding edge, you can checkout svn head of spring, but
it can not be used to play with people who have the release, so you are
practically limited to playing against nemo. This is mainly interesting for
people who want to contribute to the project, for testing, finding bugs and
fixing them, and implementing new features. Head can be seriously broken from
time to time, or not even compile.

=== Installing With Package Managers On Various Distributions ===

If there is a package for your distributions preferred package manager, it is
recommended to use it instead of compiling the program yourself from sources.

==== 0.74b3 For Etch (Debian 4.0 Stable) With APT ====

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb etch spring" >> /etc/apt/sources.list
aptitude update
aptitude install spring spring-data
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring </code> and
read-only data in <code>/usr/share/games/spring</code>.

==== 0.74b3 For Sid (Debian Unstable) With APT ====

The current .deb for Sid is broken, because it depends on some boost packages
of version 1.33 that are not installable on sid, which has only 1.34. A
slightly more complex way to install is necessary:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
echo "deb-src http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
aptitude update
aptitude install dpkg-dev devscripts
apt-get source spring
apt-get build-dep spring
cd spring-0.74~b3/
debuild -us -uc
debi
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring </code> and
read-only data in <code> /usr/share/games/spring</code>.

==== 0.74b3 For Ubuntu (any version) With APT ====

If you have boost 1.33, then all you need is:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
aptitude update
aptitude install spring spring-data
</pre></code>

If you have boost 1.34, you have to do it the same way as debian unstable:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
echo "deb-src http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
aptitude update
aptitude install dpkg-dev devscripts
apt-get source spring
apt-get build-dep spring
cd spring-0.74~b3/
debuild -us -uc
debi
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring</code> and
read-only data in <code>/usr/share/games/spring</code>.

==== 0.74b3 For Gentoo With Portage ====

Make an overlay for portage, download the ebuilds, and extract to populate the overlay:

<code><pre>
mkdir -p /usr/local/portage
echo 'PORTDIR_OVERLAY="/usr/local/portage"' >> /etc/make.conf
wget http://download.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2 ||
wget http://download2.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2
tar xjf spring-ebuilds-0.74-r3.tar.bz2 -C /usr/local/portage/
</pre></code>

If you are not running unstable (~x86), do the following:

<code><pre>
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-base-ota ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-xta ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-gundamrts ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-nanoblobs ~x86" >> /etc/portage/package.keywords
</pre></code>

Some packages need to be built with certain use flags set, this makes sure it happens:

<code><pre>
echo "media-libs/libsdl X opengl" >> /etc/portage/package.use
echo "dev-libs/boost threads" >> /etc/portage/package.use
emerge media-libs/libsdl dev-libs/boost
</pre></code>

Add yourself to the group <code>games</code>. Don't do this as root, do this as
the user you normally use to play (you have to relogin afterwards to make it
work):

<code><pre>
gpasswd -a $(whoami) games
</pre></code>

And finally emerge spring itself, along with some datafile packages (ignore the
use flags for spring ebuild):

<code><pre>
emerge unzip spring spring-base-ota spring-mod-xta spring-mod-gundamrts
emerge spring-mod-nanoblobs
etc-update
</pre></code>

Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and
read-only data in <code>/usr/share/games/spring</code>.

=== Installing 0.74b3 From Source ===

If there is no package tailored for your distribution, you have to install from sources manually. Doing this for distributions where packages are available is not recommended.

==== Getting The Source ====

You can either download the source as a 4.7MB tarball (recommended) or get it
from the subversion repository. Either way, the result is the same for 0.74b3.

===== Downloading A Tarball =====

<code><pre>
cd /tmp
wget http://spring.clan-sy.com/dl/spring_0.75b2_src.tar.bz2
tar xjf spring_0.75b2_src.tar.bz2
cd spring_0.75b2
</pre></code>

===== Checking Out From Subversion =====

<code><pre>
aptitude install subversion # if you are not on debian, figure it out
svn co https://taspring.clan-sy.com/svn/spring/tags/taspring_0.74b3 /tmp/spring_0.74b3
cd /tmp/spring_0.74b3
</pre></code>

==== Getting The Dependencies ====

For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the
following to be the minimal set that is necessary to get. I have not tested
with any version of Ubuntu, but the line is probably almost identical if not
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007 WORKS.

<code><pre>
aptitude install scons build-essential zlib1g-dev libfreetype6-dev
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev
aptitude install python2.4-dev zip
aptitude install libsablevm1-dev
</pre></code>

This has been tested to work with a clean install of gentoo 2007.0:

<code><pre>
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost
emerge media-libs/devil app-arch/zip
</pre></code>

Users of other distributions should be able to figure out the correct package
names from this. The scons configure will whine if you forget something, but it
does not check if you remembered to install zip, even though you still need it.

==== Building And Installing ====

The build will spew out warnings like the following, which you can safely ignore:

<code><pre>
warning: division by zero
warning: 'q' may be used uninitialized in this function
</pre></code>

Configure, build and install:

<code><pre>
scons configure
scons
scons install
mkdir -p /etc/spring
echo '$HOME/.spring' > /etc/spring/datadir
</pre></code>

Your paths are: Spring executable in <code>/usr/local/games/spring</code> and
read-only data in <code>/usr/local/share/games/spring</code>.

== Finalizing installation ==

Now all the things you needed to run as root have been done. Some stuff needs to be done by the user who is going to play spring.

I'm assuming bash here, but you can use anything you like to do it of course.

=== Making Data Directories ===

<code><pre>
mkdir -p ~/.spring/{base,maps,mods}
</pre></code>

=== Getting Maps ===

You need at least one map to succesfully run spring.

Go to [http://spring.unknown-files.net/category/13/Maps/ Unknown Files, Map Section] and download at least one map. Save it under ~/.spring/maps/ without unpacking the file in any way.

Hint: If you know the map name you want, there is a Quick Search in the top right corner of the page. Just write a part of the name, like one word, and you'll easily find what you were looking for.

=== Getting Mods ===

You need at least one mod to successfully run spring.

Go to [http://spring.unknown-files.net/category/14/Mods/ Unknown Files, Mod Section] and download at least one mod. Save it under ~/.spring/mods/ without unpacking the file in any way.

Hint: If you know the mod name you want, there is a Quick Search in the top right corner of the page. Just write a part of the name, like one word, and you'll easily find what you were looking for.

If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:

<code><pre>
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip
unzip -d ~/.spring/base base-ota-content.zip
</pre></code>

Note that you need to own a copy of Total Annihilation, to download this file legally.

If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.

=== Editing Settings ===
Defaults should be usable, so you can ignore this until you want to maximise your eye candy or fps :)

When you run spring the first time, it creates ~/.springrc which contains all the settings. It is a simple text file with name=value lines, most of which are pretty obvious and can be edited by hand.

If you want a tool for editing the file, you can use Kloot's [http://members.chello.nl/mjtobi/Settings++.tar.gz Settings++]. Untar it anywhere and open it by typing "./Settings++" and edit away.

=== Using LuaUI ===

Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.

Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI.

In 0.74b3, when you host games, you might crash more often when you use Lua, but this should be fixed in 0.75.

Lua scripts for LuaUI can be found in [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section].

In 0.74b3, you have to move LuaUI directory from your read-only data dir to your read-write data dir, to be able to customize it.

TODO need more stuff here.

=== Installing Lobby Client ===

To setup online games, you need a lobby client. There are several options to choose from.

You can also use lobby client to setup single player matches against the AI. TODO more information about setting up tasclient to play against AI.

==== Omni ====

This project has been abandoned, and you should not use it.

==== UnityLobby ====

This project has been abandoned, and you should not use it.

==== SpringLobby ====

This project is very promising, but not yet ready enough for production use.

Homepage of SpringLobby is [http://tc.serveftp.net/trac here].

==== AFLobby ====

This project is very promising, but is still in beta development. However, is usable for online multiplayer. See forum thread: http://spring.clan-sy.com/phpbb/viewtopic.php?t=8691

==== TASClient ====

This is a windows program, but it works just fine under wine in linux, and can be used together with native linux spring. I use it myself and recommend to use this temporarily until we all can migrate to SpringLobby or AFLobby.

The only two downsides in using this are that you have to use wine (which should not be a big problem) and your rank won't increase as long as you use it (also because of win-linux binary interaction).

Download the installer of Spring for Windows, and run it in wine:

<code><pre>
wget http://spring.clan-sy.com/dl/spring_0.74b3.exe
wine spring_0.74b3.exe
</pre></code>

No configuration of wine should be needed, if your distribution is sane.

Complete the install, and let it install to the default location, which is Program Files\Spring.

Assuming you completed the earlier step of creating the data directories, now we need to link the windows and linux data together:

<code><pre>
touch ~/.wine/drive_c/Program\ Files/Spring/script.txt
ln -s ~/.wine/drive_c/Program\ Files/Spring/script.txt ~/.spring/script.txt

rm -r ~/.wine/drive_c/Program\ Files/Spring/maps
ln -s ~/.spring/maps ~/.wine/drive_c/Program\ Files/Spring/maps

rm -r ~/.wine/drive_c/Program\ Files/Spring/mods
ln -s ~/.spring/mods ~/.wine/drive_c/Program\ Files/Spring/mods

rm -r ~/.wine/drive_c/Program\ Files/Spring/base
ln -s ~/.spring/base ~/.wine/drive_c/Program\ Files/Spring/base
</pre></code>

For the windows-TASClient to be able to launch native linux spring, we need a wrapper exe in between them. Source code for wrapper exe is:

<code><pre>
#include <windows.h>
#include <stdio.h>
#include <tchar.h>

#define NATIVE_SPRING_LOCATION TEXT("/usr/games/spring")
#define SPRING_VERSION_REPLY "Spring 0.74b3"

int main (int argc, char **argv)
{
if (argc > 1 && !strcmp(argv[1], "/V"))
{
puts(SPRING_VERSION_REPLY);
return 0;
}

STARTUPINFO si;
ZeroMemory( &si, sizeof(si) );
si.cb = sizeof(si);

PROCESS_INFORMATION pi;
ZeroMemory( &pi, sizeof(pi) );

// Start the child process.
if (!CreateProcess(
_tcsdup(NATIVE_SPRING_LOCATION), // No module name (use command line)
GetCommandLine(), // Command line
NULL, // Process handle not inheritable
NULL, // Thread handle not inheritable
FALSE, // Set handle inheritance to FALSE
0, // No creation flags
NULL, // Use parent's environment block
NULL, // Use parent's starting directory
&si, // Pointer to STARTUPINFO structure
&pi)) // Pointer to PROCESS_INFORMATION structure
{
printf( "CreateProcess failed (%d).\n", GetLastError() );
return 1;
}

// Wait until child process exits. Wine actually does not know how to wait
// for native linux process, so this will return instantly and your gametime
// counter does not increase so you don't get any rank.
WaitForSingleObject( pi.hProcess, INFINITE );

// Close process and thread handles.
CloseHandle( pi.hProcess );
CloseHandle( pi.hThread );

return 0;
}
</pre></code>

You might need to modify the define-lines in the beginning to match your location and version. Remember, the version reply must be exactly right, or your game just breaks totally in multiplayer or you can't even login to lobby server.

Save this code to spring.cc for example, and then we need to install a windows-crosscompiler and compile a windows binary from it inside our linux box like this:

<code><pre>
aptitude install mingw32
i586-mingw32msvc-g++ spring.cc -o ~/.wine/drive_c/Program\ Files/Spring/spring.exe
</pre></code>

This assumed debian for installing the crosscompiler, but mingw32 is probably simple to install on other distributions as well.

TODO should provide binary packages for this launcher, as all people don't have the possibility to set up cross compiler.

Then you should make a script for launching TASClient. The script can be named tasclient for example, and just put it somewhere in your path and make it executable. The script code is:

<code><pre>
#!/usr/bin/env sh
cd ~/.wine/drive_c/Program\ Files/Spring
wine TASClient.exe
</pre></code>

Now you should be able to type tasclient on the command line, and the lobby appears. '''This cd operation is necessary. If your working directory is not the same as TASClient.exe's location, it will just give access violations to you.'''

Note that every time when you have added new maps, the lobby client caches them and this will take some time, or a long time if you downloaded many maps since last time. Just wait patiently.

Then you should register an account and login with it, and you should be ready to join an online multiplayer game from the list that appears.

It's likely that you don't have the correct map or mod at this point, so just get them and join the game. You don't need to restart your lobby client after downloading the files.

It's recommended that you spectate a couple of high rank games first, to get some idea of how the game should be played. Some hosts don't allow spectators, but most do.

=== Troubleshooting ===

==== game dies with sounds/button9.wav "cant find wav file" ====

This or any similar error of not being able to find a specific file are usually because the mod you are using needs ota content, download & install as explained earlier in this document.

==== Problems With Boost 1.34 ====

If you get an error message when starting spring, which looks like the following but can be from any tdf file and the line numbers don't need to match either:

<code><pre>
Parse error in gamedata/explosion_alias.tdf at line 48 column 34 near
</pre></code>

Then you need this patch:


<code><pre>
Index: rts/System/tdf_grammar.hpp
===================================================================
--- rts/System/tdf_grammar.hpp (revision 1919)
+++ rts/System/tdf_grammar.hpp (revision 3798)
@@ -99,6 +99,7 @@
section(self.section)
| gather_junk_line // if this rule gets hit then section did not consume everything,
)
+ >> end_p
;

gather_junk_line =
</pre></code>


Save it to a file and go to spring source directory and say:

<code><pre>
patch -p0 < mypatchfilename
</pre></code>

You need to have patch installed to be able to do this. After successfully patching, compile and install.

==== If You Still Have Problems ====

Join to #taspring on Freenode and tell me (semi_) that you have problems with installing, and I'll try to improve this guide to solve your problem, if I have time.

However, generic linux problems not really related to installing this should be asked elsewhere.

Prepare to tell me your distribution, which installation method you used, and what exactly is the error. Don't ask if I'm here or not, just state your problem there and I'll look into it when I come back.

Other common problems and solutions coming soon.

==== Can't See Configure Options Before Configuring ====

If you want to see the configure options, because of a bug in the buildsystem you have to have spring configured first. But if configure fails, you are out of luck. So I have listed the options here:

<code><pre>
$ scons --help
scons: Reading SConscript files ...
make: Nothing to be done for `all'.
Succes building streflop!
Updating bitmaps.sdz
Updating springcontent.sdz
scons: done reading SConscript files.

platform: Set to linux, freebsd or windows
default: None
actual: linux

debug: Set to yes to produce a binary with debug information
default: 0
actual: 0

syncdebug: Set to yes to enable the sync debugger
default: False
actual: False

optimize: Enable processor optimizations during compilation
default: 1
actual: 2

profile: Set to yes to produce a binary with profiling information
default: False
actual: False

cpppath: Set path to extra header files
default: []
actual:

libpath: Set path to extra libraries
default: []
actual:

fpmath: Set to 387 or SSE on i386 and AMD64 architectures
default: 387
actual: 387

prefix: Install prefix used at runtime
default: /usr/local
actual: /usr/local

installprefix: Install prefix used for installion
default: /usr/local
actual: /usr/local

datadir: Data directory (relative to prefix)
default: share/games/spring
actual: share/games/spring

bindir: Directory for executables (rel. to prefix)
default: games
actual: games

libdir: Directory for AI plugin modules (rel. to prefix)
default: lib/spring
actual: lib/spring

strip: Discard symbols from the executable
(only when neither debugging nor profiling)
default: True
actual: True

disable_avi: Set to no to turn on avi support
default: False on windows, True otherwise
actual: True

use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation
default: False
actual: False

use_mmgr: Use memory manager
default: False
actual: False

cachedir: Cache directory (see scons manual)
default: None
actual:

Use scons -H for help about command-line options.
</pre></code>

==== LuaUI Crash Ingame ====

LuaUI can crash during game, because some lua script you use has a bug. 0.75 should be resistant to this problem, but 0.74b3 is not. After crash, you won't see the bottom left tooltip box and top right resource bar anymore. Fear not, help is near:

<code><pre>
/resbar 1
/tooltip 1
</pre></code>

These might not be necessary in 0.75 anymore at all.

Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.

=== Tips ===

* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.

* Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo) <code>(define devices '(alsa)) (define speaker-num 2) (define alsa-out-device "hw:0,0") (define alsa-in-device "hw:0,0")</code> Adventurous people with an emu10k1 based card (sblive) can try the accelerated openal version. http://www.lost.org.uk/openal.html , don't submit audiobugs if you do.

* If you really can't figure out how to get spring compiled, or you think there's a bug in the code or the buildsystem...
:* Just poke any developer on IRC:
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].

''' [[Main_Page|<- Back to Main page]]'''

[[Category:Linux Port]][[Category:Playing]]

SetupGuide

2007-07-28T20:12:57Z

Quilted: /* Getting The Dependencies */

== Linux Setup Guide ==

=== Which Version To Install ===

'''0.75 has just been released. This affects some parts of this guide. Currently this guide is NOT updated. I will remove this notice when the pages are up to date.'''

To play online, you must have the same version as everyone else in the game.

Most people should get the current release, version 0.75b2. There are usually
between 100 and 200 people online in the lobby, and if you want to play with
them, you need this.

Older versions should only be interesting to software archeologists.

If you want to see the bleeding edge, you can checkout svn head of spring, but
it can not be used to play with people who have the release, so you are
practically limited to playing against nemo. This is mainly interesting for
people who want to contribute to the project, for testing, finding bugs and
fixing them, and implementing new features. Head can be seriously broken from
time to time, or not even compile.

=== Installing With Package Managers On Various Distributions ===

If there is a package for your distributions preferred package manager, it is
recommended to use it instead of compiling the program yourself from sources.

==== 0.74b3 For Etch (Debian 4.0 Stable) With APT ====

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb etch spring" >> /etc/apt/sources.list
aptitude update
aptitude install spring spring-data
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring </code> and
read-only data in <code>/usr/share/games/spring</code>.

==== 0.74b3 For Sid (Debian Unstable) With APT ====

The current .deb for Sid is broken, because it depends on some boost packages
of version 1.33 that are not installable on sid, which has only 1.34. A
slightly more complex way to install is necessary:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
echo "deb-src http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
aptitude update
aptitude install dpkg-dev devscripts
apt-get source spring
apt-get build-dep spring
cd spring-0.74~b3/
debuild -us -uc
debi
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring </code> and
read-only data in <code> /usr/share/games/spring</code>.

==== 0.74b3 For Ubuntu (any version) With APT ====

If you have boost 1.33, then all you need is:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
aptitude update
aptitude install spring spring-data
</pre></code>

If you have boost 1.34, you have to do it the same way as debian unstable:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
echo "deb-src http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
aptitude update
aptitude install dpkg-dev devscripts
apt-get source spring
apt-get build-dep spring
cd spring-0.74~b3/
debuild -us -uc
debi
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring</code> and
read-only data in <code>/usr/share/games/spring</code>.

==== 0.74b3 For Gentoo With Portage ====

Make an overlay for portage, download the ebuilds, and extract to populate the overlay:

<code><pre>
mkdir -p /usr/local/portage
echo 'PORTDIR_OVERLAY="/usr/local/portage"' >> /etc/make.conf
wget http://download.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2 ||
wget http://download2.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2
tar xjf spring-ebuilds-0.74-r3.tar.bz2 -C /usr/local/portage/
</pre></code>

If you are not running unstable (~x86), do the following:

<code><pre>
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-base-ota ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-xta ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-gundamrts ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-nanoblobs ~x86" >> /etc/portage/package.keywords
</pre></code>

Some packages need to be built with certain use flags set, this makes sure it happens:

<code><pre>
echo "media-libs/libsdl X opengl" >> /etc/portage/package.use
echo "dev-libs/boost threads" >> /etc/portage/package.use
emerge media-libs/libsdl dev-libs/boost
</pre></code>

Add yourself to the group <code>games</code>. Don't do this as root, do this as
the user you normally use to play (you have to relogin afterwards to make it
work):

<code><pre>
gpasswd -a $(whoami) games
</pre></code>

And finally emerge spring itself, along with some datafile packages (ignore the
use flags for spring ebuild):

<code><pre>
emerge unzip spring spring-base-ota spring-mod-xta spring-mod-gundamrts
emerge spring-mod-nanoblobs
etc-update
</pre></code>

Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and
read-only data in <code>/usr/share/games/spring</code>.

=== Installing 0.74b3 From Source ===

If there is no package tailored for your distribution, you have to install from sources manually. Doing this for distributions where packages are available is not recommended.

==== Getting The Source ====

You can either download the source as a 4.7MB tarball (recommended) or get it
from the subversion repository. Either way, the result is the same for 0.74b3.

===== Downloading A Tarball =====

<code><pre>
cd /tmp
wget http://spring.clan-sy.com/dl/spring_0.75b2_src.tar.bz2
tar xjf spring_0.75b2_src.tar.bz2
cd spring_0.75b2
</pre></code>

===== Checking Out From Subversion =====

<code><pre>
aptitude install subversion # if you are not on debian, figure it out
svn co https://taspring.clan-sy.com/svn/spring/tags/taspring_0.74b3 /tmp/spring_0.74b3
cd /tmp/spring_0.74b3
</pre></code>

==== Getting The Dependencies ====

For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the
following to be the minimal set that is necessary to get. I have not tested
with any version of Ubuntu, but the line is probably almost identical if not
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007.

<code><pre>
aptitude install scons build-essential zlib1g-dev libfreetype6-dev
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev
aptitude install python2.4-dev zip
aptitude install libsablevm1-dev
</pre></code>

This has been tested to work with a clean install of gentoo 2007.0:

<code><pre>
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost
emerge media-libs/devil app-arch/zip
</pre></code>

Users of other distributions should be able to figure out the correct package
names from this. The scons configure will whine if you forget something, but it
does not check if you remembered to install zip, even though you still need it.

==== Building And Installing ====

The build will spew out warnings like the following, which you can safely ignore:

<code><pre>
warning: division by zero
warning: 'q' may be used uninitialized in this function
</pre></code>

Configure, build and install:

<code><pre>
scons configure
scons
scons install
mkdir -p /etc/spring
echo '$HOME/.spring' > /etc/spring/datadir
</pre></code>

Your paths are: Spring executable in <code>/usr/local/games/spring</code> and
read-only data in <code>/usr/local/share/games/spring</code>.

== Finalizing installation ==

Now all the things you needed to run as root have been done. Some stuff needs to be done by the user who is going to play spring.

I'm assuming bash here, but you can use anything you like to do it of course.

=== Making Data Directories ===

<code><pre>
mkdir -p ~/.spring/{base,maps,mods}
</pre></code>

=== Getting Maps ===

You need at least one map to succesfully run spring.

Go to [http://spring.unknown-files.net/category/13/Maps/ Unknown Files, Map Section] and download at least one map. Save it under ~/.spring/maps/ without unpacking the file in any way.

Hint: If you know the map name you want, there is a Quick Search in the top right corner of the page. Just write a part of the name, like one word, and you'll easily find what you were looking for.

=== Getting Mods ===

You need at least one mod to successfully run spring.

Go to [http://spring.unknown-files.net/category/14/Mods/ Unknown Files, Mod Section] and download at least one mod. Save it under ~/.spring/mods/ without unpacking the file in any way.

Hint: If you know the mod name you want, there is a Quick Search in the top right corner of the page. Just write a part of the name, like one word, and you'll easily find what you were looking for.

If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:

<code><pre>
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip
unzip -d ~/.spring/base base-ota-content.zip
</pre></code>

Note that you need to own a copy of Total Annihilation, to download this file legally.

If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.

=== Editing Settings ===
Defaults should be usable, so you can ignore this until you want to maximise your eye candy or fps :)

When you run spring the first time, it creates ~/.springrc which contains all the settings. It is a simple text file with name=value lines, most of which are pretty obvious and can be edited by hand.

If you want a tool for editing the file, you can use Kloot's [http://members.chello.nl/mjtobi/Settings++.tar.gz Settings++]. Untar it anywhere and open it by typing "./Settings++" and edit away.

=== Using LuaUI ===

Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.

Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI.

In 0.74b3, when you host games, you might crash more often when you use Lua, but this should be fixed in 0.75.

Lua scripts for LuaUI can be found in [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section].

In 0.74b3, you have to move LuaUI directory from your read-only data dir to your read-write data dir, to be able to customize it.

TODO need more stuff here.

=== Installing Lobby Client ===

To setup online games, you need a lobby client. There are several options to choose from.

You can also use lobby client to setup single player matches against the AI. TODO more information about setting up tasclient to play against AI.

==== Omni ====

This project has been abandoned, and you should not use it.

==== UnityLobby ====

This project has been abandoned, and you should not use it.

==== SpringLobby ====

This project is very promising, but not yet ready enough for production use.

Homepage of SpringLobby is [http://tc.serveftp.net/trac here].

==== AFLobby ====

This project is very promising, but is still in beta development. However, is usable for online multiplayer. See forum thread: http://spring.clan-sy.com/phpbb/viewtopic.php?t=8691

==== TASClient ====

This is a windows program, but it works just fine under wine in linux, and can be used together with native linux spring. I use it myself and recommend to use this temporarily until we all can migrate to SpringLobby or AFLobby.

The only two downsides in using this are that you have to use wine (which should not be a big problem) and your rank won't increase as long as you use it (also because of win-linux binary interaction).

Download the installer of Spring for Windows, and run it in wine:

<code><pre>
wget http://spring.clan-sy.com/dl/spring_0.74b3.exe
wine spring_0.74b3.exe
</pre></code>

No configuration of wine should be needed, if your distribution is sane.

Complete the install, and let it install to the default location, which is Program Files\Spring.

Assuming you completed the earlier step of creating the data directories, now we need to link the windows and linux data together:

<code><pre>
touch ~/.wine/drive_c/Program\ Files/Spring/script.txt
ln -s ~/.wine/drive_c/Program\ Files/Spring/script.txt ~/.spring/script.txt

rm -r ~/.wine/drive_c/Program\ Files/Spring/maps
ln -s ~/.spring/maps ~/.wine/drive_c/Program\ Files/Spring/maps

rm -r ~/.wine/drive_c/Program\ Files/Spring/mods
ln -s ~/.spring/mods ~/.wine/drive_c/Program\ Files/Spring/mods

rm -r ~/.wine/drive_c/Program\ Files/Spring/base
ln -s ~/.spring/base ~/.wine/drive_c/Program\ Files/Spring/base
</pre></code>

For the windows-TASClient to be able to launch native linux spring, we need a wrapper exe in between them. Source code for wrapper exe is:

<code><pre>
#include <windows.h>
#include <stdio.h>
#include <tchar.h>

#define NATIVE_SPRING_LOCATION TEXT("/usr/games/spring")
#define SPRING_VERSION_REPLY "Spring 0.74b3"

int main (int argc, char **argv)
{
if (argc > 1 && !strcmp(argv[1], "/V"))
{
puts(SPRING_VERSION_REPLY);
return 0;
}

STARTUPINFO si;
ZeroMemory( &si, sizeof(si) );
si.cb = sizeof(si);

PROCESS_INFORMATION pi;
ZeroMemory( &pi, sizeof(pi) );

// Start the child process.
if (!CreateProcess(
_tcsdup(NATIVE_SPRING_LOCATION), // No module name (use command line)
GetCommandLine(), // Command line
NULL, // Process handle not inheritable
NULL, // Thread handle not inheritable
FALSE, // Set handle inheritance to FALSE
0, // No creation flags
NULL, // Use parent's environment block
NULL, // Use parent's starting directory
&si, // Pointer to STARTUPINFO structure
&pi)) // Pointer to PROCESS_INFORMATION structure
{
printf( "CreateProcess failed (%d).\n", GetLastError() );
return 1;
}

// Wait until child process exits. Wine actually does not know how to wait
// for native linux process, so this will return instantly and your gametime
// counter does not increase so you don't get any rank.
WaitForSingleObject( pi.hProcess, INFINITE );

// Close process and thread handles.
CloseHandle( pi.hProcess );
CloseHandle( pi.hThread );

return 0;
}
</pre></code>

You might need to modify the define-lines in the beginning to match your location and version. Remember, the version reply must be exactly right, or your game just breaks totally in multiplayer or you can't even login to lobby server.

Save this code to spring.cc for example, and then we need to install a windows-crosscompiler and compile a windows binary from it inside our linux box like this:

<code><pre>
aptitude install mingw32
i586-mingw32msvc-g++ spring.cc -o ~/.wine/drive_c/Program\ Files/Spring/spring.exe
</pre></code>

This assumed debian for installing the crosscompiler, but mingw32 is probably simple to install on other distributions as well.

TODO should provide binary packages for this launcher, as all people don't have the possibility to set up cross compiler.

Then you should make a script for launching TASClient. The script can be named tasclient for example, and just put it somewhere in your path and make it executable. The script code is:

<code><pre>
#!/usr/bin/env sh
cd ~/.wine/drive_c/Program\ Files/Spring
wine TASClient.exe
</pre></code>

Now you should be able to type tasclient on the command line, and the lobby appears. '''This cd operation is necessary. If your working directory is not the same as TASClient.exe's location, it will just give access violations to you.'''

Note that every time when you have added new maps, the lobby client caches them and this will take some time, or a long time if you downloaded many maps since last time. Just wait patiently.

Then you should register an account and login with it, and you should be ready to join an online multiplayer game from the list that appears.

It's likely that you don't have the correct map or mod at this point, so just get them and join the game. You don't need to restart your lobby client after downloading the files.

It's recommended that you spectate a couple of high rank games first, to get some idea of how the game should be played. Some hosts don't allow spectators, but most do.

=== Troubleshooting ===

==== game dies with sounds/button9.wav "cant find wav file" ====

This or any similar error of not being able to find a specific file are usually because the mod you are using needs ota content, download & install as explained earlier in this document.

==== Problems With Boost 1.34 ====

If you get an error message when starting spring, which looks like the following but can be from any tdf file and the line numbers don't need to match either:

<code><pre>
Parse error in gamedata/explosion_alias.tdf at line 48 column 34 near
</pre></code>

Then you need this patch:


<code><pre>
Index: rts/System/tdf_grammar.hpp
===================================================================
--- rts/System/tdf_grammar.hpp (revision 1919)
+++ rts/System/tdf_grammar.hpp (revision 3798)
@@ -99,6 +99,7 @@
section(self.section)
| gather_junk_line // if this rule gets hit then section did not consume everything,
)
+ >> end_p
;

gather_junk_line =
</pre></code>


Save it to a file and go to spring source directory and say:

<code><pre>
patch -p0 < mypatchfilename
</pre></code>

You need to have patch installed to be able to do this. After successfully patching, compile and install.

==== If You Still Have Problems ====

Join to #taspring on Freenode and tell me (semi_) that you have problems with installing, and I'll try to improve this guide to solve your problem, if I have time.

However, generic linux problems not really related to installing this should be asked elsewhere.

Prepare to tell me your distribution, which installation method you used, and what exactly is the error. Don't ask if I'm here or not, just state your problem there and I'll look into it when I come back.

Other common problems and solutions coming soon.

==== Can't See Configure Options Before Configuring ====

If you want to see the configure options, because of a bug in the buildsystem you have to have spring configured first. But if configure fails, you are out of luck. So I have listed the options here:

<code><pre>
$ scons --help
scons: Reading SConscript files ...
make: Nothing to be done for `all'.
Succes building streflop!
Updating bitmaps.sdz
Updating springcontent.sdz
scons: done reading SConscript files.

platform: Set to linux, freebsd or windows
default: None
actual: linux

debug: Set to yes to produce a binary with debug information
default: 0
actual: 0

syncdebug: Set to yes to enable the sync debugger
default: False
actual: False

optimize: Enable processor optimizations during compilation
default: 1
actual: 2

profile: Set to yes to produce a binary with profiling information
default: False
actual: False

cpppath: Set path to extra header files
default: []
actual:

libpath: Set path to extra libraries
default: []
actual:

fpmath: Set to 387 or SSE on i386 and AMD64 architectures
default: 387
actual: 387

prefix: Install prefix used at runtime
default: /usr/local
actual: /usr/local

installprefix: Install prefix used for installion
default: /usr/local
actual: /usr/local

datadir: Data directory (relative to prefix)
default: share/games/spring
actual: share/games/spring

bindir: Directory for executables (rel. to prefix)
default: games
actual: games

libdir: Directory for AI plugin modules (rel. to prefix)
default: lib/spring
actual: lib/spring

strip: Discard symbols from the executable
(only when neither debugging nor profiling)
default: True
actual: True

disable_avi: Set to no to turn on avi support
default: False on windows, True otherwise
actual: True

use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation
default: False
actual: False

use_mmgr: Use memory manager
default: False
actual: False

cachedir: Cache directory (see scons manual)
default: None
actual:

Use scons -H for help about command-line options.
</pre></code>

==== LuaUI Crash Ingame ====

LuaUI can crash during game, because some lua script you use has a bug. 0.75 should be resistant to this problem, but 0.74b3 is not. After crash, you won't see the bottom left tooltip box and top right resource bar anymore. Fear not, help is near:

<code><pre>
/resbar 1
/tooltip 1
</pre></code>

These might not be necessary in 0.75 anymore at all.

Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.

=== Tips ===

* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.

* Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo) <code>(define devices '(alsa)) (define speaker-num 2) (define alsa-out-device "hw:0,0") (define alsa-in-device "hw:0,0")</code> Adventurous people with an emu10k1 based card (sblive) can try the accelerated openal version. http://www.lost.org.uk/openal.html , don't submit audiobugs if you do.

* If you really can't figure out how to get spring compiled, or you think there's a bug in the code or the buildsystem...
:* Just poke any developer on IRC:
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].

''' [[Main_Page|<- Back to Main page]]'''

[[Category:Linux Port]][[Category:Playing]]

SetupGuide

2007-07-28T20:09:29Z

Quilted: /* Getting The Dependencies */

== Linux Setup Guide ==

=== Which Version To Install ===

'''0.75 has just been released. This affects some parts of this guide. Currently this guide is NOT updated. I will remove this notice when the pages are up to date.'''

To play online, you must have the same version as everyone else in the game.

Most people should get the current release, version 0.75b2. There are usually
between 100 and 200 people online in the lobby, and if you want to play with
them, you need this.

Older versions should only be interesting to software archeologists.

If you want to see the bleeding edge, you can checkout svn head of spring, but
it can not be used to play with people who have the release, so you are
practically limited to playing against nemo. This is mainly interesting for
people who want to contribute to the project, for testing, finding bugs and
fixing them, and implementing new features. Head can be seriously broken from
time to time, or not even compile.

=== Installing With Package Managers On Various Distributions ===

If there is a package for your distributions preferred package manager, it is
recommended to use it instead of compiling the program yourself from sources.

==== 0.74b3 For Etch (Debian 4.0 Stable) With APT ====

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb etch spring" >> /etc/apt/sources.list
aptitude update
aptitude install spring spring-data
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring </code> and
read-only data in <code>/usr/share/games/spring</code>.

==== 0.74b3 For Sid (Debian Unstable) With APT ====

The current .deb for Sid is broken, because it depends on some boost packages
of version 1.33 that are not installable on sid, which has only 1.34. A
slightly more complex way to install is necessary:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
echo "deb-src http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
aptitude update
aptitude install dpkg-dev devscripts
apt-get source spring
apt-get build-dep spring
cd spring-0.74~b3/
debuild -us -uc
debi
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring </code> and
read-only data in <code> /usr/share/games/spring</code>.

==== 0.74b3 For Ubuntu (any version) With APT ====

If you have boost 1.33, then all you need is:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
aptitude update
aptitude install spring spring-data
</pre></code>

If you have boost 1.34, you have to do it the same way as debian unstable:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
echo "deb-src http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
aptitude update
aptitude install dpkg-dev devscripts
apt-get source spring
apt-get build-dep spring
cd spring-0.74~b3/
debuild -us -uc
debi
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring</code> and
read-only data in <code>/usr/share/games/spring</code>.

==== 0.74b3 For Gentoo With Portage ====

Make an overlay for portage, download the ebuilds, and extract to populate the overlay:

<code><pre>
mkdir -p /usr/local/portage
echo 'PORTDIR_OVERLAY="/usr/local/portage"' >> /etc/make.conf
wget http://download.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2 ||
wget http://download2.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2
tar xjf spring-ebuilds-0.74-r3.tar.bz2 -C /usr/local/portage/
</pre></code>

If you are not running unstable (~x86), do the following:

<code><pre>
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-base-ota ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-xta ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-gundamrts ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-nanoblobs ~x86" >> /etc/portage/package.keywords
</pre></code>

Some packages need to be built with certain use flags set, this makes sure it happens:

<code><pre>
echo "media-libs/libsdl X opengl" >> /etc/portage/package.use
echo "dev-libs/boost threads" >> /etc/portage/package.use
emerge media-libs/libsdl dev-libs/boost
</pre></code>

Add yourself to the group <code>games</code>. Don't do this as root, do this as
the user you normally use to play (you have to relogin afterwards to make it
work):

<code><pre>
gpasswd -a $(whoami) games
</pre></code>

And finally emerge spring itself, along with some datafile packages (ignore the
use flags for spring ebuild):

<code><pre>
emerge unzip spring spring-base-ota spring-mod-xta spring-mod-gundamrts
emerge spring-mod-nanoblobs
etc-update
</pre></code>

Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and
read-only data in <code>/usr/share/games/spring</code>.

=== Installing 0.74b3 From Source ===

If there is no package tailored for your distribution, you have to install from sources manually. Doing this for distributions where packages are available is not recommended.

==== Getting The Source ====

You can either download the source as a 4.7MB tarball (recommended) or get it
from the subversion repository. Either way, the result is the same for 0.74b3.

===== Downloading A Tarball =====

<code><pre>
cd /tmp
wget http://spring.clan-sy.com/dl/spring_0.75b2_src.tar.bz2
tar xjf spring_0.75b2_src.tar.bz2
cd spring_0.75b2
</pre></code>

===== Checking Out From Subversion =====

<code><pre>
aptitude install subversion # if you are not on debian, figure it out
svn co https://taspring.clan-sy.com/svn/spring/tags/taspring_0.74b3 /tmp/spring_0.74b3
cd /tmp/spring_0.74b3
</pre></code>

==== Getting The Dependencies ====

For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the
following to be the minimal set that is necessary to get. I have not tested
with any version of Ubuntu, but the line is probably almost identical if not
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007.

<code><pre>
aptitude install scons build-essential zlib1g-dev libfreetype6-dev
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev
aptitude install python2.4-dev zip
</pre></code>

This has been tested to work with a clean install of gentoo 2007.0:

<code><pre>
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost
emerge media-libs/devil app-arch/zip
</pre></code>

Users of other distributions should be able to figure out the correct package
names from this. The scons configure will whine if you forget something, but it
does not check if you remembered to install zip, even though you still need it.

==== Building And Installing ====

The build will spew out warnings like the following, which you can safely ignore:

<code><pre>
warning: division by zero
warning: 'q' may be used uninitialized in this function
</pre></code>

Configure, build and install:

<code><pre>
scons configure
scons
scons install
mkdir -p /etc/spring
echo '$HOME/.spring' > /etc/spring/datadir
</pre></code>

Your paths are: Spring executable in <code>/usr/local/games/spring</code> and
read-only data in <code>/usr/local/share/games/spring</code>.

== Finalizing installation ==

Now all the things you needed to run as root have been done. Some stuff needs to be done by the user who is going to play spring.

I'm assuming bash here, but you can use anything you like to do it of course.

=== Making Data Directories ===

<code><pre>
mkdir -p ~/.spring/{base,maps,mods}
</pre></code>

=== Getting Maps ===

You need at least one map to succesfully run spring.

Go to [http://spring.unknown-files.net/category/13/Maps/ Unknown Files, Map Section] and download at least one map. Save it under ~/.spring/maps/ without unpacking the file in any way.

Hint: If you know the map name you want, there is a Quick Search in the top right corner of the page. Just write a part of the name, like one word, and you'll easily find what you were looking for.

=== Getting Mods ===

You need at least one mod to successfully run spring.

Go to [http://spring.unknown-files.net/category/14/Mods/ Unknown Files, Mod Section] and download at least one mod. Save it under ~/.spring/mods/ without unpacking the file in any way.

Hint: If you know the mod name you want, there is a Quick Search in the top right corner of the page. Just write a part of the name, like one word, and you'll easily find what you were looking for.

If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:

<code><pre>
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip
unzip -d ~/.spring/base base-ota-content.zip
</pre></code>

Note that you need to own a copy of Total Annihilation, to download this file legally.

If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.

=== Editing Settings ===
Defaults should be usable, so you can ignore this until you want to maximise your eye candy or fps :)

When you run spring the first time, it creates ~/.springrc which contains all the settings. It is a simple text file with name=value lines, most of which are pretty obvious and can be edited by hand.

If you want a tool for editing the file, you can use Kloot's [http://members.chello.nl/mjtobi/Settings++.tar.gz Settings++]. Untar it anywhere and open it by typing "./Settings++" and edit away.

=== Using LuaUI ===

Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.

Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI.

In 0.74b3, when you host games, you might crash more often when you use Lua, but this should be fixed in 0.75.

Lua scripts for LuaUI can be found in [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section].

In 0.74b3, you have to move LuaUI directory from your read-only data dir to your read-write data dir, to be able to customize it.

TODO need more stuff here.

=== Installing Lobby Client ===

To setup online games, you need a lobby client. There are several options to choose from.

You can also use lobby client to setup single player matches against the AI. TODO more information about setting up tasclient to play against AI.

==== Omni ====

This project has been abandoned, and you should not use it.

==== UnityLobby ====

This project has been abandoned, and you should not use it.

==== SpringLobby ====

This project is very promising, but not yet ready enough for production use.

Homepage of SpringLobby is [http://tc.serveftp.net/trac here].

==== AFLobby ====

This project is very promising, but is still in beta development. However, is usable for online multiplayer. See forum thread: http://spring.clan-sy.com/phpbb/viewtopic.php?t=8691

==== TASClient ====

This is a windows program, but it works just fine under wine in linux, and can be used together with native linux spring. I use it myself and recommend to use this temporarily until we all can migrate to SpringLobby or AFLobby.

The only two downsides in using this are that you have to use wine (which should not be a big problem) and your rank won't increase as long as you use it (also because of win-linux binary interaction).

Download the installer of Spring for Windows, and run it in wine:

<code><pre>
wget http://spring.clan-sy.com/dl/spring_0.74b3.exe
wine spring_0.74b3.exe
</pre></code>

No configuration of wine should be needed, if your distribution is sane.

Complete the install, and let it install to the default location, which is Program Files\Spring.

Assuming you completed the earlier step of creating the data directories, now we need to link the windows and linux data together:

<code><pre>
touch ~/.wine/drive_c/Program\ Files/Spring/script.txt
ln -s ~/.wine/drive_c/Program\ Files/Spring/script.txt ~/.spring/script.txt

rm -r ~/.wine/drive_c/Program\ Files/Spring/maps
ln -s ~/.spring/maps ~/.wine/drive_c/Program\ Files/Spring/maps

rm -r ~/.wine/drive_c/Program\ Files/Spring/mods
ln -s ~/.spring/mods ~/.wine/drive_c/Program\ Files/Spring/mods

rm -r ~/.wine/drive_c/Program\ Files/Spring/base
ln -s ~/.spring/base ~/.wine/drive_c/Program\ Files/Spring/base
</pre></code>

For the windows-TASClient to be able to launch native linux spring, we need a wrapper exe in between them. Source code for wrapper exe is:

<code><pre>
#include <windows.h>
#include <stdio.h>
#include <tchar.h>

#define NATIVE_SPRING_LOCATION TEXT("/usr/games/spring")
#define SPRING_VERSION_REPLY "Spring 0.74b3"

int main (int argc, char **argv)
{
if (argc > 1 && !strcmp(argv[1], "/V"))
{
puts(SPRING_VERSION_REPLY);
return 0;
}

STARTUPINFO si;
ZeroMemory( &si, sizeof(si) );
si.cb = sizeof(si);

PROCESS_INFORMATION pi;
ZeroMemory( &pi, sizeof(pi) );

// Start the child process.
if (!CreateProcess(
_tcsdup(NATIVE_SPRING_LOCATION), // No module name (use command line)
GetCommandLine(), // Command line
NULL, // Process handle not inheritable
NULL, // Thread handle not inheritable
FALSE, // Set handle inheritance to FALSE
0, // No creation flags
NULL, // Use parent's environment block
NULL, // Use parent's starting directory
&si, // Pointer to STARTUPINFO structure
&pi)) // Pointer to PROCESS_INFORMATION structure
{
printf( "CreateProcess failed (%d).\n", GetLastError() );
return 1;
}

// Wait until child process exits. Wine actually does not know how to wait
// for native linux process, so this will return instantly and your gametime
// counter does not increase so you don't get any rank.
WaitForSingleObject( pi.hProcess, INFINITE );

// Close process and thread handles.
CloseHandle( pi.hProcess );
CloseHandle( pi.hThread );

return 0;
}
</pre></code>

You might need to modify the define-lines in the beginning to match your location and version. Remember, the version reply must be exactly right, or your game just breaks totally in multiplayer or you can't even login to lobby server.

Save this code to spring.cc for example, and then we need to install a windows-crosscompiler and compile a windows binary from it inside our linux box like this:

<code><pre>
aptitude install mingw32
i586-mingw32msvc-g++ spring.cc -o ~/.wine/drive_c/Program\ Files/Spring/spring.exe
</pre></code>

This assumed debian for installing the crosscompiler, but mingw32 is probably simple to install on other distributions as well.

TODO should provide binary packages for this launcher, as all people don't have the possibility to set up cross compiler.

Then you should make a script for launching TASClient. The script can be named tasclient for example, and just put it somewhere in your path and make it executable. The script code is:

<code><pre>
#!/usr/bin/env sh
cd ~/.wine/drive_c/Program\ Files/Spring
wine TASClient.exe
</pre></code>

Now you should be able to type tasclient on the command line, and the lobby appears. '''This cd operation is necessary. If your working directory is not the same as TASClient.exe's location, it will just give access violations to you.'''

Note that every time when you have added new maps, the lobby client caches them and this will take some time, or a long time if you downloaded many maps since last time. Just wait patiently.

Then you should register an account and login with it, and you should be ready to join an online multiplayer game from the list that appears.

It's likely that you don't have the correct map or mod at this point, so just get them and join the game. You don't need to restart your lobby client after downloading the files.

It's recommended that you spectate a couple of high rank games first, to get some idea of how the game should be played. Some hosts don't allow spectators, but most do.

=== Troubleshooting ===

==== game dies with sounds/button9.wav "cant find wav file" ====

This or any similar error of not being able to find a specific file are usually because the mod you are using needs ota content, download & install as explained earlier in this document.

==== Problems With Boost 1.34 ====

If you get an error message when starting spring, which looks like the following but can be from any tdf file and the line numbers don't need to match either:

<code><pre>
Parse error in gamedata/explosion_alias.tdf at line 48 column 34 near
</pre></code>

Then you need this patch:


<code><pre>
Index: rts/System/tdf_grammar.hpp
===================================================================
--- rts/System/tdf_grammar.hpp (revision 1919)
+++ rts/System/tdf_grammar.hpp (revision 3798)
@@ -99,6 +99,7 @@
section(self.section)
| gather_junk_line // if this rule gets hit then section did not consume everything,
)
+ >> end_p
;

gather_junk_line =
</pre></code>


Save it to a file and go to spring source directory and say:

<code><pre>
patch -p0 < mypatchfilename
</pre></code>

You need to have patch installed to be able to do this. After successfully patching, compile and install.

==== If You Still Have Problems ====

Join to #taspring on Freenode and tell me (semi_) that you have problems with installing, and I'll try to improve this guide to solve your problem, if I have time.

However, generic linux problems not really related to installing this should be asked elsewhere.

Prepare to tell me your distribution, which installation method you used, and what exactly is the error. Don't ask if I'm here or not, just state your problem there and I'll look into it when I come back.

Other common problems and solutions coming soon.

==== Can't See Configure Options Before Configuring ====

If you want to see the configure options, because of a bug in the buildsystem you have to have spring configured first. But if configure fails, you are out of luck. So I have listed the options here:

<code><pre>
$ scons --help
scons: Reading SConscript files ...
make: Nothing to be done for `all'.
Succes building streflop!
Updating bitmaps.sdz
Updating springcontent.sdz
scons: done reading SConscript files.

platform: Set to linux, freebsd or windows
default: None
actual: linux

debug: Set to yes to produce a binary with debug information
default: 0
actual: 0

syncdebug: Set to yes to enable the sync debugger
default: False
actual: False

optimize: Enable processor optimizations during compilation
default: 1
actual: 2

profile: Set to yes to produce a binary with profiling information
default: False
actual: False

cpppath: Set path to extra header files
default: []
actual:

libpath: Set path to extra libraries
default: []
actual:

fpmath: Set to 387 or SSE on i386 and AMD64 architectures
default: 387
actual: 387

prefix: Install prefix used at runtime
default: /usr/local
actual: /usr/local

installprefix: Install prefix used for installion
default: /usr/local
actual: /usr/local

datadir: Data directory (relative to prefix)
default: share/games/spring
actual: share/games/spring

bindir: Directory for executables (rel. to prefix)
default: games
actual: games

libdir: Directory for AI plugin modules (rel. to prefix)
default: lib/spring
actual: lib/spring

strip: Discard symbols from the executable
(only when neither debugging nor profiling)
default: True
actual: True

disable_avi: Set to no to turn on avi support
default: False on windows, True otherwise
actual: True

use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation
default: False
actual: False

use_mmgr: Use memory manager
default: False
actual: False

cachedir: Cache directory (see scons manual)
default: None
actual:

Use scons -H for help about command-line options.
</pre></code>

==== LuaUI Crash Ingame ====

LuaUI can crash during game, because some lua script you use has a bug. 0.75 should be resistant to this problem, but 0.74b3 is not. After crash, you won't see the bottom left tooltip box and top right resource bar anymore. Fear not, help is near:

<code><pre>
/resbar 1
/tooltip 1
</pre></code>

These might not be necessary in 0.75 anymore at all.

Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.

=== Tips ===

* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.

* Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo) <code>(define devices '(alsa)) (define speaker-num 2) (define alsa-out-device "hw:0,0") (define alsa-in-device "hw:0,0")</code> Adventurous people with an emu10k1 based card (sblive) can try the accelerated openal version. http://www.lost.org.uk/openal.html , don't submit audiobugs if you do.

* If you really can't figure out how to get spring compiled, or you think there's a bug in the code or the buildsystem...
:* Just poke any developer on IRC:
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].

''' [[Main_Page|<- Back to Main page]]'''

[[Category:Linux Port]][[Category:Playing]]

SetupGuide

2007-07-28T20:02:40Z

Quilted: /* Downloading A Tarball */

== Linux Setup Guide ==

=== Which Version To Install ===

'''0.75 has just been released. This affects some parts of this guide. Currently this guide is NOT updated. I will remove this notice when the pages are up to date.'''

To play online, you must have the same version as everyone else in the game.

Most people should get the current release, version 0.75b2. There are usually
between 100 and 200 people online in the lobby, and if you want to play with
them, you need this.

Older versions should only be interesting to software archeologists.

If you want to see the bleeding edge, you can checkout svn head of spring, but
it can not be used to play with people who have the release, so you are
practically limited to playing against nemo. This is mainly interesting for
people who want to contribute to the project, for testing, finding bugs and
fixing them, and implementing new features. Head can be seriously broken from
time to time, or not even compile.

=== Installing With Package Managers On Various Distributions ===

If there is a package for your distributions preferred package manager, it is
recommended to use it instead of compiling the program yourself from sources.

==== 0.74b3 For Etch (Debian 4.0 Stable) With APT ====

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb etch spring" >> /etc/apt/sources.list
aptitude update
aptitude install spring spring-data
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring </code> and
read-only data in <code>/usr/share/games/spring</code>.

==== 0.74b3 For Sid (Debian Unstable) With APT ====

The current .deb for Sid is broken, because it depends on some boost packages
of version 1.33 that are not installable on sid, which has only 1.34. A
slightly more complex way to install is necessary:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
echo "deb-src http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
aptitude update
aptitude install dpkg-dev devscripts
apt-get source spring
apt-get build-dep spring
cd spring-0.74~b3/
debuild -us -uc
debi
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring </code> and
read-only data in <code> /usr/share/games/spring</code>.

==== 0.74b3 For Ubuntu (any version) With APT ====

If you have boost 1.33, then all you need is:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
aptitude update
aptitude install spring spring-data
</pre></code>

If you have boost 1.34, you have to do it the same way as debian unstable:

<code><pre>
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
echo "deb-src http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
aptitude update
aptitude install dpkg-dev devscripts
apt-get source spring
apt-get build-dep spring
cd spring-0.74~b3/
debuild -us -uc
debi
</pre></code>

Your paths are: Spring executable in <code>/usr/games/spring</code> and
read-only data in <code>/usr/share/games/spring</code>.

==== 0.74b3 For Gentoo With Portage ====

Make an overlay for portage, download the ebuilds, and extract to populate the overlay:

<code><pre>
mkdir -p /usr/local/portage
echo 'PORTDIR_OVERLAY="/usr/local/portage"' >> /etc/make.conf
wget http://download.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2 ||
wget http://download2.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2
tar xjf spring-ebuilds-0.74-r3.tar.bz2 -C /usr/local/portage/
</pre></code>

If you are not running unstable (~x86), do the following:

<code><pre>
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-base-ota ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-xta ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-gundamrts ~x86" >> /etc/portage/package.keywords
echo "games-strategy/spring-mod-nanoblobs ~x86" >> /etc/portage/package.keywords
</pre></code>

Some packages need to be built with certain use flags set, this makes sure it happens:

<code><pre>
echo "media-libs/libsdl X opengl" >> /etc/portage/package.use
echo "dev-libs/boost threads" >> /etc/portage/package.use
emerge media-libs/libsdl dev-libs/boost
</pre></code>

Add yourself to the group <code>games</code>. Don't do this as root, do this as
the user you normally use to play (you have to relogin afterwards to make it
work):

<code><pre>
gpasswd -a $(whoami) games
</pre></code>

And finally emerge spring itself, along with some datafile packages (ignore the
use flags for spring ebuild):

<code><pre>
emerge unzip spring spring-base-ota spring-mod-xta spring-mod-gundamrts
emerge spring-mod-nanoblobs
etc-update
</pre></code>

Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and
read-only data in <code>/usr/share/games/spring</code>.

=== Installing 0.74b3 From Source ===

If there is no package tailored for your distribution, you have to install from sources manually. Doing this for distributions where packages are available is not recommended.

==== Getting The Source ====

You can either download the source as a 4.7MB tarball (recommended) or get it
from the subversion repository. Either way, the result is the same for 0.74b3.

===== Downloading A Tarball =====

<code><pre>
cd /tmp
wget http://spring.clan-sy.com/dl/spring_0.75b2_src.tar.bz2
tar xjf spring_0.75b2_src.tar.bz2
cd spring_0.75b2
</pre></code>

===== Checking Out From Subversion =====

<code><pre>
aptitude install subversion # if you are not on debian, figure it out
svn co https://taspring.clan-sy.com/svn/spring/tags/taspring_0.74b3 /tmp/spring_0.74b3
cd /tmp/spring_0.74b3
</pre></code>

==== Getting The Dependencies ====

For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the
following to be the minimal set that is necessary to get. I have not tested
with any version of Ubuntu, but the line is probably almost identical if not
the same.

<code><pre>
aptitude install scons build-essential zlib1g-dev libfreetype6-dev
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev
aptitude install python2.4-dev zip
</pre></code>

This has been tested to work with a clean install of gentoo 2007.0:

<code><pre>
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost
emerge media-libs/devil app-arch/zip
</pre></code>

Users of other distributions should be able to figure out the correct package
names from this. The scons configure will whine if you forget something, but it
does not check if you remembered to install zip, even though you still need it.

==== Building And Installing ====

The build will spew out warnings like the following, which you can safely ignore:

<code><pre>
warning: division by zero
warning: 'q' may be used uninitialized in this function
</pre></code>

Configure, build and install:

<code><pre>
scons configure
scons
scons install
mkdir -p /etc/spring
echo '$HOME/.spring' > /etc/spring/datadir
</pre></code>

Your paths are: Spring executable in <code>/usr/local/games/spring</code> and
read-only data in <code>/usr/local/share/games/spring</code>.

== Finalizing installation ==

Now all the things you needed to run as root have been done. Some stuff needs to be done by the user who is going to play spring.

I'm assuming bash here, but you can use anything you like to do it of course.

=== Making Data Directories ===

<code><pre>
mkdir -p ~/.spring/{base,maps,mods}
</pre></code>

=== Getting Maps ===

You need at least one map to succesfully run spring.

Go to [http://spring.unknown-files.net/category/13/Maps/ Unknown Files, Map Section] and download at least one map. Save it under ~/.spring/maps/ without unpacking the file in any way.

Hint: If you know the map name you want, there is a Quick Search in the top right corner of the page. Just write a part of the name, like one word, and you'll easily find what you were looking for.

=== Getting Mods ===

You need at least one mod to successfully run spring.

Go to [http://spring.unknown-files.net/category/14/Mods/ Unknown Files, Mod Section] and download at least one mod. Save it under ~/.spring/mods/ without unpacking the file in any way.

Hint: If you know the mod name you want, there is a Quick Search in the top right corner of the page. Just write a part of the name, like one word, and you'll easily find what you were looking for.

If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:

<code><pre>
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip
unzip -d ~/.spring/base base-ota-content.zip
</pre></code>

Note that you need to own a copy of Total Annihilation, to download this file legally.

If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.

=== Editing Settings ===
Defaults should be usable, so you can ignore this until you want to maximise your eye candy or fps :)

When you run spring the first time, it creates ~/.springrc which contains all the settings. It is a simple text file with name=value lines, most of which are pretty obvious and can be edited by hand.

If you want a tool for editing the file, you can use Kloot's [http://members.chello.nl/mjtobi/Settings++.tar.gz Settings++]. Untar it anywhere and open it by typing "./Settings++" and edit away.

=== Using LuaUI ===

Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.

Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI.

In 0.74b3, when you host games, you might crash more often when you use Lua, but this should be fixed in 0.75.

Lua scripts for LuaUI can be found in [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section].

In 0.74b3, you have to move LuaUI directory from your read-only data dir to your read-write data dir, to be able to customize it.

TODO need more stuff here.

=== Installing Lobby Client ===

To setup online games, you need a lobby client. There are several options to choose from.

You can also use lobby client to setup single player matches against the AI. TODO more information about setting up tasclient to play against AI.

==== Omni ====

This project has been abandoned, and you should not use it.

==== UnityLobby ====

This project has been abandoned, and you should not use it.

==== SpringLobby ====

This project is very promising, but not yet ready enough for production use.

Homepage of SpringLobby is [http://tc.serveftp.net/trac here].

==== AFLobby ====

This project is very promising, but is still in beta development. However, is usable for online multiplayer. See forum thread: http://spring.clan-sy.com/phpbb/viewtopic.php?t=8691

==== TASClient ====

This is a windows program, but it works just fine under wine in linux, and can be used together with native linux spring. I use it myself and recommend to use this temporarily until we all can migrate to SpringLobby or AFLobby.

The only two downsides in using this are that you have to use wine (which should not be a big problem) and your rank won't increase as long as you use it (also because of win-linux binary interaction).

Download the installer of Spring for Windows, and run it in wine:

<code><pre>
wget http://spring.clan-sy.com/dl/spring_0.74b3.exe
wine spring_0.74b3.exe
</pre></code>

No configuration of wine should be needed, if your distribution is sane.

Complete the install, and let it install to the default location, which is Program Files\Spring.

Assuming you completed the earlier step of creating the data directories, now we need to link the windows and linux data together:

<code><pre>
touch ~/.wine/drive_c/Program\ Files/Spring/script.txt
ln -s ~/.wine/drive_c/Program\ Files/Spring/script.txt ~/.spring/script.txt

rm -r ~/.wine/drive_c/Program\ Files/Spring/maps
ln -s ~/.spring/maps ~/.wine/drive_c/Program\ Files/Spring/maps

rm -r ~/.wine/drive_c/Program\ Files/Spring/mods
ln -s ~/.spring/mods ~/.wine/drive_c/Program\ Files/Spring/mods

rm -r ~/.wine/drive_c/Program\ Files/Spring/base
ln -s ~/.spring/base ~/.wine/drive_c/Program\ Files/Spring/base
</pre></code>

For the windows-TASClient to be able to launch native linux spring, we need a wrapper exe in between them. Source code for wrapper exe is:

<code><pre>
#include <windows.h>
#include <stdio.h>
#include <tchar.h>

#define NATIVE_SPRING_LOCATION TEXT("/usr/games/spring")
#define SPRING_VERSION_REPLY "Spring 0.74b3"

int main (int argc, char **argv)
{
if (argc > 1 && !strcmp(argv[1], "/V"))
{
puts(SPRING_VERSION_REPLY);
return 0;
}

STARTUPINFO si;
ZeroMemory( &si, sizeof(si) );
si.cb = sizeof(si);

PROCESS_INFORMATION pi;
ZeroMemory( &pi, sizeof(pi) );

// Start the child process.
if (!CreateProcess(
_tcsdup(NATIVE_SPRING_LOCATION), // No module name (use command line)
GetCommandLine(), // Command line
NULL, // Process handle not inheritable
NULL, // Thread handle not inheritable
FALSE, // Set handle inheritance to FALSE
0, // No creation flags
NULL, // Use parent's environment block
NULL, // Use parent's starting directory
&si, // Pointer to STARTUPINFO structure
&pi)) // Pointer to PROCESS_INFORMATION structure
{
printf( "CreateProcess failed (%d).\n", GetLastError() );
return 1;
}

// Wait until child process exits. Wine actually does not know how to wait
// for native linux process, so this will return instantly and your gametime
// counter does not increase so you don't get any rank.
WaitForSingleObject( pi.hProcess, INFINITE );

// Close process and thread handles.
CloseHandle( pi.hProcess );
CloseHandle( pi.hThread );

return 0;
}
</pre></code>

You might need to modify the define-lines in the beginning to match your location and version. Remember, the version reply must be exactly right, or your game just breaks totally in multiplayer or you can't even login to lobby server.

Save this code to spring.cc for example, and then we need to install a windows-crosscompiler and compile a windows binary from it inside our linux box like this:

<code><pre>
aptitude install mingw32
i586-mingw32msvc-g++ spring.cc -o ~/.wine/drive_c/Program\ Files/Spring/spring.exe
</pre></code>

This assumed debian for installing the crosscompiler, but mingw32 is probably simple to install on other distributions as well.

TODO should provide binary packages for this launcher, as all people don't have the possibility to set up cross compiler.

Then you should make a script for launching TASClient. The script can be named tasclient for example, and just put it somewhere in your path and make it executable. The script code is:

<code><pre>
#!/usr/bin/env sh
cd ~/.wine/drive_c/Program\ Files/Spring
wine TASClient.exe
</pre></code>

Now you should be able to type tasclient on the command line, and the lobby appears. '''This cd operation is necessary. If your working directory is not the same as TASClient.exe's location, it will just give access violations to you.'''

Note that every time when you have added new maps, the lobby client caches them and this will take some time, or a long time if you downloaded many maps since last time. Just wait patiently.

Then you should register an account and login with it, and you should be ready to join an online multiplayer game from the list that appears.

It's likely that you don't have the correct map or mod at this point, so just get them and join the game. You don't need to restart your lobby client after downloading the files.

It's recommended that you spectate a couple of high rank games first, to get some idea of how the game should be played. Some hosts don't allow spectators, but most do.

=== Troubleshooting ===

==== game dies with sounds/button9.wav "cant find wav file" ====

This or any similar error of not being able to find a specific file are usually because the mod you are using needs ota content, download & install as explained earlier in this document.

==== Problems With Boost 1.34 ====

If you get an error message when starting spring, which looks like the following but can be from any tdf file and the line numbers don't need to match either:

<code><pre>
Parse error in gamedata/explosion_alias.tdf at line 48 column 34 near
</pre></code>

Then you need this patch:


<code><pre>
Index: rts/System/tdf_grammar.hpp
===================================================================
--- rts/System/tdf_grammar.hpp (revision 1919)
+++ rts/System/tdf_grammar.hpp (revision 3798)
@@ -99,6 +99,7 @@
section(self.section)
| gather_junk_line // if this rule gets hit then section did not consume everything,
)
+ >> end_p
;

gather_junk_line =
</pre></code>


Save it to a file and go to spring source directory and say:

<code><pre>
patch -p0 < mypatchfilename
</pre></code>

You need to have patch installed to be able to do this. After successfully patching, compile and install.

==== If You Still Have Problems ====

Join to #taspring on Freenode and tell me (semi_) that you have problems with installing, and I'll try to improve this guide to solve your problem, if I have time.

However, generic linux problems not really related to installing this should be asked elsewhere.

Prepare to tell me your distribution, which installation method you used, and what exactly is the error. Don't ask if I'm here or not, just state your problem there and I'll look into it when I come back.

Other common problems and solutions coming soon.

==== Can't See Configure Options Before Configuring ====

If you want to see the configure options, because of a bug in the buildsystem you have to have spring configured first. But if configure fails, you are out of luck. So I have listed the options here:

<code><pre>
$ scons --help
scons: Reading SConscript files ...
make: Nothing to be done for `all'.
Succes building streflop!
Updating bitmaps.sdz
Updating springcontent.sdz
scons: done reading SConscript files.

platform: Set to linux, freebsd or windows
default: None
actual: linux

debug: Set to yes to produce a binary with debug information
default: 0
actual: 0

syncdebug: Set to yes to enable the sync debugger
default: False
actual: False

optimize: Enable processor optimizations during compilation
default: 1
actual: 2

profile: Set to yes to produce a binary with profiling information
default: False
actual: False

cpppath: Set path to extra header files
default: []
actual:

libpath: Set path to extra libraries
default: []
actual:

fpmath: Set to 387 or SSE on i386 and AMD64 architectures
default: 387
actual: 387

prefix: Install prefix used at runtime
default: /usr/local
actual: /usr/local

installprefix: Install prefix used for installion
default: /usr/local
actual: /usr/local

datadir: Data directory (relative to prefix)
default: share/games/spring
actual: share/games/spring

bindir: Directory for executables (rel. to prefix)
default: games
actual: games

libdir: Directory for AI plugin modules (rel. to prefix)
default: lib/spring
actual: lib/spring

strip: Discard symbols from the executable
(only when neither debugging nor profiling)
default: True
actual: True

disable_avi: Set to no to turn on avi support
default: False on windows, True otherwise
actual: True

use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation
default: False
actual: False

use_mmgr: Use memory manager
default: False
actual: False

cachedir: Cache directory (see scons manual)
default: None
actual:

Use scons -H for help about command-line options.
</pre></code>

==== LuaUI Crash Ingame ====

LuaUI can crash during game, because some lua script you use has a bug. 0.75 should be resistant to this problem, but 0.74b3 is not. After crash, you won't see the bottom left tooltip box and top right resource bar anymore. Fear not, help is near:

<code><pre>
/resbar 1
/tooltip 1
</pre></code>

These might not be necessary in 0.75 anymore at all.

Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.

=== Tips ===

* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.

* Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo) <code>(define devices '(alsa)) (define speaker-num 2) (define alsa-out-device "hw:0,0") (define alsa-in-device "hw:0,0")</code> Adventurous people with an emu10k1 based card (sblive) can try the accelerated openal version. http://www.lost.org.uk/openal.html , don't submit audiobugs if you do.

* If you really can't figure out how to get spring compiled, or you think there's a bug in the code or the buildsystem...
:* Just poke any developer on IRC:
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].

''' [[Main_Page|<- Back to Main page]]'''

[[Category:Linux Port]][[Category:Playing]]