https://springrts-wiki.p2004a.com/mediawiki/api.php?action=feedcontributions&feedformat=atom&user=LordMattSpring - User contributions [en]2026-11-08T20:56:45ZUser contributionsMediaWiki 1.43.11https://springrts-wiki.p2004a.com/mediawiki/index.php?title=Troubleshooting_linux&diff=18388Troubleshooting linux2008-04-02T02:06:59Z<p>LordMatt: /* Sound is Choppy */</p>
<hr />
<div>= Troubleshooting =<br />
<br />
== Ingame ==<br />
<br />
=== LuaUI Crash Ingame ===<br />
<br />
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:<br />
<br />
<code><pre><br />
/resbar 1<br />
/tooltip 1<br />
</pre></code><br />
<br />
These might not be necessary in 0.75 anymore at all.<br />
<br />
Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.<br />
<br />
LuaUI can also be restarted after it crashed. Often this does the trick and it works fine the rest of the game:<br />
<br />
<code><pre><br />
/luaui reload<br />
</pre></code><br />
<br />
=== Mouse is slow in fullscreen mode ===<br />
<br />
Run:<br />
<code><pre><br />
echo 'export SDL_MOUSE_RELATIVE=0' >> ~/.bash_profile<br />
</pre></code><br />
And log out and log in again.<br />
<br />
The mouse should now be as fast as in windowed mode.<br />
<br />
=== Rotating Buildings Ingame ===<br />
<br />
You can rotate a building before you give the build order, but the keys that do this don't work in linux by default for some users. Issue the following commands in the beginning of the game:<br />
<br />
<code><pre><br />
/bind keycodex buildfacing inc<br />
/bind keycodey buildfacing dec<br />
</pre></code><br />
<br />
Keycodex and keycodey above are just placeholders. What you want to write depends on which key you want to use. To see what keycodes any keys have, do:<br />
<br />
<code><pre><br />
/keydebug yes<br />
</pre></code><br />
<br />
And then hit the keys you want to use, and spring prints the keycodes in the message buffer.<br />
<br />
TODO: add information on how to save the settings so that they work the next time you start spring.<br />
<br />
=== Map is White ===<br />
<br />
If the whole map is only shades of white and grey, there is a problem with your display driver. Maybe your gpu is very old and does not support some needed opengl feature. For example I had this problem with matrox g550 but not with some very old geforce.<br />
<br />
=== Sound is Choppy ===<br />
<br />
If the engine sound is very broken or choppy sounding, and you hear some noise or crackling, you need to tell OpenAL to try to use a different sound backend. If you don't have an ~/.openalrc file, create it with these contents, or modify your current one to look like this:<br />
<br />
<code><br />
(define devices '(native alsa sdl arts esd null))<br />
(define alsa-device "dsp0")<br />
(define speaker-num 2)<br />
;(define sampling-rate 22050)<br />
</code><br />
<br />
The important line here is the "define devices" line, OpenAL attempts to use each of those sound output methods in order. It uses the first one that works; in some cases native will work best, in other cases perhaps alsa. If Gnome is running its sound daemon, esd would be the best choice, while KDE usually uses artsd.<br />
<br />
== Startup ==<br />
<br />
=== Missing Default Cursor ===<br />
<br />
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 [[SetupGuide#OTA_Content|earlier in this document]].<br />
<br />
=== could not open file: gamedata/defs.lua ===<br />
<br />
Make sure your ~/.spring does not contain an outdated version of base/springcontent.sdz because a new version of this file is distributed with spring.<br />
If you do, just remove it.<br />
<br />
=== sounds/button9.wav "cant find wav file" ===<br />
<br />
Same problem as above.<br />
<br />
=== Couldnt find matching GLX visual ===<br />
<br />
Reduce anti aliasing.<br />
<br />
=== GL_ARB_texture_compression not found ===<br />
<br />
This can be an issue with your gpu drivers. The drivers you are using do not support a feature that is required to run spring. You might have better luck with the closed source official drivers of nvidia or amd cards. If your gpu itself is really old, this might not help.<br />
<br />
If you use the fglrx ati-graphics driver and you are getting this error there might be a chance that still spring work (I use this with ubuntu gusty).<br />
At first we must check that fglrx is installed correctly:<br />
<br />
<code><pre><br />
~$ fglrxinfo<br />
display: :0.0 screen: 0<br />
OpenGL vendor string: ATI Technologies Inc.<br />
OpenGL renderer string: ATI Mobility Radeon X1400<br />
OpenGL version string: 2.0.6747 (8.40.4)<br />
</pre></code><br />
<br />
Then lets check the glx-extention.<br />
<br />
<code><pre><br />
~$ glxinfo | grep direct<br />
Xlib: extension "XFree86-DRI" missing on display ":1.0".<br />
direct rendering: No<br />
</pre></code><br />
<br />
If you get this message, notice that glxinfo releates to display ':1' and fglrxinfo to display ':0'!! Lets check the glx-extention on display :0 now.<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 glxinfo | grep direct<br />
direct rendering: Yes<br />
</pre></code><br />
<br />
This message mean that you can start spring by typing (in a terminal)<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 spring<br />
</pre></code><br />
<br />
If you use the TASclient with wine and the native linux spring. Start the whole TASclient-start-script by typing. <br />
<br />
<code><pre><br />
DISPLAY=:0 TASCLIENT-start-script<br />
</pre></code><br />
<br />
But Notice under circumstances is no windowmanager running on screen :0! This means there are NO windowframes at the TASClient window! You can't move it or close it by clicking the closebutton (unless you click at the close button on the terminal-window in witch you startet TAS). You can although close TAS with the keys ALT-F4<br />
<br />
=== OpenAL Segfault ===<br />
<br />
If spring crashes with this output:<br />
<br />
<code><pre><br />
OpenAL: ALC_EXT_capture AL_EXT_capture AL_EXT_vorbis AL_EXT_MP3<br />
AL_LOKI_quadriphonic AL_LOKI_play_position AL_LOKI_WAVE_format<br />
AL_LOKI_IMA_ADPCM_format AL_LOKI_buffer_data_callback ALC_LOKI_audio_channel<br />
Segmentation fault (core dumped)<br />
</pre></code><br />
<br />
Look into this thread on the forums for a fix: http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12568<br />
<br />
Then bug nemo in #taspring to finish this troubleshooting entry. He knows how to fix it.<br />
<br />
This is mod-related, ie. it only happens on some mods. Please list here the mod versions that give this error for you.<br />
<br />
- Star Wars mod, unknown version, by user report<br />
<br />
The problematic mod contains a sound file that crashes openal. You can try to unzip the mod file that crashed for you, and play each sound file. Please report any sound files that fail to play right, just list them here.<br />
<br />
- unknown file<br />
<br />
== Compiletime ==<br />
<br />
=== make_gamedata_arch.sh not found ===<br />
<br />
The .zip you downloaded is for windows, you must download a .bz2, instructions [[SetupGuide#Downloading_A_Tarball|earlier in this document]].<br />
<br />
=== invalid use of ILvoid ===<br />
<br />
During compiling, if you get a lot of the following errors:<br />
<br />
<code><pre><br />
/usr/include/IL/il.h:497: error: '<anonymous>' has incomplete type <br />
/usr/include/IL/il.h:497: error: invalid use of 'ILvoid'<br />
</pre></code><br />
<br />
This happens because the version of libdevil-dev you have installed is not compatible with gcc version 4.2 and newer.<br />
<br />
You should upgrade your libdevil-dev to fix this issue. However, in some distributions (at least gentoo), the fixed package has the SAME version number as the older unfixed package, so you might actually need to remove your current libdevil-dev package completely and reinstall it.<br />
<br />
TODO: add critical version numbers of libdevil.<br />
<br />
== Network Setup ==<br />
<br />
Usually you don't need to do any network setup whatsoever, because the lobbies take care of nat traversal with firewall hole punching, but if you need to know the topology, it goes like this:<br />
<br />
Host needs to enable incoming udp to port 8452, and outgoing replies to those.<br />
Non-host players need to enable outgoing udp, and incoming replies to those.<br />
So basically only non-host players initiate "connections", and only the server listens on a well-known port.<br />
<br />
== If You Still Have Problems ==<br />
<br />
Join to #taspring on Freenode or #sy on QuakeNet and try your luck.<br />
<br />
However, generic linux problems not really related to installing this should be asked elsewhere.<br />
<br />
Prepare to list your distribution, which installation method you used, and what exactly is the error. Don't ask if people are around or not, just go straight to business and tell all details, for maximizing your chances of getting help.<br />
<br />
== IRC ==<br />
<br />
# #taspring @ FreeNode<br />
# #sy @ QuakeNet<br />
<br />
== Asking For Help ==<br />
<br />
Ok so you need human help. This is how '''NOT''' to do it:<br />
<br />
<code><pre><br />
15:54 -!- **** [n=****@*] has joined #taspring<br />
15:54 < ****> Hi, i have a problem with compiling spring on debian<br />
15:54 < ****> can anyone help me?<br />
15:57 -!- **** [n=****@*] has quit [Client Quit]<br />
</pre></code><br />
<br />
Don't ask to ask, instead go straight to business by stating the exact problem you have, and giving all necessary information. What you were trying to achieve, how did you try to do it, what happened and what did you expect to happen.<br />
<br />
Then WAIT for someone to notice you.<br />
<br />
== Configure Options ==<br />
<br />
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:<br />
<br />
<code><pre><br />
$ scons --help<br />
scons: Reading SConscript files ...<br />
make: Nothing to be done for `all'.<br />
Succes building streflop!<br />
Updating bitmaps.sdz<br />
Updating springcontent.sdz<br />
scons: done reading SConscript files.<br />
<br />
platform: Set to linux, freebsd or windows<br />
default: None<br />
actual: linux<br />
<br />
debug: Set to yes to produce a binary with debug information<br />
default: 0<br />
actual: 3<br />
<br />
debugdefines: Set to no to suppress DEBUG and _DEBUG preprocessor #defines \<br />
(use to add symbols to release build)<br />
default: True<br />
actual: True<br />
<br />
syncdebug: Set to yes to enable the sync debugger<br />
default: False<br />
actual: False<br />
<br />
synccheck: Set to yes to enable sync checker & resyncer<br />
default: True<br />
actual: True<br />
<br />
optimize: Enable processor optimizations during compilation<br />
default: 1<br />
actual: 2<br />
<br />
profile: Set to yes to produce a binary with profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_generate: Set to yes to compile with -fprofile-generate \<br />
to generate profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_use: Set to yes to compile with -fprofile-use to use \<br />
profiling information<br />
default: False<br />
actual: False<br />
<br />
cpppath: Set path to extra header files<br />
default: []<br />
actual:<br />
<br />
libpath: Set path to extra libraries<br />
default: []<br />
actual:<br />
<br />
fpmath: Set to 387 or SSE on i386 and AMD64 architectures<br />
default: 387<br />
actual: 387<br />
<br />
prefix: Install prefix used at runtime<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
installprefix: Install prefix used for installion<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
datadir: Data directory (relative to prefix)<br />
default: share/games/spring<br />
actual: share/games/spring<br />
<br />
bindir: Directory for executables (rel. to prefix)<br />
default: games<br />
actual: games<br />
<br />
libdir: Directory for AI plugin modules (rel. to prefix)<br />
default: lib/spring<br />
actual: lib/spring<br />
<br />
strip: Discard symbols from the executable (only when neither \<br />
debugging nor profiling)<br />
default: True<br />
actual: False<br />
<br />
disable_avi: Set to no to turn on avi support<br />
default: False on windows, True otherwise<br />
actual: True<br />
<br />
use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation<br />
default: False<br />
actual: False<br />
<br />
use_mmgr: Use memory manager<br />
default: False<br />
actual: False<br />
<br />
dc_allowed: Specifies whether FPS mode (Direct Control) is allowed in game<br />
default: True<br />
actual: True<br />
<br />
cachedir: Cache directory (see scons manual)<br />
default: None<br />
actual:<br />
<br />
Use scons -H for help about command-line options.<br />
</pre></code></div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=Troubleshooting_linux&diff=18387Troubleshooting linux2008-04-02T02:06:44Z<p>LordMatt: /* Sound is Choppy */</p>
<hr />
<div>= Troubleshooting =<br />
<br />
== Ingame ==<br />
<br />
=== LuaUI Crash Ingame ===<br />
<br />
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:<br />
<br />
<code><pre><br />
/resbar 1<br />
/tooltip 1<br />
</pre></code><br />
<br />
These might not be necessary in 0.75 anymore at all.<br />
<br />
Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.<br />
<br />
LuaUI can also be restarted after it crashed. Often this does the trick and it works fine the rest of the game:<br />
<br />
<code><pre><br />
/luaui reload<br />
</pre></code><br />
<br />
=== Mouse is slow in fullscreen mode ===<br />
<br />
Run:<br />
<code><pre><br />
echo 'export SDL_MOUSE_RELATIVE=0' >> ~/.bash_profile<br />
</pre></code><br />
And log out and log in again.<br />
<br />
The mouse should now be as fast as in windowed mode.<br />
<br />
=== Rotating Buildings Ingame ===<br />
<br />
You can rotate a building before you give the build order, but the keys that do this don't work in linux by default for some users. Issue the following commands in the beginning of the game:<br />
<br />
<code><pre><br />
/bind keycodex buildfacing inc<br />
/bind keycodey buildfacing dec<br />
</pre></code><br />
<br />
Keycodex and keycodey above are just placeholders. What you want to write depends on which key you want to use. To see what keycodes any keys have, do:<br />
<br />
<code><pre><br />
/keydebug yes<br />
</pre></code><br />
<br />
And then hit the keys you want to use, and spring prints the keycodes in the message buffer.<br />
<br />
TODO: add information on how to save the settings so that they work the next time you start spring.<br />
<br />
=== Map is White ===<br />
<br />
If the whole map is only shades of white and grey, there is a problem with your display driver. Maybe your gpu is very old and does not support some needed opengl feature. For example I had this problem with matrox g550 but not with some very old geforce.<br />
<br />
=== Sound is Choppy ===<br />
<br />
If the engine sound is very broken or choppy sounding, and you hear some noise or crackling, you need to tell OpenAL to try to use a different sound backend. If you don't have an ~/.openalrc file, create it with these contents, or modify your current one to look like this:<br />
<br />
<code><br />
(define devices '(native alsa sdl arts esd null))<br />
(define alsa-device "dsp0")<br />
(define speaker-num 2)<br />
;(define sampling-rate 22050)<br />
<code><br />
<br />
The important line here is the "define devices" line, OpenAL attempts to use each of those sound output methods in order. It uses the first one that works; in some cases native will work best, in other cases perhaps alsa. If Gnome is running its sound daemon, esd would be the best choice, while KDE usually uses artsd.<br />
<br />
== Startup ==<br />
<br />
=== Missing Default Cursor ===<br />
<br />
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 [[SetupGuide#OTA_Content|earlier in this document]].<br />
<br />
=== could not open file: gamedata/defs.lua ===<br />
<br />
Make sure your ~/.spring does not contain an outdated version of base/springcontent.sdz because a new version of this file is distributed with spring.<br />
If you do, just remove it.<br />
<br />
=== sounds/button9.wav "cant find wav file" ===<br />
<br />
Same problem as above.<br />
<br />
=== Couldnt find matching GLX visual ===<br />
<br />
Reduce anti aliasing.<br />
<br />
=== GL_ARB_texture_compression not found ===<br />
<br />
This can be an issue with your gpu drivers. The drivers you are using do not support a feature that is required to run spring. You might have better luck with the closed source official drivers of nvidia or amd cards. If your gpu itself is really old, this might not help.<br />
<br />
If you use the fglrx ati-graphics driver and you are getting this error there might be a chance that still spring work (I use this with ubuntu gusty).<br />
At first we must check that fglrx is installed correctly:<br />
<br />
<code><pre><br />
~$ fglrxinfo<br />
display: :0.0 screen: 0<br />
OpenGL vendor string: ATI Technologies Inc.<br />
OpenGL renderer string: ATI Mobility Radeon X1400<br />
OpenGL version string: 2.0.6747 (8.40.4)<br />
</pre></code><br />
<br />
Then lets check the glx-extention.<br />
<br />
<code><pre><br />
~$ glxinfo | grep direct<br />
Xlib: extension "XFree86-DRI" missing on display ":1.0".<br />
direct rendering: No<br />
</pre></code><br />
<br />
If you get this message, notice that glxinfo releates to display ':1' and fglrxinfo to display ':0'!! Lets check the glx-extention on display :0 now.<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 glxinfo | grep direct<br />
direct rendering: Yes<br />
</pre></code><br />
<br />
This message mean that you can start spring by typing (in a terminal)<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 spring<br />
</pre></code><br />
<br />
If you use the TASclient with wine and the native linux spring. Start the whole TASclient-start-script by typing. <br />
<br />
<code><pre><br />
DISPLAY=:0 TASCLIENT-start-script<br />
</pre></code><br />
<br />
But Notice under circumstances is no windowmanager running on screen :0! This means there are NO windowframes at the TASClient window! You can't move it or close it by clicking the closebutton (unless you click at the close button on the terminal-window in witch you startet TAS). You can although close TAS with the keys ALT-F4<br />
<br />
=== OpenAL Segfault ===<br />
<br />
If spring crashes with this output:<br />
<br />
<code><pre><br />
OpenAL: ALC_EXT_capture AL_EXT_capture AL_EXT_vorbis AL_EXT_MP3<br />
AL_LOKI_quadriphonic AL_LOKI_play_position AL_LOKI_WAVE_format<br />
AL_LOKI_IMA_ADPCM_format AL_LOKI_buffer_data_callback ALC_LOKI_audio_channel<br />
Segmentation fault (core dumped)<br />
</pre></code><br />
<br />
Look into this thread on the forums for a fix: http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12568<br />
<br />
Then bug nemo in #taspring to finish this troubleshooting entry. He knows how to fix it.<br />
<br />
This is mod-related, ie. it only happens on some mods. Please list here the mod versions that give this error for you.<br />
<br />
- Star Wars mod, unknown version, by user report<br />
<br />
The problematic mod contains a sound file that crashes openal. You can try to unzip the mod file that crashed for you, and play each sound file. Please report any sound files that fail to play right, just list them here.<br />
<br />
- unknown file<br />
<br />
== Compiletime ==<br />
<br />
=== make_gamedata_arch.sh not found ===<br />
<br />
The .zip you downloaded is for windows, you must download a .bz2, instructions [[SetupGuide#Downloading_A_Tarball|earlier in this document]].<br />
<br />
=== invalid use of ILvoid ===<br />
<br />
During compiling, if you get a lot of the following errors:<br />
<br />
<code><pre><br />
/usr/include/IL/il.h:497: error: '<anonymous>' has incomplete type <br />
/usr/include/IL/il.h:497: error: invalid use of 'ILvoid'<br />
</pre></code><br />
<br />
This happens because the version of libdevil-dev you have installed is not compatible with gcc version 4.2 and newer.<br />
<br />
You should upgrade your libdevil-dev to fix this issue. However, in some distributions (at least gentoo), the fixed package has the SAME version number as the older unfixed package, so you might actually need to remove your current libdevil-dev package completely and reinstall it.<br />
<br />
TODO: add critical version numbers of libdevil.<br />
<br />
== Network Setup ==<br />
<br />
Usually you don't need to do any network setup whatsoever, because the lobbies take care of nat traversal with firewall hole punching, but if you need to know the topology, it goes like this:<br />
<br />
Host needs to enable incoming udp to port 8452, and outgoing replies to those.<br />
Non-host players need to enable outgoing udp, and incoming replies to those.<br />
So basically only non-host players initiate "connections", and only the server listens on a well-known port.<br />
<br />
== If You Still Have Problems ==<br />
<br />
Join to #taspring on Freenode or #sy on QuakeNet and try your luck.<br />
<br />
However, generic linux problems not really related to installing this should be asked elsewhere.<br />
<br />
Prepare to list your distribution, which installation method you used, and what exactly is the error. Don't ask if people are around or not, just go straight to business and tell all details, for maximizing your chances of getting help.<br />
<br />
== IRC ==<br />
<br />
# #taspring @ FreeNode<br />
# #sy @ QuakeNet<br />
<br />
== Asking For Help ==<br />
<br />
Ok so you need human help. This is how '''NOT''' to do it:<br />
<br />
<code><pre><br />
15:54 -!- **** [n=****@*] has joined #taspring<br />
15:54 < ****> Hi, i have a problem with compiling spring on debian<br />
15:54 < ****> can anyone help me?<br />
15:57 -!- **** [n=****@*] has quit [Client Quit]<br />
</pre></code><br />
<br />
Don't ask to ask, instead go straight to business by stating the exact problem you have, and giving all necessary information. What you were trying to achieve, how did you try to do it, what happened and what did you expect to happen.<br />
<br />
Then WAIT for someone to notice you.<br />
<br />
== Configure Options ==<br />
<br />
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:<br />
<br />
<code><pre><br />
$ scons --help<br />
scons: Reading SConscript files ...<br />
make: Nothing to be done for `all'.<br />
Succes building streflop!<br />
Updating bitmaps.sdz<br />
Updating springcontent.sdz<br />
scons: done reading SConscript files.<br />
<br />
platform: Set to linux, freebsd or windows<br />
default: None<br />
actual: linux<br />
<br />
debug: Set to yes to produce a binary with debug information<br />
default: 0<br />
actual: 3<br />
<br />
debugdefines: Set to no to suppress DEBUG and _DEBUG preprocessor #defines \<br />
(use to add symbols to release build)<br />
default: True<br />
actual: True<br />
<br />
syncdebug: Set to yes to enable the sync debugger<br />
default: False<br />
actual: False<br />
<br />
synccheck: Set to yes to enable sync checker & resyncer<br />
default: True<br />
actual: True<br />
<br />
optimize: Enable processor optimizations during compilation<br />
default: 1<br />
actual: 2<br />
<br />
profile: Set to yes to produce a binary with profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_generate: Set to yes to compile with -fprofile-generate \<br />
to generate profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_use: Set to yes to compile with -fprofile-use to use \<br />
profiling information<br />
default: False<br />
actual: False<br />
<br />
cpppath: Set path to extra header files<br />
default: []<br />
actual:<br />
<br />
libpath: Set path to extra libraries<br />
default: []<br />
actual:<br />
<br />
fpmath: Set to 387 or SSE on i386 and AMD64 architectures<br />
default: 387<br />
actual: 387<br />
<br />
prefix: Install prefix used at runtime<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
installprefix: Install prefix used for installion<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
datadir: Data directory (relative to prefix)<br />
default: share/games/spring<br />
actual: share/games/spring<br />
<br />
bindir: Directory for executables (rel. to prefix)<br />
default: games<br />
actual: games<br />
<br />
libdir: Directory for AI plugin modules (rel. to prefix)<br />
default: lib/spring<br />
actual: lib/spring<br />
<br />
strip: Discard symbols from the executable (only when neither \<br />
debugging nor profiling)<br />
default: True<br />
actual: False<br />
<br />
disable_avi: Set to no to turn on avi support<br />
default: False on windows, True otherwise<br />
actual: True<br />
<br />
use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation<br />
default: False<br />
actual: False<br />
<br />
use_mmgr: Use memory manager<br />
default: False<br />
actual: False<br />
<br />
dc_allowed: Specifies whether FPS mode (Direct Control) is allowed in game<br />
default: True<br />
actual: True<br />
<br />
cachedir: Cache directory (see scons manual)<br />
default: None<br />
actual:<br />
<br />
Use scons -H for help about command-line options.<br />
</pre></code></div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=Troubleshooting_linux&diff=18386Troubleshooting linux2008-04-02T02:05:22Z<p>LordMatt: /* Map is White */</p>
<hr />
<div>= Troubleshooting =<br />
<br />
== Ingame ==<br />
<br />
=== LuaUI Crash Ingame ===<br />
<br />
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:<br />
<br />
<code><pre><br />
/resbar 1<br />
/tooltip 1<br />
</pre></code><br />
<br />
These might not be necessary in 0.75 anymore at all.<br />
<br />
Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.<br />
<br />
LuaUI can also be restarted after it crashed. Often this does the trick and it works fine the rest of the game:<br />
<br />
<code><pre><br />
/luaui reload<br />
</pre></code><br />
<br />
=== Mouse is slow in fullscreen mode ===<br />
<br />
Run:<br />
<code><pre><br />
echo 'export SDL_MOUSE_RELATIVE=0' >> ~/.bash_profile<br />
</pre></code><br />
And log out and log in again.<br />
<br />
The mouse should now be as fast as in windowed mode.<br />
<br />
=== Rotating Buildings Ingame ===<br />
<br />
You can rotate a building before you give the build order, but the keys that do this don't work in linux by default for some users. Issue the following commands in the beginning of the game:<br />
<br />
<code><pre><br />
/bind keycodex buildfacing inc<br />
/bind keycodey buildfacing dec<br />
</pre></code><br />
<br />
Keycodex and keycodey above are just placeholders. What you want to write depends on which key you want to use. To see what keycodes any keys have, do:<br />
<br />
<code><pre><br />
/keydebug yes<br />
</pre></code><br />
<br />
And then hit the keys you want to use, and spring prints the keycodes in the message buffer.<br />
<br />
TODO: add information on how to save the settings so that they work the next time you start spring.<br />
<br />
=== Map is White ===<br />
<br />
If the whole map is only shades of white and grey, there is a problem with your display driver. Maybe your gpu is very old and does not support some needed opengl feature. For example I had this problem with matrox g550 but not with some very old geforce.<br />
<br />
=== Sound is Choppy ===<br />
<br />
If the engine sound is very broken or choppy sounding, and you hear some noise or crackling, you need to tell OpenAL to try to use a different sound backend. If you don't have an ~/.openalrc file, create it with these contents, or modify your current one to look like this:<br />
<br />
(define devices '(native alsa sdl arts esd null))<br />
(define alsa-device "dsp0")<br />
(define speaker-num 2)<br />
;(define sampling-rate 22050)<br />
<br />
The important line here is the "define devices" line, OpenAL attempts to use each of those sound output methods in order. It uses the first one that works; in some cases native will work best, in other cases perhaps alsa. If Gnome is running its sound daemon, esd would be the best choice, while KDE usually uses artsd.<br />
<br />
== Startup ==<br />
<br />
=== Missing Default Cursor ===<br />
<br />
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 [[SetupGuide#OTA_Content|earlier in this document]].<br />
<br />
=== could not open file: gamedata/defs.lua ===<br />
<br />
Make sure your ~/.spring does not contain an outdated version of base/springcontent.sdz because a new version of this file is distributed with spring.<br />
If you do, just remove it.<br />
<br />
=== sounds/button9.wav "cant find wav file" ===<br />
<br />
Same problem as above.<br />
<br />
=== Couldnt find matching GLX visual ===<br />
<br />
Reduce anti aliasing.<br />
<br />
=== GL_ARB_texture_compression not found ===<br />
<br />
This can be an issue with your gpu drivers. The drivers you are using do not support a feature that is required to run spring. You might have better luck with the closed source official drivers of nvidia or amd cards. If your gpu itself is really old, this might not help.<br />
<br />
If you use the fglrx ati-graphics driver and you are getting this error there might be a chance that still spring work (I use this with ubuntu gusty).<br />
At first we must check that fglrx is installed correctly:<br />
<br />
<code><pre><br />
~$ fglrxinfo<br />
display: :0.0 screen: 0<br />
OpenGL vendor string: ATI Technologies Inc.<br />
OpenGL renderer string: ATI Mobility Radeon X1400<br />
OpenGL version string: 2.0.6747 (8.40.4)<br />
</pre></code><br />
<br />
Then lets check the glx-extention.<br />
<br />
<code><pre><br />
~$ glxinfo | grep direct<br />
Xlib: extension "XFree86-DRI" missing on display ":1.0".<br />
direct rendering: No<br />
</pre></code><br />
<br />
If you get this message, notice that glxinfo releates to display ':1' and fglrxinfo to display ':0'!! Lets check the glx-extention on display :0 now.<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 glxinfo | grep direct<br />
direct rendering: Yes<br />
</pre></code><br />
<br />
This message mean that you can start spring by typing (in a terminal)<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 spring<br />
</pre></code><br />
<br />
If you use the TASclient with wine and the native linux spring. Start the whole TASclient-start-script by typing. <br />
<br />
<code><pre><br />
DISPLAY=:0 TASCLIENT-start-script<br />
</pre></code><br />
<br />
But Notice under circumstances is no windowmanager running on screen :0! This means there are NO windowframes at the TASClient window! You can't move it or close it by clicking the closebutton (unless you click at the close button on the terminal-window in witch you startet TAS). You can although close TAS with the keys ALT-F4<br />
<br />
=== OpenAL Segfault ===<br />
<br />
If spring crashes with this output:<br />
<br />
<code><pre><br />
OpenAL: ALC_EXT_capture AL_EXT_capture AL_EXT_vorbis AL_EXT_MP3<br />
AL_LOKI_quadriphonic AL_LOKI_play_position AL_LOKI_WAVE_format<br />
AL_LOKI_IMA_ADPCM_format AL_LOKI_buffer_data_callback ALC_LOKI_audio_channel<br />
Segmentation fault (core dumped)<br />
</pre></code><br />
<br />
Look into this thread on the forums for a fix: http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12568<br />
<br />
Then bug nemo in #taspring to finish this troubleshooting entry. He knows how to fix it.<br />
<br />
This is mod-related, ie. it only happens on some mods. Please list here the mod versions that give this error for you.<br />
<br />
- Star Wars mod, unknown version, by user report<br />
<br />
The problematic mod contains a sound file that crashes openal. You can try to unzip the mod file that crashed for you, and play each sound file. Please report any sound files that fail to play right, just list them here.<br />
<br />
- unknown file<br />
<br />
== Compiletime ==<br />
<br />
=== make_gamedata_arch.sh not found ===<br />
<br />
The .zip you downloaded is for windows, you must download a .bz2, instructions [[SetupGuide#Downloading_A_Tarball|earlier in this document]].<br />
<br />
=== invalid use of ILvoid ===<br />
<br />
During compiling, if you get a lot of the following errors:<br />
<br />
<code><pre><br />
/usr/include/IL/il.h:497: error: '<anonymous>' has incomplete type <br />
/usr/include/IL/il.h:497: error: invalid use of 'ILvoid'<br />
</pre></code><br />
<br />
This happens because the version of libdevil-dev you have installed is not compatible with gcc version 4.2 and newer.<br />
<br />
You should upgrade your libdevil-dev to fix this issue. However, in some distributions (at least gentoo), the fixed package has the SAME version number as the older unfixed package, so you might actually need to remove your current libdevil-dev package completely and reinstall it.<br />
<br />
TODO: add critical version numbers of libdevil.<br />
<br />
== Network Setup ==<br />
<br />
Usually you don't need to do any network setup whatsoever, because the lobbies take care of nat traversal with firewall hole punching, but if you need to know the topology, it goes like this:<br />
<br />
Host needs to enable incoming udp to port 8452, and outgoing replies to those.<br />
Non-host players need to enable outgoing udp, and incoming replies to those.<br />
So basically only non-host players initiate "connections", and only the server listens on a well-known port.<br />
<br />
== If You Still Have Problems ==<br />
<br />
Join to #taspring on Freenode or #sy on QuakeNet and try your luck.<br />
<br />
However, generic linux problems not really related to installing this should be asked elsewhere.<br />
<br />
Prepare to list your distribution, which installation method you used, and what exactly is the error. Don't ask if people are around or not, just go straight to business and tell all details, for maximizing your chances of getting help.<br />
<br />
== IRC ==<br />
<br />
# #taspring @ FreeNode<br />
# #sy @ QuakeNet<br />
<br />
== Asking For Help ==<br />
<br />
Ok so you need human help. This is how '''NOT''' to do it:<br />
<br />
<code><pre><br />
15:54 -!- **** [n=****@*] has joined #taspring<br />
15:54 < ****> Hi, i have a problem with compiling spring on debian<br />
15:54 < ****> can anyone help me?<br />
15:57 -!- **** [n=****@*] has quit [Client Quit]<br />
</pre></code><br />
<br />
Don't ask to ask, instead go straight to business by stating the exact problem you have, and giving all necessary information. What you were trying to achieve, how did you try to do it, what happened and what did you expect to happen.<br />
<br />
Then WAIT for someone to notice you.<br />
<br />
== Configure Options ==<br />
<br />
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:<br />
<br />
<code><pre><br />
$ scons --help<br />
scons: Reading SConscript files ...<br />
make: Nothing to be done for `all'.<br />
Succes building streflop!<br />
Updating bitmaps.sdz<br />
Updating springcontent.sdz<br />
scons: done reading SConscript files.<br />
<br />
platform: Set to linux, freebsd or windows<br />
default: None<br />
actual: linux<br />
<br />
debug: Set to yes to produce a binary with debug information<br />
default: 0<br />
actual: 3<br />
<br />
debugdefines: Set to no to suppress DEBUG and _DEBUG preprocessor #defines \<br />
(use to add symbols to release build)<br />
default: True<br />
actual: True<br />
<br />
syncdebug: Set to yes to enable the sync debugger<br />
default: False<br />
actual: False<br />
<br />
synccheck: Set to yes to enable sync checker & resyncer<br />
default: True<br />
actual: True<br />
<br />
optimize: Enable processor optimizations during compilation<br />
default: 1<br />
actual: 2<br />
<br />
profile: Set to yes to produce a binary with profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_generate: Set to yes to compile with -fprofile-generate \<br />
to generate profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_use: Set to yes to compile with -fprofile-use to use \<br />
profiling information<br />
default: False<br />
actual: False<br />
<br />
cpppath: Set path to extra header files<br />
default: []<br />
actual:<br />
<br />
libpath: Set path to extra libraries<br />
default: []<br />
actual:<br />
<br />
fpmath: Set to 387 or SSE on i386 and AMD64 architectures<br />
default: 387<br />
actual: 387<br />
<br />
prefix: Install prefix used at runtime<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
installprefix: Install prefix used for installion<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
datadir: Data directory (relative to prefix)<br />
default: share/games/spring<br />
actual: share/games/spring<br />
<br />
bindir: Directory for executables (rel. to prefix)<br />
default: games<br />
actual: games<br />
<br />
libdir: Directory for AI plugin modules (rel. to prefix)<br />
default: lib/spring<br />
actual: lib/spring<br />
<br />
strip: Discard symbols from the executable (only when neither \<br />
debugging nor profiling)<br />
default: True<br />
actual: False<br />
<br />
disable_avi: Set to no to turn on avi support<br />
default: False on windows, True otherwise<br />
actual: True<br />
<br />
use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation<br />
default: False<br />
actual: False<br />
<br />
use_mmgr: Use memory manager<br />
default: False<br />
actual: False<br />
<br />
dc_allowed: Specifies whether FPS mode (Direct Control) is allowed in game<br />
default: True<br />
actual: True<br />
<br />
cachedir: Cache directory (see scons manual)<br />
default: None<br />
actual:<br />
<br />
Use scons -H for help about command-line options.<br />
</pre></code></div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=SetupGuide&diff=16688SetupGuide2008-03-08T22:43:43Z<p>LordMatt: /* TASClient */</p>
<hr />
<div>'''Fully updated for 0.76b1'''<br />
<br />
= Page Maintenance =<br />
<br />
When I first installed spring on linux, it was damn hard. I almost gave up a couple times, but finally got it to work, after lots of time wasted.<br />
<br />
This setup guide was horribly outdated back then. Since I liked the game, I gave sth back, by updating this page, and some patches for engine. It wasn't very hard to update this page, it just took some time and effort. Now it's basically in a state, where almost every question on the irc channel regarding linux setup is already answered here, if people just bother to check.<br />
<br />
This page doesn't probably require so much modification in the future, assuming no major changes to spring installation procedure. But I am not going to do that, I have no time anymore. This is probably the only up to date page on the whole wiki, and it might be that it again becomes outdated. So I challenge everyone who ever got helped by this page to keep it up to date in the future. <br />
<br />
It's a wiki so everyone can edit it, so when you see something that is wrong or missing, just fix it, and that means you! Making an account is trivial.<br />
<br />
- semi<br />
<br />
= Install =<br />
<br />
== Version ==<br />
<br />
'''The guide is fully up to date with release 0.76b1.'''<br />
<br />
To play online, you must have the same version as everyone else in the game.<br />
<br />
Most people should get the current release, version 0.76b1. There are usually<br />
between 100 and 200 people online in the lobby, and if you want to play with<br />
them, you need this.<br />
<br />
'''Do not use older than current release version''', unless you really know what you are doing.<br />
<br />
If you want to see the bleeding edge, you can checkout svn head of spring, but<br />
it can not be used to play with people who have the release, so you are<br />
practically limited to playing against nemo. This is mainly interesting for<br />
people who want to contribute to the project, for testing, finding bugs and<br />
fixing them, and implementing new features. Head can be seriously broken from<br />
time to time, or not even compile.<br />
<br />
== Packages ==<br />
<br />
If there is a package for your distributions preferred package manager, it is<br />
recommended to use it instead of compiling the program yourself from sources.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Etch ===<br />
<br />
This is not updated for 0.76b1. Somebody check if the install succeeds for the new release this way?<br />
<br />
This is for version 0.75b2.<br />
<br />
We need to use Yokozar's Ubuntu package, so we need some tricks.<br />
<br />
The --build step will take about 15 minutes. Hopefully we have precompiled binaries for etch soon too.<br />
<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
<br />
sudo apt-get update<br />
sudo apt-get build-dep spring -y<br />
sudo apt-get --build source spring -y<br />
sudo dpkg -i spring_0.75~b2-1_i386.deb spring-data_0.75~b2-1_all.deb<br />
</pre></code><br />
<br />
If you want to install SpringLobby also, follow the instructions in http://trac.springlobby.info/wiki/Install#Debian<br />
<br />
Your paths are: Spring executable in <code>/usr/games/spring </code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Unstable ===<br />
<br />
This is for version 0.76b1<br />
<br />
Ubuntu instructions work for debian unstable as is at the moment.<br />
Except two extra steps:<br />
<code><pre><br />
wget -q http://apt.wxwidgets.org/key.asc -O- | sudo apt-key add -<br />
<br />
echo "deb http://apt.wxwidgets.org/ etch-wx main" >> /etc/apt/sources.list<br />
</pre></code><br />
The rest is right below.<br />
<br />
=== http://www.springlobby.info/images/ubuntu-small.png Ubuntu ===<br />
<br />
This is for version 0.76b1.<br />
<br />
We now have a maintained and up to date APT repository for Ubuntu 7.10 (Gutsy)<br />
<br />
If you have some older version of ubuntu, you can easily upgrade to Gutsy with these instructions: http://www.ubuntu.com/getubuntu/upgrading<br />
<br />
Do the following:<br />
<br />
'''These lines are long and they are split to match the formatting of this page, you can copy-paste this to your terminal as is, as long as you copy the entire wrapped command and not just one line.'''<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
'''NOTE:''' If you get a "sudo" error (1st command) or an "unsupported scheme" error (2nd command) with the above code, then try this code instead:<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | sudo apt-key add -<br />
</pre></code><br />
<br />
<code><pre><br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
<code><pre><br />
sudo apt-get update<br />
sudo apt-get install spring spring-lobby-springlobby spring-maps-default -y<br />
</pre></code><br />
<br />
<br />
Also, if you want to download a few large maps you can do following:<br />
<br />
<code>sudo apt-get install spring-maps-hunterw spring-maps-deltasiege spring-maps-smallsupreme spring-maps-teamplay</code><br />
<br />
<br />
If you own the original Total Annihilation and want to use mods that require the original TA content, then do:<br />
<br />
<code>sudo apt-get install spring-data-nonfree</code><br />
<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at <code>/usr/games/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
IF the above do not work, read the following forum post regarding downloading Spring using the Synaptic Package Manager (GUI).<br />
[http://spring.clan-sy.com/phpbb/viewtopic.php?p=262539#p262539 Download using Synaptic Package Manager]<br />
<br />
=== http://www.winehq.org/images/distro/slackware.png Slackware 12 ===<br />
<br />
Working for version 0.76b1.<br />
<br />
There is all dependencies in precompiled tgz's:<br />
<br />
glew (http://www.linuxpackages.net/pkg_details.php?id=12051)<br/><br />
DeviL (http://www.linuxpackages.net/pkg_details.php?id=10571)<br/><br />
boost (http://www.linuxpackages.net/pkg_details.php?id=12046)<br/><br />
icu (http://www.linuxpackages.net/pkg_details.php?id=12034)<br/><br />
openal (http://www.linuxpackages.net/pkg_details.php?id=11993)<br/><br />
wxWidgets (http://www.linuxpackages.net/pkg_details.php?id=12072)<br/><br />
springlobby (http://www.linuxpackages.net/pkg_details.php?id=12177)<br/><br />
spring - thanks to leo moisio - (http://www.springlobby.info/slackware/spring-0.76b1-i486-1leo.tgz)<br/><br />
<br />
assuming that all .tgz are saved in the same direcory, open a console and cd inside that directory; later:<br />
<code><pre><br />
su -c "installpkg *.tgz"<br />
</pre></code><br />
<br />
when asked for the root password, give it.<br />
<br />
a menu entre for spring and another to springlobby will apear in KDE, XFCE and GNOME.<br />
<br />
also, spring and springlobby executables will be accessible via shell; put it on you fluxbox menu, ;D<br />
<br />
=== http://www.springlobby.info/images/gentoo-small.png Gentoo ===<br />
<br />
This is for version 0.76b1.<br />
<br />
'''OVERLAY CHANGED 2008-01-21. SpringLobby and Spring overlays are merged, so you need to add this overlay, if you haven't already, so you can upgrade again. If you are new user, you can ignore this.'''<br />
<br />
An overlay to use with layman is provided. If gentoo overlays and/or layman are new to you, [http://overlays.gentoo.org/ read about them], as they are an essential part of gentoo.<br />
<br />
This example assumes you never used layman before. If it's not your first time, you hopefully know what to do.<br />
<br />
<code><pre><br />
emerge layman<br />
layman -f -a springlobby \<br />
-o http://svn.springlobby.info/trunk/gentoo/overlays.xml<br />
echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf<br />
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords<br />
echo "games-util/springlobby ~x86" >> /etc/portage/package.keywords<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Layman makes upgrading really easy too:<br />
<br />
<code><pre><br />
layman --sync ALL<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
<br />
=== http://upload.wikimedia.org/wikipedia/en/thumb/9/95/Mandriva_logo.png/96px-Mandriva_logo.png Mandriva ===<br />
<br />
This is for version 0.76b1.<br />
<br />
Mandriva has Spring in the official Contrib repositories, follow the instructions at [http://easyurpmi.zarb.org Easy Urpmi] to add contrib mirrors<br />
<br />
after being done, to install enter the following command in a console:<br />
<br />
<code>su root -C "urpmi spring"</code><br />
<br />
and select yes to the confirmation question<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at /usr/games/spring and read-only data in /usr/share/games/spring.<br />
<br />
=== Binary for Other Linux Systems ===<br />
<br />
This is for version 0.76b1.<br />
<br />
There is an unofficial installer if none of the above work for you:<br />
http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12802<br />
<br />
== Build From Source ==<br />
<br />
'''You might encounter sync errors in online play if you are not using the exact same version of the compiler and same compiler settings as used for prebuilt packages!'''<br />
<br />
For 0.76b1 these are: TODO add them here.<br />
<br />
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.<br />
<br />
=== Get Source ===<br />
<br />
You can either download the source as a 3.9MB tarball (recommended; v. 0.76b1) or get it from the subversion repository. Either way, the result is the same.<br />
<br />
==== Tarball ====<br />
<br />
<code><pre><br />
cd /usr/local/src # or /var/tmp, or whatever<br />
wget http://spring.clan-sy.com/dl/spring_0.76b1_src.tar.bz2<br />
tar xjf spring_0.76b1_src.tar.bz2<br />
cd spring_0.76b1<br />
</pre></code><br />
<br />
'''NOTE: The .zip release is for windows only. Linux users have to get .bz2 like shown above.'''<br />
<br />
==== Subversion ====<br />
<br />
<code><pre><br />
aptitude install subversion # if you are not on debian, figure it out<br />
svn co https://spring.clan-sy.com/svn/spring/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
cd /usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
If the above subversion host happens to be down (which is unlikely since you're reading this wiki page now), you can try the following hourly updated mirror (replace the svn co line above with the following line):<br />
<code><pre><br />
svn co svn://caspring.org:3691/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
=== Dependencies ===<br />
<br />
For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the<br />
following to be the minimal set that is necessary to get. I have not tested<br />
with any version of Ubuntu, but the line is probably almost identical if not<br />
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007 WORKS. Note<br />
that Spring 0.75b2 depends on the boost libraries version 1.34.* and won't<br />
work on lower versions. (updated libboost-serialization-dev, and libvorbis-dev dependencies for 0.76b1)<br />
<br />
Also, on 64-bit be sure to build against devIl 1.6.8-rc2 or higher, 1.6.7 has a bug in the PNG loading code that causes issues.<br />
<br />
<code><pre><br />
aptitude install scons build-essential zlib1g-dev libfreetype6-dev<br />
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev<br />
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev<br />
aptitude install libboost-serialization-dev python2.5-dev zip<br />
aptitude install sun-java6-jdk libvorbis-dev<br />
</pre></code><br />
<br />
This has been tested to work with a clean install of gentoo 2007.0:<br />
<br />
<code><pre><br />
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0<br />
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost<br />
emerge media-libs/devil app-arch/zip media-libs/libogg<br />
</pre></code><br />
<br />
On Fedora 8, these dependencies should be sufficient:<br />
<br />
<code><pre><br />
yum install scons boost-devel openal-devel SDL-devel libvorbis-devel <br />
yum install devIl-devel glew-devel java-1.7.0-icedtea-devel<br />
</pre></code><br />
Users of other distributions should be able to figure out the correct package<br />
names from this. The scons configure will whine if you forget something, but it<br />
does not check if you remembered to install zip, even though you still need it.<br />
<br />
=== Build And Install ===<br />
<br />
The build will spew out warnings like the following, which you can safely ignore:<br />
<br />
<code><pre><br />
warning: division by zero<br />
warning: 'q' may be used uninitialized in this function<br />
</pre></code><br />
<br />
Configure and build:<br />
<br />
<code><pre><br />
scons configure<br />
scons<br />
</pre></code><br />
<br />
Install:<br />
<br />
<code><pre><br />
scons install<br />
mkdir -p /etc/spring<br />
echo '$HOME/.spring' > /etc/spring/datadir<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/local/games/spring</code> and<br />
read-only data in <code>/usr/local/share/games/spring</code>.<br />
<br />
== Network ==<br />
<br />
If you have a public ip and no firewall, then you don't need to do anything.<br />
<br />
If you don't want to host any games, just join them, you shouldn't need to do anything.<br />
<br />
If you have a firewall, to be able to host, you must enable incoming udp to port 8452. If you are behind a NAT, to be able to host you must either use nat traversal / hole punching feature in your lobby client, OR port forward that port from your public ip to your gaming machine.<br />
<br />
= Finalizing installation =<br />
<br />
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.<br />
<br />
I'm assuming bash here, but you can use anything you like to do it of course.<br />
<br />
== Data Directories ==<br />
<br />
Do this to create your per-user data directories. You will be downloading maps and mods etc to these dirs later.<br />
<br />
<code><pre><br />
mkdir -p ~/.spring/{base,maps,mods}<br />
</pre></code><br />
<br />
If the above did not work for you, then you can try:<br />
<br />
<code><pre><br />
mkdir ~/.spring ~/.spring/base ~/.spring/maps ~/.spring/mods<br />
</pre></code><br />
<br />
== Maps ==<br />
<br />
You need at least one map to succesfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
== Mods ==<br />
<br />
You need at least one mod to successfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.<br />
<br />
== OTA Content ==<br />
<br />
If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:<br />
<br />
<code><pre><br />
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip<br />
unzip -d ~/.spring/base base-ota-content.zip<br />
</pre></code><br />
<br />
Note that you need to own a copy of Total Annihilation, to download this file legally.<br />
<br />
Mods that do not require this file are at least NanoBlobs and Kernel Panic, TODO list other mods that don't need it.<br />
<br />
== Settings == <br />
<br />
Defaults should be usable, so you can ignore this until you want to maximize your eye candy or fps :)<br />
<br />
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.<br />
<br />
If you want a tool for editing the file, you can use [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] ([http://springlobby.info SpringLobby] has this integrated).<br />
<br />
=== Dual Head ===<br />
<br />
Automatic: if you are using [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] you can select a dual screen resolution in simple mode and the rest is done automatically. <br />
<br />
Manual: to make Dual Monitors work add/change these settings in your .springrc file. <br />
"DualScreenMiniMapOnLeft=1,<br />
DualScreenMode=1,<br />
XResolution=2560,<br />
YResolution=1024"<br />
<br />
Make sure to use your own resolution for the X,Y resolutions. For example: you have two monitors configured for 1280x1024, the X,Y is 2560x1024.<br />
<br />
Save then restart Spring.<br />
<br />
== LuaUI ==<br />
<br />
Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.<br />
<br />
Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI. <br />
<br />
To install some LuaUI scripts, start by copying LuaUI folder from you read-only data directory to your read-write data directory.<br />
<br />
<code><pre><br />
rm -r ~/.spring/LuaUI<br />
cp -r /usr/share/games/spring/LuaUI ~/.spring/LuaUI<br />
</pre></code><br />
<br />
Then go find the LuaUI scripts you need from [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section]. All LuaUI scripts are released there, so if you make good ones yourself, make sure to upload them.<br />
<br />
The scripts can come in any setup, so prepare to decompress them if they are compressed. They might have a whole directory structure, and they should have their own instructions on how to install them. Check which directory you need to extract them to. Most likely it is ~/.spring/LuaUI but it might be a directory inside this directory too for some script.<br />
<br />
Once you have copied the script into place, when you start spring next time, you can press F11 to enable/disable anything from your list of installed LuaUI scripts. If your new script is not there, you copied it wrong.<br />
<br />
== Lobby Client ==<br />
<br />
To setup online games, you need a lobby client. There are several options to choose from.<br />
<br />
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.<br />
<br />
Recommended lobby client for linux is either SpringLobby or AFLobby. You can use them in windows and mac too.<br />
<br />
=== Omni ===<br />
<br />
This project has been abandoned, and you should not use it.<br />
<br />
=== UnityLobby ===<br />
<br />
UnityLobby has been abandoned since april 2007, and you should not use it.<br />
<br />
=== [http://springlobby.info SpringLobby] ===<br />
<br />
SpringLobby is for (at least) Windows, Linux and Mac. It's now in a usable state and has a feature set close to that of TASClient for windows. Try it out! Bug reports and feature requests are very much welcome.<br />
<br />
Visit http://springlobby.info for all things SpringLobby.<br />
<br />
=== AFLobby ===<br />
<br />
This project is very promising, and is usable for online multi player. Its the oldest lobby still actively maintained.<br />
<br />
Official webpage for the project is http://www.darkstars.co.uk which should always have the latest release for download.<br />
<br />
=== [http://spring.clan-sy.com/wiki/TASClient_with_Wine TASClient] ===<br />
<br />
To run the default windows lobby client under Linux, you will need to install wine and do a fairly large amount of [http://spring.clan-sy.com/wiki/TASClient_with_Wine configuration]. If you don't want to spend the time setting up TASClient, use springlobby instead. TASClient has been around for the longest period of time, however, and has some features that the newer lobbies have not yet implemented.<br />
<br />
= Troubleshooting =<br />
<br />
== Ingame ==<br />
<br />
=== LuaUI Crash Ingame ===<br />
<br />
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:<br />
<br />
<code><pre><br />
/resbar 1<br />
/tooltip 1<br />
</pre></code><br />
<br />
These might not be necessary in 0.75 anymore at all.<br />
<br />
Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.<br />
<br />
LuaUI can also be restarted after it crashed. Often this does the trick and it works fine the rest of the game:<br />
<br />
<code><pre><br />
/luaui reload<br />
</pre></code><br />
<br />
=== Mouse is slow in fullscreen mode ===<br />
<br />
Run:<br />
<code><pre><br />
echo 'export SDL_MOUSE_RELATIVE=0' >> ~/.bash_profile<br />
</pre></code><br />
And log out and log in again.<br />
<br />
The mouse should now be as fast as in windowed mode.<br />
<br />
=== Rotating Buildings Ingame ===<br />
<br />
You can rotate a building before you give the build order, but the keys that do this don't work in linux by default for some users. Issue the following commands in the beginning of the game:<br />
<br />
<code><pre><br />
/bind keycodex buildfacing inc<br />
/bind keycodey buildfacing dec<br />
</pre></code><br />
<br />
Keycodex and keycodey above are just placeholders. What you want to write depends on which key you want to use. To see what keycodes any keys have, do:<br />
<br />
<code><pre><br />
/keydebug yes<br />
</pre></code><br />
<br />
And then hit the keys you want to use, and spring prints the keycodes in the message buffer.<br />
<br />
TODO: add information on how to save the settings so that they work the next time you start spring.<br />
<br />
=== Map is White ===<br />
<br />
If the whole map is only shades of white and grey, there is a problem with your display driver. Maybe your gpu is very old and does not support some needed opengl feature. For example I had this problem with matrox g550 but not with some very old geforce.<br />
<br />
== Startup ==<br />
<br />
=== Missing Default Cursor ===<br />
<br />
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 [[SetupGuide#OTA_Content|earlier in this document]].<br />
<br />
=== could not open file: gamedata/defs.lua ===<br />
<br />
Make sure your ~/.spring does not contain an outdated version of base/springcontent.sdz because a new version of this file is distributed with spring.<br />
If you do, just remove it.<br />
<br />
=== sounds/button9.wav "cant find wav file" ===<br />
<br />
Same problem as above.<br />
<br />
=== Couldnt find matching GLX visual ===<br />
<br />
Reduce anti aliasing.<br />
<br />
=== GL_ARB_texture_compression not found ===<br />
<br />
This can be an issue with your gpu drivers. The drivers you are using do not support a feature that is required to run spring. You might have better luck with the closed source official drivers of nvidia or amd cards. If your gpu itself is really old, this might not help.<br />
<br />
If you use the fglrx ati-graphics driver and you are getting this error there might be a chance that still spring work (I use this with ubuntu gusty).<br />
At first we must check that fglrx is installed correctly:<br />
<br />
<code><pre><br />
~$ fglrxinfo<br />
display: :0.0 screen: 0<br />
OpenGL vendor string: ATI Technologies Inc.<br />
OpenGL renderer string: ATI Mobility Radeon X1400<br />
OpenGL version string: 2.0.6747 (8.40.4)<br />
</pre></code><br />
<br />
Then lets check the glx-extention.<br />
<br />
<code><pre><br />
~$ glxinfo | grep direct<br />
Xlib: extension "XFree86-DRI" missing on display ":1.0".<br />
direct rendering: No<br />
</pre></code><br />
<br />
If you get this message, notice that glxinfo releates to display ':1' and fglrxinfo to display ':0'!! Lets check the glx-extention on display :0 now.<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 glxinfo | grep direct<br />
direct rendering: Yes<br />
</pre></code><br />
<br />
This message mean that you can start spring by typing (in a terminal)<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 spring<br />
</pre></code><br />
<br />
If you use the TASclient with wine and the native linux spring. Start the whole TASclient-start-script by typing. <br />
<br />
<code><pre><br />
DISPLAY=:0 TASCLIENT-start-script<br />
</pre></code><br />
<br />
But Notice under circumstances is no windowmanager running on screen :0! This means there are NO windowframes at the TASClient window! You can't move it or close it by clicking the closebutton (unless you click at the close button on the terminal-window in witch you startet TAS). You can although close TAS with the keys ALT-F4<br />
<br />
=== OpenAL Segfault ===<br />
<br />
If spring crashes with this output:<br />
<br />
<code><pre><br />
OpenAL: ALC_EXT_capture AL_EXT_capture AL_EXT_vorbis AL_EXT_MP3<br />
AL_LOKI_quadriphonic AL_LOKI_play_position AL_LOKI_WAVE_format<br />
AL_LOKI_IMA_ADPCM_format AL_LOKI_buffer_data_callback ALC_LOKI_audio_channel<br />
Segmentation fault (core dumped)<br />
</pre></code><br />
<br />
Look into this thread on the forums for a fix: http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12568<br />
<br />
Then bug nemo in #taspring to finish this troubleshooting entry. He knows how to fix it.<br />
<br />
This is mod-related, ie. it only happens on some mods. Please list here the mod versions that give this error for you.<br />
<br />
- Star Wars mod, unknown version, by user report<br />
<br />
The problematic mod contains a sound file that crashes openal. You can try to unzip the mod file that crashed for you, and play each sound file. Please report any sound files that fail to play right, just list them here.<br />
<br />
- unknown file<br />
<br />
== Compiletime ==<br />
<br />
=== make_gamedata_arch.sh not found ===<br />
<br />
The .zip you downloaded is for windows, you must download a .bz2, instructions [[SetupGuide#Downloading_A_Tarball|earlier in this document]].<br />
<br />
=== invalid use of ILvoid ===<br />
<br />
During compiling, if you get a lot of the following errors:<br />
<br />
<code><pre><br />
/usr/include/IL/il.h:497: error: '<anonymous>' has incomplete type <br />
/usr/include/IL/il.h:497: error: invalid use of 'ILvoid'<br />
</pre></code><br />
<br />
This happens because the version of libdevil-dev you have installed is not compatible with gcc version 4.2 and newer.<br />
<br />
You should upgrade your libdevil-dev to fix this issue. However, in some distributions (at least gentoo), the fixed package has the SAME version number as the older unfixed package, so you might actually need to remove your current libdevil-dev package completely and reinstall it.<br />
<br />
TODO: add critical version numbers of libdevil.<br />
<br />
== Network Setup ==<br />
<br />
Usually you don't need to do any network setup whatsoever, because the lobbies take care of nat traversal with firewall hole punching, but if you need to know the topology, it goes like this:<br />
<br />
Host needs to enable incoming udp to port 8452, and outgoing replies to those.<br />
Non-host players need to enable outgoing udp, and incoming replies to those.<br />
So basically only non-host players initiate "connections", and only the server listens on a well-known port.<br />
<br />
== If You Still Have Problems ==<br />
<br />
Join to #taspring on Freenode or #sy on QuakeNet and try your luck.<br />
<br />
However, generic linux problems not really related to installing this should be asked elsewhere.<br />
<br />
Prepare to list your distribution, which installation method you used, and what exactly is the error. Don't ask if people are around or not, just go straight to business and tell all details, for maximizing your chances of getting help.<br />
<br />
== IRC ==<br />
<br />
# #taspring @ FreeNode<br />
# #sy @ QuakeNet<br />
<br />
== Asking For Help ==<br />
<br />
Ok so you need human help. This is how '''NOT''' to do it:<br />
<br />
<code><pre><br />
15:54 -!- **** [n=****@*] has joined #taspring<br />
15:54 < ****> Hi, i have a problem with compiling spring on debian<br />
15:54 < ****> can anyone help me?<br />
15:57 -!- **** [n=****@*] has quit [Client Quit]<br />
</pre></code><br />
<br />
Don't ask to ask, instead go straight to business by stating the exact problem you have, and giving all necessary information. What you were trying to achieve, how did you try to do it, what happened and what did you expect to happen.<br />
<br />
Then WAIT for someone to notice you.<br />
<br />
== Configure Options ==<br />
<br />
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:<br />
<br />
<code><pre><br />
$ scons --help<br />
scons: Reading SConscript files ...<br />
make: Nothing to be done for `all'.<br />
Succes building streflop!<br />
Updating bitmaps.sdz<br />
Updating springcontent.sdz<br />
scons: done reading SConscript files.<br />
<br />
platform: Set to linux, freebsd or windows<br />
default: None<br />
actual: linux<br />
<br />
debug: Set to yes to produce a binary with debug information<br />
default: 0<br />
actual: 3<br />
<br />
debugdefines: Set to no to suppress DEBUG and _DEBUG preprocessor #defines \<br />
(use to add symbols to release build)<br />
default: True<br />
actual: True<br />
<br />
syncdebug: Set to yes to enable the sync debugger<br />
default: False<br />
actual: False<br />
<br />
synccheck: Set to yes to enable sync checker & resyncer<br />
default: True<br />
actual: True<br />
<br />
optimize: Enable processor optimizations during compilation<br />
default: 1<br />
actual: 2<br />
<br />
profile: Set to yes to produce a binary with profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_generate: Set to yes to compile with -fprofile-generate \<br />
to generate profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_use: Set to yes to compile with -fprofile-use to use \<br />
profiling information<br />
default: False<br />
actual: False<br />
<br />
cpppath: Set path to extra header files<br />
default: []<br />
actual:<br />
<br />
libpath: Set path to extra libraries<br />
default: []<br />
actual:<br />
<br />
fpmath: Set to 387 or SSE on i386 and AMD64 architectures<br />
default: 387<br />
actual: 387<br />
<br />
prefix: Install prefix used at runtime<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
installprefix: Install prefix used for installion<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
datadir: Data directory (relative to prefix)<br />
default: share/games/spring<br />
actual: share/games/spring<br />
<br />
bindir: Directory for executables (rel. to prefix)<br />
default: games<br />
actual: games<br />
<br />
libdir: Directory for AI plugin modules (rel. to prefix)<br />
default: lib/spring<br />
actual: lib/spring<br />
<br />
strip: Discard symbols from the executable (only when neither \<br />
debugging nor profiling)<br />
default: True<br />
actual: False<br />
<br />
disable_avi: Set to no to turn on avi support<br />
default: False on windows, True otherwise<br />
actual: True<br />
<br />
use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation<br />
default: False<br />
actual: False<br />
<br />
use_mmgr: Use memory manager<br />
default: False<br />
actual: False<br />
<br />
dc_allowed: Specifies whether FPS mode (Direct Control) is allowed in game<br />
default: True<br />
actual: True<br />
<br />
cachedir: Cache directory (see scons manual)<br />
default: None<br />
actual:<br />
<br />
Use scons -H for help about command-line options.<br />
</pre></code><br />
<br />
= Tips =<br />
<br />
'''This section contains just some old crap I didn't write, and shouldn't be necessary.'''<br />
<br />
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.<br />
<br />
* 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)<br><br><code>(define devices '(alsa))<br>(define speaker-num 2)<br><br>(define alsa-out-device "hw:0,0")<br>(define alsa-in-device "hw:0,0")</code><br><br>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.<br />
<br />
* 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...<br />
:* Just poke any developer on IRC:<br />
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]<br />
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]<br />
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]<br />
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].<br />
<br />
''' [[Main_Page|<- Back to Main page]]'''<br />
<br />
[[Category:Linux Port]][[Category:Playing]]</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=SetupGuide&diff=16687SetupGuide2008-03-08T22:42:17Z<p>LordMatt: /* TASClient */</p>
<hr />
<div>'''Fully updated for 0.76b1'''<br />
<br />
= Page Maintenance =<br />
<br />
When I first installed spring on linux, it was damn hard. I almost gave up a couple times, but finally got it to work, after lots of time wasted.<br />
<br />
This setup guide was horribly outdated back then. Since I liked the game, I gave sth back, by updating this page, and some patches for engine. It wasn't very hard to update this page, it just took some time and effort. Now it's basically in a state, where almost every question on the irc channel regarding linux setup is already answered here, if people just bother to check.<br />
<br />
This page doesn't probably require so much modification in the future, assuming no major changes to spring installation procedure. But I am not going to do that, I have no time anymore. This is probably the only up to date page on the whole wiki, and it might be that it again becomes outdated. So I challenge everyone who ever got helped by this page to keep it up to date in the future. <br />
<br />
It's a wiki so everyone can edit it, so when you see something that is wrong or missing, just fix it, and that means you! Making an account is trivial.<br />
<br />
- semi<br />
<br />
= Install =<br />
<br />
== Version ==<br />
<br />
'''The guide is fully up to date with release 0.76b1.'''<br />
<br />
To play online, you must have the same version as everyone else in the game.<br />
<br />
Most people should get the current release, version 0.76b1. There are usually<br />
between 100 and 200 people online in the lobby, and if you want to play with<br />
them, you need this.<br />
<br />
'''Do not use older than current release version''', unless you really know what you are doing.<br />
<br />
If you want to see the bleeding edge, you can checkout svn head of spring, but<br />
it can not be used to play with people who have the release, so you are<br />
practically limited to playing against nemo. This is mainly interesting for<br />
people who want to contribute to the project, for testing, finding bugs and<br />
fixing them, and implementing new features. Head can be seriously broken from<br />
time to time, or not even compile.<br />
<br />
== Packages ==<br />
<br />
If there is a package for your distributions preferred package manager, it is<br />
recommended to use it instead of compiling the program yourself from sources.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Etch ===<br />
<br />
This is not updated for 0.76b1. Somebody check if the install succeeds for the new release this way?<br />
<br />
This is for version 0.75b2.<br />
<br />
We need to use Yokozar's Ubuntu package, so we need some tricks.<br />
<br />
The --build step will take about 15 minutes. Hopefully we have precompiled binaries for etch soon too.<br />
<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
<br />
sudo apt-get update<br />
sudo apt-get build-dep spring -y<br />
sudo apt-get --build source spring -y<br />
sudo dpkg -i spring_0.75~b2-1_i386.deb spring-data_0.75~b2-1_all.deb<br />
</pre></code><br />
<br />
If you want to install SpringLobby also, follow the instructions in http://trac.springlobby.info/wiki/Install#Debian<br />
<br />
Your paths are: Spring executable in <code>/usr/games/spring </code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Unstable ===<br />
<br />
This is for version 0.76b1<br />
<br />
Ubuntu instructions work for debian unstable as is at the moment.<br />
Except two extra steps:<br />
<code><pre><br />
wget -q http://apt.wxwidgets.org/key.asc -O- | sudo apt-key add -<br />
<br />
echo "deb http://apt.wxwidgets.org/ etch-wx main" >> /etc/apt/sources.list<br />
</pre></code><br />
The rest is right below.<br />
<br />
=== http://www.springlobby.info/images/ubuntu-small.png Ubuntu ===<br />
<br />
This is for version 0.76b1.<br />
<br />
We now have a maintained and up to date APT repository for Ubuntu 7.10 (Gutsy)<br />
<br />
If you have some older version of ubuntu, you can easily upgrade to Gutsy with these instructions: http://www.ubuntu.com/getubuntu/upgrading<br />
<br />
Do the following:<br />
<br />
'''These lines are long and they are split to match the formatting of this page, you can copy-paste this to your terminal as is, as long as you copy the entire wrapped command and not just one line.'''<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
'''NOTE:''' If you get a "sudo" error (1st command) or an "unsupported scheme" error (2nd command) with the above code, then try this code instead:<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | sudo apt-key add -<br />
</pre></code><br />
<br />
<code><pre><br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
<code><pre><br />
sudo apt-get update<br />
sudo apt-get install spring spring-lobby-springlobby spring-maps-default -y<br />
</pre></code><br />
<br />
<br />
Also, if you want to download a few large maps you can do following:<br />
<br />
<code>sudo apt-get install spring-maps-hunterw spring-maps-deltasiege spring-maps-smallsupreme spring-maps-teamplay</code><br />
<br />
<br />
If you own the original Total Annihilation and want to use mods that require the original TA content, then do:<br />
<br />
<code>sudo apt-get install spring-data-nonfree</code><br />
<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at <code>/usr/games/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
IF the above do not work, read the following forum post regarding downloading Spring using the Synaptic Package Manager (GUI).<br />
[http://spring.clan-sy.com/phpbb/viewtopic.php?p=262539#p262539 Download using Synaptic Package Manager]<br />
<br />
=== http://www.winehq.org/images/distro/slackware.png Slackware 12 ===<br />
<br />
Working for version 0.76b1.<br />
<br />
There is all dependencies in precompiled tgz's:<br />
<br />
glew (http://www.linuxpackages.net/pkg_details.php?id=12051)<br/><br />
DeviL (http://www.linuxpackages.net/pkg_details.php?id=10571)<br/><br />
boost (http://www.linuxpackages.net/pkg_details.php?id=12046)<br/><br />
icu (http://www.linuxpackages.net/pkg_details.php?id=12034)<br/><br />
openal (http://www.linuxpackages.net/pkg_details.php?id=11993)<br/><br />
wxWidgets (http://www.linuxpackages.net/pkg_details.php?id=12072)<br/><br />
springlobby (http://www.linuxpackages.net/pkg_details.php?id=12177)<br/><br />
spring - thanks to leo moisio - (http://www.springlobby.info/slackware/spring-0.76b1-i486-1leo.tgz)<br/><br />
<br />
assuming that all .tgz are saved in the same direcory, open a console and cd inside that directory; later:<br />
<code><pre><br />
su -c "installpkg *.tgz"<br />
</pre></code><br />
<br />
when asked for the root password, give it.<br />
<br />
a menu entre for spring and another to springlobby will apear in KDE, XFCE and GNOME.<br />
<br />
also, spring and springlobby executables will be accessible via shell; put it on you fluxbox menu, ;D<br />
<br />
=== http://www.springlobby.info/images/gentoo-small.png Gentoo ===<br />
<br />
This is for version 0.76b1.<br />
<br />
'''OVERLAY CHANGED 2008-01-21. SpringLobby and Spring overlays are merged, so you need to add this overlay, if you haven't already, so you can upgrade again. If you are new user, you can ignore this.'''<br />
<br />
An overlay to use with layman is provided. If gentoo overlays and/or layman are new to you, [http://overlays.gentoo.org/ read about them], as they are an essential part of gentoo.<br />
<br />
This example assumes you never used layman before. If it's not your first time, you hopefully know what to do.<br />
<br />
<code><pre><br />
emerge layman<br />
layman -f -a springlobby \<br />
-o http://svn.springlobby.info/trunk/gentoo/overlays.xml<br />
echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf<br />
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords<br />
echo "games-util/springlobby ~x86" >> /etc/portage/package.keywords<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Layman makes upgrading really easy too:<br />
<br />
<code><pre><br />
layman --sync ALL<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
<br />
=== http://upload.wikimedia.org/wikipedia/en/thumb/9/95/Mandriva_logo.png/96px-Mandriva_logo.png Mandriva ===<br />
<br />
This is for version 0.76b1.<br />
<br />
Mandriva has Spring in the official Contrib repositories, follow the instructions at [http://easyurpmi.zarb.org Easy Urpmi] to add contrib mirrors<br />
<br />
after being done, to install enter the following command in a console:<br />
<br />
<code>su root -C "urpmi spring"</code><br />
<br />
and select yes to the confirmation question<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at /usr/games/spring and read-only data in /usr/share/games/spring.<br />
<br />
=== Binary for Other Linux Systems ===<br />
<br />
This is for version 0.76b1.<br />
<br />
There is an unofficial installer if none of the above work for you:<br />
http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12802<br />
<br />
== Build From Source ==<br />
<br />
'''You might encounter sync errors in online play if you are not using the exact same version of the compiler and same compiler settings as used for prebuilt packages!'''<br />
<br />
For 0.76b1 these are: TODO add them here.<br />
<br />
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.<br />
<br />
=== Get Source ===<br />
<br />
You can either download the source as a 3.9MB tarball (recommended; v. 0.76b1) or get it from the subversion repository. Either way, the result is the same.<br />
<br />
==== Tarball ====<br />
<br />
<code><pre><br />
cd /usr/local/src # or /var/tmp, or whatever<br />
wget http://spring.clan-sy.com/dl/spring_0.76b1_src.tar.bz2<br />
tar xjf spring_0.76b1_src.tar.bz2<br />
cd spring_0.76b1<br />
</pre></code><br />
<br />
'''NOTE: The .zip release is for windows only. Linux users have to get .bz2 like shown above.'''<br />
<br />
==== Subversion ====<br />
<br />
<code><pre><br />
aptitude install subversion # if you are not on debian, figure it out<br />
svn co https://spring.clan-sy.com/svn/spring/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
cd /usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
If the above subversion host happens to be down (which is unlikely since you're reading this wiki page now), you can try the following hourly updated mirror (replace the svn co line above with the following line):<br />
<code><pre><br />
svn co svn://caspring.org:3691/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
=== Dependencies ===<br />
<br />
For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the<br />
following to be the minimal set that is necessary to get. I have not tested<br />
with any version of Ubuntu, but the line is probably almost identical if not<br />
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007 WORKS. Note<br />
that Spring 0.75b2 depends on the boost libraries version 1.34.* and won't<br />
work on lower versions. (updated libboost-serialization-dev, and libvorbis-dev dependencies for 0.76b1)<br />
<br />
Also, on 64-bit be sure to build against devIl 1.6.8-rc2 or higher, 1.6.7 has a bug in the PNG loading code that causes issues.<br />
<br />
<code><pre><br />
aptitude install scons build-essential zlib1g-dev libfreetype6-dev<br />
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev<br />
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev<br />
aptitude install libboost-serialization-dev python2.5-dev zip<br />
aptitude install sun-java6-jdk libvorbis-dev<br />
</pre></code><br />
<br />
This has been tested to work with a clean install of gentoo 2007.0:<br />
<br />
<code><pre><br />
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0<br />
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost<br />
emerge media-libs/devil app-arch/zip media-libs/libogg<br />
</pre></code><br />
<br />
On Fedora 8, these dependencies should be sufficient:<br />
<br />
<code><pre><br />
yum install scons boost-devel openal-devel SDL-devel libvorbis-devel <br />
yum install devIl-devel glew-devel java-1.7.0-icedtea-devel<br />
</pre></code><br />
Users of other distributions should be able to figure out the correct package<br />
names from this. The scons configure will whine if you forget something, but it<br />
does not check if you remembered to install zip, even though you still need it.<br />
<br />
=== Build And Install ===<br />
<br />
The build will spew out warnings like the following, which you can safely ignore:<br />
<br />
<code><pre><br />
warning: division by zero<br />
warning: 'q' may be used uninitialized in this function<br />
</pre></code><br />
<br />
Configure and build:<br />
<br />
<code><pre><br />
scons configure<br />
scons<br />
</pre></code><br />
<br />
Install:<br />
<br />
<code><pre><br />
scons install<br />
mkdir -p /etc/spring<br />
echo '$HOME/.spring' > /etc/spring/datadir<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/local/games/spring</code> and<br />
read-only data in <code>/usr/local/share/games/spring</code>.<br />
<br />
== Network ==<br />
<br />
If you have a public ip and no firewall, then you don't need to do anything.<br />
<br />
If you don't want to host any games, just join them, you shouldn't need to do anything.<br />
<br />
If you have a firewall, to be able to host, you must enable incoming udp to port 8452. If you are behind a NAT, to be able to host you must either use nat traversal / hole punching feature in your lobby client, OR port forward that port from your public ip to your gaming machine.<br />
<br />
= Finalizing installation =<br />
<br />
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.<br />
<br />
I'm assuming bash here, but you can use anything you like to do it of course.<br />
<br />
== Data Directories ==<br />
<br />
Do this to create your per-user data directories. You will be downloading maps and mods etc to these dirs later.<br />
<br />
<code><pre><br />
mkdir -p ~/.spring/{base,maps,mods}<br />
</pre></code><br />
<br />
If the above did not work for you, then you can try:<br />
<br />
<code><pre><br />
mkdir ~/.spring ~/.spring/base ~/.spring/maps ~/.spring/mods<br />
</pre></code><br />
<br />
== Maps ==<br />
<br />
You need at least one map to succesfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
== Mods ==<br />
<br />
You need at least one mod to successfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.<br />
<br />
== OTA Content ==<br />
<br />
If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:<br />
<br />
<code><pre><br />
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip<br />
unzip -d ~/.spring/base base-ota-content.zip<br />
</pre></code><br />
<br />
Note that you need to own a copy of Total Annihilation, to download this file legally.<br />
<br />
Mods that do not require this file are at least NanoBlobs and Kernel Panic, TODO list other mods that don't need it.<br />
<br />
== Settings == <br />
<br />
Defaults should be usable, so you can ignore this until you want to maximize your eye candy or fps :)<br />
<br />
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.<br />
<br />
If you want a tool for editing the file, you can use [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] ([http://springlobby.info SpringLobby] has this integrated).<br />
<br />
=== Dual Head ===<br />
<br />
Automatic: if you are using [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] you can select a dual screen resolution in simple mode and the rest is done automatically. <br />
<br />
Manual: to make Dual Monitors work add/change these settings in your .springrc file. <br />
"DualScreenMiniMapOnLeft=1,<br />
DualScreenMode=1,<br />
XResolution=2560,<br />
YResolution=1024"<br />
<br />
Make sure to use your own resolution for the X,Y resolutions. For example: you have two monitors configured for 1280x1024, the X,Y is 2560x1024.<br />
<br />
Save then restart Spring.<br />
<br />
== LuaUI ==<br />
<br />
Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.<br />
<br />
Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI. <br />
<br />
To install some LuaUI scripts, start by copying LuaUI folder from you read-only data directory to your read-write data directory.<br />
<br />
<code><pre><br />
rm -r ~/.spring/LuaUI<br />
cp -r /usr/share/games/spring/LuaUI ~/.spring/LuaUI<br />
</pre></code><br />
<br />
Then go find the LuaUI scripts you need from [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section]. All LuaUI scripts are released there, so if you make good ones yourself, make sure to upload them.<br />
<br />
The scripts can come in any setup, so prepare to decompress them if they are compressed. They might have a whole directory structure, and they should have their own instructions on how to install them. Check which directory you need to extract them to. Most likely it is ~/.spring/LuaUI but it might be a directory inside this directory too for some script.<br />
<br />
Once you have copied the script into place, when you start spring next time, you can press F11 to enable/disable anything from your list of installed LuaUI scripts. If your new script is not there, you copied it wrong.<br />
<br />
== Lobby Client ==<br />
<br />
To setup online games, you need a lobby client. There are several options to choose from.<br />
<br />
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.<br />
<br />
Recommended lobby client for linux is either SpringLobby or AFLobby. You can use them in windows and mac too.<br />
<br />
=== Omni ===<br />
<br />
This project has been abandoned, and you should not use it.<br />
<br />
=== UnityLobby ===<br />
<br />
UnityLobby has been abandoned since april 2007, and you should not use it.<br />
<br />
=== [http://springlobby.info SpringLobby] ===<br />
<br />
SpringLobby is for (at least) Windows, Linux and Mac. It's now in a usable state and has a feature set close to that of TASClient for windows. Try it out! Bug reports and feature requests are very much welcome.<br />
<br />
Visit http://springlobby.info for all things SpringLobby.<br />
<br />
=== AFLobby ===<br />
<br />
This project is very promising, and is usable for online multi player. Its the oldest lobby still actively maintained.<br />
<br />
Official webpage for the project is http://www.darkstars.co.uk which should always have the latest release for download.<br />
<br />
=== TASClient ===<br />
<br />
To run the default windows lobby client under Linux, you will need to install wine and do a fairly large amount of configuration. If you don't want to spend the time setting up TASClient, use springlobby instead. TASClient has been around for the longest period of time, however, and has some features that the newer lobbies have not yet implemented.<br />
<br />
= Troubleshooting =<br />
<br />
== Ingame ==<br />
<br />
=== LuaUI Crash Ingame ===<br />
<br />
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:<br />
<br />
<code><pre><br />
/resbar 1<br />
/tooltip 1<br />
</pre></code><br />
<br />
These might not be necessary in 0.75 anymore at all.<br />
<br />
Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.<br />
<br />
LuaUI can also be restarted after it crashed. Often this does the trick and it works fine the rest of the game:<br />
<br />
<code><pre><br />
/luaui reload<br />
</pre></code><br />
<br />
=== Mouse is slow in fullscreen mode ===<br />
<br />
Run:<br />
<code><pre><br />
echo 'export SDL_MOUSE_RELATIVE=0' >> ~/.bash_profile<br />
</pre></code><br />
And log out and log in again.<br />
<br />
The mouse should now be as fast as in windowed mode.<br />
<br />
=== Rotating Buildings Ingame ===<br />
<br />
You can rotate a building before you give the build order, but the keys that do this don't work in linux by default for some users. Issue the following commands in the beginning of the game:<br />
<br />
<code><pre><br />
/bind keycodex buildfacing inc<br />
/bind keycodey buildfacing dec<br />
</pre></code><br />
<br />
Keycodex and keycodey above are just placeholders. What you want to write depends on which key you want to use. To see what keycodes any keys have, do:<br />
<br />
<code><pre><br />
/keydebug yes<br />
</pre></code><br />
<br />
And then hit the keys you want to use, and spring prints the keycodes in the message buffer.<br />
<br />
TODO: add information on how to save the settings so that they work the next time you start spring.<br />
<br />
=== Map is White ===<br />
<br />
If the whole map is only shades of white and grey, there is a problem with your display driver. Maybe your gpu is very old and does not support some needed opengl feature. For example I had this problem with matrox g550 but not with some very old geforce.<br />
<br />
== Startup ==<br />
<br />
=== Missing Default Cursor ===<br />
<br />
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 [[SetupGuide#OTA_Content|earlier in this document]].<br />
<br />
=== could not open file: gamedata/defs.lua ===<br />
<br />
Make sure your ~/.spring does not contain an outdated version of base/springcontent.sdz because a new version of this file is distributed with spring.<br />
If you do, just remove it.<br />
<br />
=== sounds/button9.wav "cant find wav file" ===<br />
<br />
Same problem as above.<br />
<br />
=== Couldnt find matching GLX visual ===<br />
<br />
Reduce anti aliasing.<br />
<br />
=== GL_ARB_texture_compression not found ===<br />
<br />
This can be an issue with your gpu drivers. The drivers you are using do not support a feature that is required to run spring. You might have better luck with the closed source official drivers of nvidia or amd cards. If your gpu itself is really old, this might not help.<br />
<br />
If you use the fglrx ati-graphics driver and you are getting this error there might be a chance that still spring work (I use this with ubuntu gusty).<br />
At first we must check that fglrx is installed correctly:<br />
<br />
<code><pre><br />
~$ fglrxinfo<br />
display: :0.0 screen: 0<br />
OpenGL vendor string: ATI Technologies Inc.<br />
OpenGL renderer string: ATI Mobility Radeon X1400<br />
OpenGL version string: 2.0.6747 (8.40.4)<br />
</pre></code><br />
<br />
Then lets check the glx-extention.<br />
<br />
<code><pre><br />
~$ glxinfo | grep direct<br />
Xlib: extension "XFree86-DRI" missing on display ":1.0".<br />
direct rendering: No<br />
</pre></code><br />
<br />
If you get this message, notice that glxinfo releates to display ':1' and fglrxinfo to display ':0'!! Lets check the glx-extention on display :0 now.<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 glxinfo | grep direct<br />
direct rendering: Yes<br />
</pre></code><br />
<br />
This message mean that you can start spring by typing (in a terminal)<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 spring<br />
</pre></code><br />
<br />
If you use the TASclient with wine and the native linux spring. Start the whole TASclient-start-script by typing. <br />
<br />
<code><pre><br />
DISPLAY=:0 TASCLIENT-start-script<br />
</pre></code><br />
<br />
But Notice under circumstances is no windowmanager running on screen :0! This means there are NO windowframes at the TASClient window! You can't move it or close it by clicking the closebutton (unless you click at the close button on the terminal-window in witch you startet TAS). You can although close TAS with the keys ALT-F4<br />
<br />
=== OpenAL Segfault ===<br />
<br />
If spring crashes with this output:<br />
<br />
<code><pre><br />
OpenAL: ALC_EXT_capture AL_EXT_capture AL_EXT_vorbis AL_EXT_MP3<br />
AL_LOKI_quadriphonic AL_LOKI_play_position AL_LOKI_WAVE_format<br />
AL_LOKI_IMA_ADPCM_format AL_LOKI_buffer_data_callback ALC_LOKI_audio_channel<br />
Segmentation fault (core dumped)<br />
</pre></code><br />
<br />
Look into this thread on the forums for a fix: http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12568<br />
<br />
Then bug nemo in #taspring to finish this troubleshooting entry. He knows how to fix it.<br />
<br />
This is mod-related, ie. it only happens on some mods. Please list here the mod versions that give this error for you.<br />
<br />
- Star Wars mod, unknown version, by user report<br />
<br />
The problematic mod contains a sound file that crashes openal. You can try to unzip the mod file that crashed for you, and play each sound file. Please report any sound files that fail to play right, just list them here.<br />
<br />
- unknown file<br />
<br />
== Compiletime ==<br />
<br />
=== make_gamedata_arch.sh not found ===<br />
<br />
The .zip you downloaded is for windows, you must download a .bz2, instructions [[SetupGuide#Downloading_A_Tarball|earlier in this document]].<br />
<br />
=== invalid use of ILvoid ===<br />
<br />
During compiling, if you get a lot of the following errors:<br />
<br />
<code><pre><br />
/usr/include/IL/il.h:497: error: '<anonymous>' has incomplete type <br />
/usr/include/IL/il.h:497: error: invalid use of 'ILvoid'<br />
</pre></code><br />
<br />
This happens because the version of libdevil-dev you have installed is not compatible with gcc version 4.2 and newer.<br />
<br />
You should upgrade your libdevil-dev to fix this issue. However, in some distributions (at least gentoo), the fixed package has the SAME version number as the older unfixed package, so you might actually need to remove your current libdevil-dev package completely and reinstall it.<br />
<br />
TODO: add critical version numbers of libdevil.<br />
<br />
== Network Setup ==<br />
<br />
Usually you don't need to do any network setup whatsoever, because the lobbies take care of nat traversal with firewall hole punching, but if you need to know the topology, it goes like this:<br />
<br />
Host needs to enable incoming udp to port 8452, and outgoing replies to those.<br />
Non-host players need to enable outgoing udp, and incoming replies to those.<br />
So basically only non-host players initiate "connections", and only the server listens on a well-known port.<br />
<br />
== If You Still Have Problems ==<br />
<br />
Join to #taspring on Freenode or #sy on QuakeNet and try your luck.<br />
<br />
However, generic linux problems not really related to installing this should be asked elsewhere.<br />
<br />
Prepare to list your distribution, which installation method you used, and what exactly is the error. Don't ask if people are around or not, just go straight to business and tell all details, for maximizing your chances of getting help.<br />
<br />
== IRC ==<br />
<br />
# #taspring @ FreeNode<br />
# #sy @ QuakeNet<br />
<br />
== Asking For Help ==<br />
<br />
Ok so you need human help. This is how '''NOT''' to do it:<br />
<br />
<code><pre><br />
15:54 -!- **** [n=****@*] has joined #taspring<br />
15:54 < ****> Hi, i have a problem with compiling spring on debian<br />
15:54 < ****> can anyone help me?<br />
15:57 -!- **** [n=****@*] has quit [Client Quit]<br />
</pre></code><br />
<br />
Don't ask to ask, instead go straight to business by stating the exact problem you have, and giving all necessary information. What you were trying to achieve, how did you try to do it, what happened and what did you expect to happen.<br />
<br />
Then WAIT for someone to notice you.<br />
<br />
== Configure Options ==<br />
<br />
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:<br />
<br />
<code><pre><br />
$ scons --help<br />
scons: Reading SConscript files ...<br />
make: Nothing to be done for `all'.<br />
Succes building streflop!<br />
Updating bitmaps.sdz<br />
Updating springcontent.sdz<br />
scons: done reading SConscript files.<br />
<br />
platform: Set to linux, freebsd or windows<br />
default: None<br />
actual: linux<br />
<br />
debug: Set to yes to produce a binary with debug information<br />
default: 0<br />
actual: 3<br />
<br />
debugdefines: Set to no to suppress DEBUG and _DEBUG preprocessor #defines \<br />
(use to add symbols to release build)<br />
default: True<br />
actual: True<br />
<br />
syncdebug: Set to yes to enable the sync debugger<br />
default: False<br />
actual: False<br />
<br />
synccheck: Set to yes to enable sync checker & resyncer<br />
default: True<br />
actual: True<br />
<br />
optimize: Enable processor optimizations during compilation<br />
default: 1<br />
actual: 2<br />
<br />
profile: Set to yes to produce a binary with profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_generate: Set to yes to compile with -fprofile-generate \<br />
to generate profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_use: Set to yes to compile with -fprofile-use to use \<br />
profiling information<br />
default: False<br />
actual: False<br />
<br />
cpppath: Set path to extra header files<br />
default: []<br />
actual:<br />
<br />
libpath: Set path to extra libraries<br />
default: []<br />
actual:<br />
<br />
fpmath: Set to 387 or SSE on i386 and AMD64 architectures<br />
default: 387<br />
actual: 387<br />
<br />
prefix: Install prefix used at runtime<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
installprefix: Install prefix used for installion<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
datadir: Data directory (relative to prefix)<br />
default: share/games/spring<br />
actual: share/games/spring<br />
<br />
bindir: Directory for executables (rel. to prefix)<br />
default: games<br />
actual: games<br />
<br />
libdir: Directory for AI plugin modules (rel. to prefix)<br />
default: lib/spring<br />
actual: lib/spring<br />
<br />
strip: Discard symbols from the executable (only when neither \<br />
debugging nor profiling)<br />
default: True<br />
actual: False<br />
<br />
disable_avi: Set to no to turn on avi support<br />
default: False on windows, True otherwise<br />
actual: True<br />
<br />
use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation<br />
default: False<br />
actual: False<br />
<br />
use_mmgr: Use memory manager<br />
default: False<br />
actual: False<br />
<br />
dc_allowed: Specifies whether FPS mode (Direct Control) is allowed in game<br />
default: True<br />
actual: True<br />
<br />
cachedir: Cache directory (see scons manual)<br />
default: None<br />
actual:<br />
<br />
Use scons -H for help about command-line options.<br />
</pre></code><br />
<br />
= Tips =<br />
<br />
'''This section contains just some old crap I didn't write, and shouldn't be necessary.'''<br />
<br />
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.<br />
<br />
* 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)<br><br><code>(define devices '(alsa))<br>(define speaker-num 2)<br><br>(define alsa-out-device "hw:0,0")<br>(define alsa-in-device "hw:0,0")</code><br><br>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.<br />
<br />
* 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...<br />
:* Just poke any developer on IRC:<br />
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]<br />
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]<br />
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]<br />
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].<br />
<br />
''' [[Main_Page|<- Back to Main page]]'''<br />
<br />
[[Category:Linux Port]][[Category:Playing]]</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=SetupGuide&diff=16686SetupGuide2008-03-08T22:41:58Z<p>LordMatt: /* TASClient */</p>
<hr />
<div>'''Fully updated for 0.76b1'''<br />
<br />
= Page Maintenance =<br />
<br />
When I first installed spring on linux, it was damn hard. I almost gave up a couple times, but finally got it to work, after lots of time wasted.<br />
<br />
This setup guide was horribly outdated back then. Since I liked the game, I gave sth back, by updating this page, and some patches for engine. It wasn't very hard to update this page, it just took some time and effort. Now it's basically in a state, where almost every question on the irc channel regarding linux setup is already answered here, if people just bother to check.<br />
<br />
This page doesn't probably require so much modification in the future, assuming no major changes to spring installation procedure. But I am not going to do that, I have no time anymore. This is probably the only up to date page on the whole wiki, and it might be that it again becomes outdated. So I challenge everyone who ever got helped by this page to keep it up to date in the future. <br />
<br />
It's a wiki so everyone can edit it, so when you see something that is wrong or missing, just fix it, and that means you! Making an account is trivial.<br />
<br />
- semi<br />
<br />
= Install =<br />
<br />
== Version ==<br />
<br />
'''The guide is fully up to date with release 0.76b1.'''<br />
<br />
To play online, you must have the same version as everyone else in the game.<br />
<br />
Most people should get the current release, version 0.76b1. There are usually<br />
between 100 and 200 people online in the lobby, and if you want to play with<br />
them, you need this.<br />
<br />
'''Do not use older than current release version''', unless you really know what you are doing.<br />
<br />
If you want to see the bleeding edge, you can checkout svn head of spring, but<br />
it can not be used to play with people who have the release, so you are<br />
practically limited to playing against nemo. This is mainly interesting for<br />
people who want to contribute to the project, for testing, finding bugs and<br />
fixing them, and implementing new features. Head can be seriously broken from<br />
time to time, or not even compile.<br />
<br />
== Packages ==<br />
<br />
If there is a package for your distributions preferred package manager, it is<br />
recommended to use it instead of compiling the program yourself from sources.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Etch ===<br />
<br />
This is not updated for 0.76b1. Somebody check if the install succeeds for the new release this way?<br />
<br />
This is for version 0.75b2.<br />
<br />
We need to use Yokozar's Ubuntu package, so we need some tricks.<br />
<br />
The --build step will take about 15 minutes. Hopefully we have precompiled binaries for etch soon too.<br />
<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
<br />
sudo apt-get update<br />
sudo apt-get build-dep spring -y<br />
sudo apt-get --build source spring -y<br />
sudo dpkg -i spring_0.75~b2-1_i386.deb spring-data_0.75~b2-1_all.deb<br />
</pre></code><br />
<br />
If you want to install SpringLobby also, follow the instructions in http://trac.springlobby.info/wiki/Install#Debian<br />
<br />
Your paths are: Spring executable in <code>/usr/games/spring </code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Unstable ===<br />
<br />
This is for version 0.76b1<br />
<br />
Ubuntu instructions work for debian unstable as is at the moment.<br />
Except two extra steps:<br />
<code><pre><br />
wget -q http://apt.wxwidgets.org/key.asc -O- | sudo apt-key add -<br />
<br />
echo "deb http://apt.wxwidgets.org/ etch-wx main" >> /etc/apt/sources.list<br />
</pre></code><br />
The rest is right below.<br />
<br />
=== http://www.springlobby.info/images/ubuntu-small.png Ubuntu ===<br />
<br />
This is for version 0.76b1.<br />
<br />
We now have a maintained and up to date APT repository for Ubuntu 7.10 (Gutsy)<br />
<br />
If you have some older version of ubuntu, you can easily upgrade to Gutsy with these instructions: http://www.ubuntu.com/getubuntu/upgrading<br />
<br />
Do the following:<br />
<br />
'''These lines are long and they are split to match the formatting of this page, you can copy-paste this to your terminal as is, as long as you copy the entire wrapped command and not just one line.'''<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
'''NOTE:''' If you get a "sudo" error (1st command) or an "unsupported scheme" error (2nd command) with the above code, then try this code instead:<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | sudo apt-key add -<br />
</pre></code><br />
<br />
<code><pre><br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
<code><pre><br />
sudo apt-get update<br />
sudo apt-get install spring spring-lobby-springlobby spring-maps-default -y<br />
</pre></code><br />
<br />
<br />
Also, if you want to download a few large maps you can do following:<br />
<br />
<code>sudo apt-get install spring-maps-hunterw spring-maps-deltasiege spring-maps-smallsupreme spring-maps-teamplay</code><br />
<br />
<br />
If you own the original Total Annihilation and want to use mods that require the original TA content, then do:<br />
<br />
<code>sudo apt-get install spring-data-nonfree</code><br />
<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at <code>/usr/games/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
IF the above do not work, read the following forum post regarding downloading Spring using the Synaptic Package Manager (GUI).<br />
[http://spring.clan-sy.com/phpbb/viewtopic.php?p=262539#p262539 Download using Synaptic Package Manager]<br />
<br />
=== http://www.winehq.org/images/distro/slackware.png Slackware 12 ===<br />
<br />
Working for version 0.76b1.<br />
<br />
There is all dependencies in precompiled tgz's:<br />
<br />
glew (http://www.linuxpackages.net/pkg_details.php?id=12051)<br/><br />
DeviL (http://www.linuxpackages.net/pkg_details.php?id=10571)<br/><br />
boost (http://www.linuxpackages.net/pkg_details.php?id=12046)<br/><br />
icu (http://www.linuxpackages.net/pkg_details.php?id=12034)<br/><br />
openal (http://www.linuxpackages.net/pkg_details.php?id=11993)<br/><br />
wxWidgets (http://www.linuxpackages.net/pkg_details.php?id=12072)<br/><br />
springlobby (http://www.linuxpackages.net/pkg_details.php?id=12177)<br/><br />
spring - thanks to leo moisio - (http://www.springlobby.info/slackware/spring-0.76b1-i486-1leo.tgz)<br/><br />
<br />
assuming that all .tgz are saved in the same direcory, open a console and cd inside that directory; later:<br />
<code><pre><br />
su -c "installpkg *.tgz"<br />
</pre></code><br />
<br />
when asked for the root password, give it.<br />
<br />
a menu entre for spring and another to springlobby will apear in KDE, XFCE and GNOME.<br />
<br />
also, spring and springlobby executables will be accessible via shell; put it on you fluxbox menu, ;D<br />
<br />
=== http://www.springlobby.info/images/gentoo-small.png Gentoo ===<br />
<br />
This is for version 0.76b1.<br />
<br />
'''OVERLAY CHANGED 2008-01-21. SpringLobby and Spring overlays are merged, so you need to add this overlay, if you haven't already, so you can upgrade again. If you are new user, you can ignore this.'''<br />
<br />
An overlay to use with layman is provided. If gentoo overlays and/or layman are new to you, [http://overlays.gentoo.org/ read about them], as they are an essential part of gentoo.<br />
<br />
This example assumes you never used layman before. If it's not your first time, you hopefully know what to do.<br />
<br />
<code><pre><br />
emerge layman<br />
layman -f -a springlobby \<br />
-o http://svn.springlobby.info/trunk/gentoo/overlays.xml<br />
echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf<br />
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords<br />
echo "games-util/springlobby ~x86" >> /etc/portage/package.keywords<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Layman makes upgrading really easy too:<br />
<br />
<code><pre><br />
layman --sync ALL<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
<br />
=== http://upload.wikimedia.org/wikipedia/en/thumb/9/95/Mandriva_logo.png/96px-Mandriva_logo.png Mandriva ===<br />
<br />
This is for version 0.76b1.<br />
<br />
Mandriva has Spring in the official Contrib repositories, follow the instructions at [http://easyurpmi.zarb.org Easy Urpmi] to add contrib mirrors<br />
<br />
after being done, to install enter the following command in a console:<br />
<br />
<code>su root -C "urpmi spring"</code><br />
<br />
and select yes to the confirmation question<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at /usr/games/spring and read-only data in /usr/share/games/spring.<br />
<br />
=== Binary for Other Linux Systems ===<br />
<br />
This is for version 0.76b1.<br />
<br />
There is an unofficial installer if none of the above work for you:<br />
http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12802<br />
<br />
== Build From Source ==<br />
<br />
'''You might encounter sync errors in online play if you are not using the exact same version of the compiler and same compiler settings as used for prebuilt packages!'''<br />
<br />
For 0.76b1 these are: TODO add them here.<br />
<br />
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.<br />
<br />
=== Get Source ===<br />
<br />
You can either download the source as a 3.9MB tarball (recommended; v. 0.76b1) or get it from the subversion repository. Either way, the result is the same.<br />
<br />
==== Tarball ====<br />
<br />
<code><pre><br />
cd /usr/local/src # or /var/tmp, or whatever<br />
wget http://spring.clan-sy.com/dl/spring_0.76b1_src.tar.bz2<br />
tar xjf spring_0.76b1_src.tar.bz2<br />
cd spring_0.76b1<br />
</pre></code><br />
<br />
'''NOTE: The .zip release is for windows only. Linux users have to get .bz2 like shown above.'''<br />
<br />
==== Subversion ====<br />
<br />
<code><pre><br />
aptitude install subversion # if you are not on debian, figure it out<br />
svn co https://spring.clan-sy.com/svn/spring/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
cd /usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
If the above subversion host happens to be down (which is unlikely since you're reading this wiki page now), you can try the following hourly updated mirror (replace the svn co line above with the following line):<br />
<code><pre><br />
svn co svn://caspring.org:3691/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
=== Dependencies ===<br />
<br />
For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the<br />
following to be the minimal set that is necessary to get. I have not tested<br />
with any version of Ubuntu, but the line is probably almost identical if not<br />
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007 WORKS. Note<br />
that Spring 0.75b2 depends on the boost libraries version 1.34.* and won't<br />
work on lower versions. (updated libboost-serialization-dev, and libvorbis-dev dependencies for 0.76b1)<br />
<br />
Also, on 64-bit be sure to build against devIl 1.6.8-rc2 or higher, 1.6.7 has a bug in the PNG loading code that causes issues.<br />
<br />
<code><pre><br />
aptitude install scons build-essential zlib1g-dev libfreetype6-dev<br />
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev<br />
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev<br />
aptitude install libboost-serialization-dev python2.5-dev zip<br />
aptitude install sun-java6-jdk libvorbis-dev<br />
</pre></code><br />
<br />
This has been tested to work with a clean install of gentoo 2007.0:<br />
<br />
<code><pre><br />
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0<br />
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost<br />
emerge media-libs/devil app-arch/zip media-libs/libogg<br />
</pre></code><br />
<br />
On Fedora 8, these dependencies should be sufficient:<br />
<br />
<code><pre><br />
yum install scons boost-devel openal-devel SDL-devel libvorbis-devel <br />
yum install devIl-devel glew-devel java-1.7.0-icedtea-devel<br />
</pre></code><br />
Users of other distributions should be able to figure out the correct package<br />
names from this. The scons configure will whine if you forget something, but it<br />
does not check if you remembered to install zip, even though you still need it.<br />
<br />
=== Build And Install ===<br />
<br />
The build will spew out warnings like the following, which you can safely ignore:<br />
<br />
<code><pre><br />
warning: division by zero<br />
warning: 'q' may be used uninitialized in this function<br />
</pre></code><br />
<br />
Configure and build:<br />
<br />
<code><pre><br />
scons configure<br />
scons<br />
</pre></code><br />
<br />
Install:<br />
<br />
<code><pre><br />
scons install<br />
mkdir -p /etc/spring<br />
echo '$HOME/.spring' > /etc/spring/datadir<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/local/games/spring</code> and<br />
read-only data in <code>/usr/local/share/games/spring</code>.<br />
<br />
== Network ==<br />
<br />
If you have a public ip and no firewall, then you don't need to do anything.<br />
<br />
If you don't want to host any games, just join them, you shouldn't need to do anything.<br />
<br />
If you have a firewall, to be able to host, you must enable incoming udp to port 8452. If you are behind a NAT, to be able to host you must either use nat traversal / hole punching feature in your lobby client, OR port forward that port from your public ip to your gaming machine.<br />
<br />
= Finalizing installation =<br />
<br />
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.<br />
<br />
I'm assuming bash here, but you can use anything you like to do it of course.<br />
<br />
== Data Directories ==<br />
<br />
Do this to create your per-user data directories. You will be downloading maps and mods etc to these dirs later.<br />
<br />
<code><pre><br />
mkdir -p ~/.spring/{base,maps,mods}<br />
</pre></code><br />
<br />
If the above did not work for you, then you can try:<br />
<br />
<code><pre><br />
mkdir ~/.spring ~/.spring/base ~/.spring/maps ~/.spring/mods<br />
</pre></code><br />
<br />
== Maps ==<br />
<br />
You need at least one map to succesfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
== Mods ==<br />
<br />
You need at least one mod to successfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.<br />
<br />
== OTA Content ==<br />
<br />
If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:<br />
<br />
<code><pre><br />
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip<br />
unzip -d ~/.spring/base base-ota-content.zip<br />
</pre></code><br />
<br />
Note that you need to own a copy of Total Annihilation, to download this file legally.<br />
<br />
Mods that do not require this file are at least NanoBlobs and Kernel Panic, TODO list other mods that don't need it.<br />
<br />
== Settings == <br />
<br />
Defaults should be usable, so you can ignore this until you want to maximize your eye candy or fps :)<br />
<br />
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.<br />
<br />
If you want a tool for editing the file, you can use [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] ([http://springlobby.info SpringLobby] has this integrated).<br />
<br />
=== Dual Head ===<br />
<br />
Automatic: if you are using [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] you can select a dual screen resolution in simple mode and the rest is done automatically. <br />
<br />
Manual: to make Dual Monitors work add/change these settings in your .springrc file. <br />
"DualScreenMiniMapOnLeft=1,<br />
DualScreenMode=1,<br />
XResolution=2560,<br />
YResolution=1024"<br />
<br />
Make sure to use your own resolution for the X,Y resolutions. For example: you have two monitors configured for 1280x1024, the X,Y is 2560x1024.<br />
<br />
Save then restart Spring.<br />
<br />
== LuaUI ==<br />
<br />
Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.<br />
<br />
Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI. <br />
<br />
To install some LuaUI scripts, start by copying LuaUI folder from you read-only data directory to your read-write data directory.<br />
<br />
<code><pre><br />
rm -r ~/.spring/LuaUI<br />
cp -r /usr/share/games/spring/LuaUI ~/.spring/LuaUI<br />
</pre></code><br />
<br />
Then go find the LuaUI scripts you need from [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section]. All LuaUI scripts are released there, so if you make good ones yourself, make sure to upload them.<br />
<br />
The scripts can come in any setup, so prepare to decompress them if they are compressed. They might have a whole directory structure, and they should have their own instructions on how to install them. Check which directory you need to extract them to. Most likely it is ~/.spring/LuaUI but it might be a directory inside this directory too for some script.<br />
<br />
Once you have copied the script into place, when you start spring next time, you can press F11 to enable/disable anything from your list of installed LuaUI scripts. If your new script is not there, you copied it wrong.<br />
<br />
== Lobby Client ==<br />
<br />
To setup online games, you need a lobby client. There are several options to choose from.<br />
<br />
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.<br />
<br />
Recommended lobby client for linux is either SpringLobby or AFLobby. You can use them in windows and mac too.<br />
<br />
=== Omni ===<br />
<br />
This project has been abandoned, and you should not use it.<br />
<br />
=== UnityLobby ===<br />
<br />
UnityLobby has been abandoned since april 2007, and you should not use it.<br />
<br />
=== [http://springlobby.info SpringLobby] ===<br />
<br />
SpringLobby is for (at least) Windows, Linux and Mac. It's now in a usable state and has a feature set close to that of TASClient for windows. Try it out! Bug reports and feature requests are very much welcome.<br />
<br />
Visit http://springlobby.info for all things SpringLobby.<br />
<br />
=== AFLobby ===<br />
<br />
This project is very promising, and is usable for online multi player. Its the oldest lobby still actively maintained.<br />
<br />
Official webpage for the project is http://www.darkstars.co.uk which should always have the latest release for download.<br />
<br />
=== TASClient ===<br />
<br />
To run the default windows lobby client under Linux, you will need to install wine and do a fairly large amount of configuration. If you don't want to spend the time setting up TASClient, use springlobby instead. TASClient has been around for the longest period of time, however, and has some featuers that the newer lobbies have not yet implemented.<br />
<br />
= Troubleshooting =<br />
<br />
== Ingame ==<br />
<br />
=== LuaUI Crash Ingame ===<br />
<br />
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:<br />
<br />
<code><pre><br />
/resbar 1<br />
/tooltip 1<br />
</pre></code><br />
<br />
These might not be necessary in 0.75 anymore at all.<br />
<br />
Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.<br />
<br />
LuaUI can also be restarted after it crashed. Often this does the trick and it works fine the rest of the game:<br />
<br />
<code><pre><br />
/luaui reload<br />
</pre></code><br />
<br />
=== Mouse is slow in fullscreen mode ===<br />
<br />
Run:<br />
<code><pre><br />
echo 'export SDL_MOUSE_RELATIVE=0' >> ~/.bash_profile<br />
</pre></code><br />
And log out and log in again.<br />
<br />
The mouse should now be as fast as in windowed mode.<br />
<br />
=== Rotating Buildings Ingame ===<br />
<br />
You can rotate a building before you give the build order, but the keys that do this don't work in linux by default for some users. Issue the following commands in the beginning of the game:<br />
<br />
<code><pre><br />
/bind keycodex buildfacing inc<br />
/bind keycodey buildfacing dec<br />
</pre></code><br />
<br />
Keycodex and keycodey above are just placeholders. What you want to write depends on which key you want to use. To see what keycodes any keys have, do:<br />
<br />
<code><pre><br />
/keydebug yes<br />
</pre></code><br />
<br />
And then hit the keys you want to use, and spring prints the keycodes in the message buffer.<br />
<br />
TODO: add information on how to save the settings so that they work the next time you start spring.<br />
<br />
=== Map is White ===<br />
<br />
If the whole map is only shades of white and grey, there is a problem with your display driver. Maybe your gpu is very old and does not support some needed opengl feature. For example I had this problem with matrox g550 but not with some very old geforce.<br />
<br />
== Startup ==<br />
<br />
=== Missing Default Cursor ===<br />
<br />
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 [[SetupGuide#OTA_Content|earlier in this document]].<br />
<br />
=== could not open file: gamedata/defs.lua ===<br />
<br />
Make sure your ~/.spring does not contain an outdated version of base/springcontent.sdz because a new version of this file is distributed with spring.<br />
If you do, just remove it.<br />
<br />
=== sounds/button9.wav "cant find wav file" ===<br />
<br />
Same problem as above.<br />
<br />
=== Couldnt find matching GLX visual ===<br />
<br />
Reduce anti aliasing.<br />
<br />
=== GL_ARB_texture_compression not found ===<br />
<br />
This can be an issue with your gpu drivers. The drivers you are using do not support a feature that is required to run spring. You might have better luck with the closed source official drivers of nvidia or amd cards. If your gpu itself is really old, this might not help.<br />
<br />
If you use the fglrx ati-graphics driver and you are getting this error there might be a chance that still spring work (I use this with ubuntu gusty).<br />
At first we must check that fglrx is installed correctly:<br />
<br />
<code><pre><br />
~$ fglrxinfo<br />
display: :0.0 screen: 0<br />
OpenGL vendor string: ATI Technologies Inc.<br />
OpenGL renderer string: ATI Mobility Radeon X1400<br />
OpenGL version string: 2.0.6747 (8.40.4)<br />
</pre></code><br />
<br />
Then lets check the glx-extention.<br />
<br />
<code><pre><br />
~$ glxinfo | grep direct<br />
Xlib: extension "XFree86-DRI" missing on display ":1.0".<br />
direct rendering: No<br />
</pre></code><br />
<br />
If you get this message, notice that glxinfo releates to display ':1' and fglrxinfo to display ':0'!! Lets check the glx-extention on display :0 now.<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 glxinfo | grep direct<br />
direct rendering: Yes<br />
</pre></code><br />
<br />
This message mean that you can start spring by typing (in a terminal)<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 spring<br />
</pre></code><br />
<br />
If you use the TASclient with wine and the native linux spring. Start the whole TASclient-start-script by typing. <br />
<br />
<code><pre><br />
DISPLAY=:0 TASCLIENT-start-script<br />
</pre></code><br />
<br />
But Notice under circumstances is no windowmanager running on screen :0! This means there are NO windowframes at the TASClient window! You can't move it or close it by clicking the closebutton (unless you click at the close button on the terminal-window in witch you startet TAS). You can although close TAS with the keys ALT-F4<br />
<br />
=== OpenAL Segfault ===<br />
<br />
If spring crashes with this output:<br />
<br />
<code><pre><br />
OpenAL: ALC_EXT_capture AL_EXT_capture AL_EXT_vorbis AL_EXT_MP3<br />
AL_LOKI_quadriphonic AL_LOKI_play_position AL_LOKI_WAVE_format<br />
AL_LOKI_IMA_ADPCM_format AL_LOKI_buffer_data_callback ALC_LOKI_audio_channel<br />
Segmentation fault (core dumped)<br />
</pre></code><br />
<br />
Look into this thread on the forums for a fix: http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12568<br />
<br />
Then bug nemo in #taspring to finish this troubleshooting entry. He knows how to fix it.<br />
<br />
This is mod-related, ie. it only happens on some mods. Please list here the mod versions that give this error for you.<br />
<br />
- Star Wars mod, unknown version, by user report<br />
<br />
The problematic mod contains a sound file that crashes openal. You can try to unzip the mod file that crashed for you, and play each sound file. Please report any sound files that fail to play right, just list them here.<br />
<br />
- unknown file<br />
<br />
== Compiletime ==<br />
<br />
=== make_gamedata_arch.sh not found ===<br />
<br />
The .zip you downloaded is for windows, you must download a .bz2, instructions [[SetupGuide#Downloading_A_Tarball|earlier in this document]].<br />
<br />
=== invalid use of ILvoid ===<br />
<br />
During compiling, if you get a lot of the following errors:<br />
<br />
<code><pre><br />
/usr/include/IL/il.h:497: error: '<anonymous>' has incomplete type <br />
/usr/include/IL/il.h:497: error: invalid use of 'ILvoid'<br />
</pre></code><br />
<br />
This happens because the version of libdevil-dev you have installed is not compatible with gcc version 4.2 and newer.<br />
<br />
You should upgrade your libdevil-dev to fix this issue. However, in some distributions (at least gentoo), the fixed package has the SAME version number as the older unfixed package, so you might actually need to remove your current libdevil-dev package completely and reinstall it.<br />
<br />
TODO: add critical version numbers of libdevil.<br />
<br />
== Network Setup ==<br />
<br />
Usually you don't need to do any network setup whatsoever, because the lobbies take care of nat traversal with firewall hole punching, but if you need to know the topology, it goes like this:<br />
<br />
Host needs to enable incoming udp to port 8452, and outgoing replies to those.<br />
Non-host players need to enable outgoing udp, and incoming replies to those.<br />
So basically only non-host players initiate "connections", and only the server listens on a well-known port.<br />
<br />
== If You Still Have Problems ==<br />
<br />
Join to #taspring on Freenode or #sy on QuakeNet and try your luck.<br />
<br />
However, generic linux problems not really related to installing this should be asked elsewhere.<br />
<br />
Prepare to list your distribution, which installation method you used, and what exactly is the error. Don't ask if people are around or not, just go straight to business and tell all details, for maximizing your chances of getting help.<br />
<br />
== IRC ==<br />
<br />
# #taspring @ FreeNode<br />
# #sy @ QuakeNet<br />
<br />
== Asking For Help ==<br />
<br />
Ok so you need human help. This is how '''NOT''' to do it:<br />
<br />
<code><pre><br />
15:54 -!- **** [n=****@*] has joined #taspring<br />
15:54 < ****> Hi, i have a problem with compiling spring on debian<br />
15:54 < ****> can anyone help me?<br />
15:57 -!- **** [n=****@*] has quit [Client Quit]<br />
</pre></code><br />
<br />
Don't ask to ask, instead go straight to business by stating the exact problem you have, and giving all necessary information. What you were trying to achieve, how did you try to do it, what happened and what did you expect to happen.<br />
<br />
Then WAIT for someone to notice you.<br />
<br />
== Configure Options ==<br />
<br />
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:<br />
<br />
<code><pre><br />
$ scons --help<br />
scons: Reading SConscript files ...<br />
make: Nothing to be done for `all'.<br />
Succes building streflop!<br />
Updating bitmaps.sdz<br />
Updating springcontent.sdz<br />
scons: done reading SConscript files.<br />
<br />
platform: Set to linux, freebsd or windows<br />
default: None<br />
actual: linux<br />
<br />
debug: Set to yes to produce a binary with debug information<br />
default: 0<br />
actual: 3<br />
<br />
debugdefines: Set to no to suppress DEBUG and _DEBUG preprocessor #defines \<br />
(use to add symbols to release build)<br />
default: True<br />
actual: True<br />
<br />
syncdebug: Set to yes to enable the sync debugger<br />
default: False<br />
actual: False<br />
<br />
synccheck: Set to yes to enable sync checker & resyncer<br />
default: True<br />
actual: True<br />
<br />
optimize: Enable processor optimizations during compilation<br />
default: 1<br />
actual: 2<br />
<br />
profile: Set to yes to produce a binary with profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_generate: Set to yes to compile with -fprofile-generate \<br />
to generate profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_use: Set to yes to compile with -fprofile-use to use \<br />
profiling information<br />
default: False<br />
actual: False<br />
<br />
cpppath: Set path to extra header files<br />
default: []<br />
actual:<br />
<br />
libpath: Set path to extra libraries<br />
default: []<br />
actual:<br />
<br />
fpmath: Set to 387 or SSE on i386 and AMD64 architectures<br />
default: 387<br />
actual: 387<br />
<br />
prefix: Install prefix used at runtime<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
installprefix: Install prefix used for installion<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
datadir: Data directory (relative to prefix)<br />
default: share/games/spring<br />
actual: share/games/spring<br />
<br />
bindir: Directory for executables (rel. to prefix)<br />
default: games<br />
actual: games<br />
<br />
libdir: Directory for AI plugin modules (rel. to prefix)<br />
default: lib/spring<br />
actual: lib/spring<br />
<br />
strip: Discard symbols from the executable (only when neither \<br />
debugging nor profiling)<br />
default: True<br />
actual: False<br />
<br />
disable_avi: Set to no to turn on avi support<br />
default: False on windows, True otherwise<br />
actual: True<br />
<br />
use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation<br />
default: False<br />
actual: False<br />
<br />
use_mmgr: Use memory manager<br />
default: False<br />
actual: False<br />
<br />
dc_allowed: Specifies whether FPS mode (Direct Control) is allowed in game<br />
default: True<br />
actual: True<br />
<br />
cachedir: Cache directory (see scons manual)<br />
default: None<br />
actual:<br />
<br />
Use scons -H for help about command-line options.<br />
</pre></code><br />
<br />
= Tips =<br />
<br />
'''This section contains just some old crap I didn't write, and shouldn't be necessary.'''<br />
<br />
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.<br />
<br />
* 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)<br><br><code>(define devices '(alsa))<br>(define speaker-num 2)<br><br>(define alsa-out-device "hw:0,0")<br>(define alsa-in-device "hw:0,0")</code><br><br>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.<br />
<br />
* 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...<br />
:* Just poke any developer on IRC:<br />
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]<br />
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]<br />
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]<br />
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].<br />
<br />
''' [[Main_Page|<- Back to Main page]]'''<br />
<br />
[[Category:Linux Port]][[Category:Playing]]</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=SetupGuide&diff=16685SetupGuide2008-03-08T22:38:38Z<p>LordMatt: /* TASClient */</p>
<hr />
<div>'''Fully updated for 0.76b1'''<br />
<br />
= Page Maintenance =<br />
<br />
When I first installed spring on linux, it was damn hard. I almost gave up a couple times, but finally got it to work, after lots of time wasted.<br />
<br />
This setup guide was horribly outdated back then. Since I liked the game, I gave sth back, by updating this page, and some patches for engine. It wasn't very hard to update this page, it just took some time and effort. Now it's basically in a state, where almost every question on the irc channel regarding linux setup is already answered here, if people just bother to check.<br />
<br />
This page doesn't probably require so much modification in the future, assuming no major changes to spring installation procedure. But I am not going to do that, I have no time anymore. This is probably the only up to date page on the whole wiki, and it might be that it again becomes outdated. So I challenge everyone who ever got helped by this page to keep it up to date in the future. <br />
<br />
It's a wiki so everyone can edit it, so when you see something that is wrong or missing, just fix it, and that means you! Making an account is trivial.<br />
<br />
- semi<br />
<br />
= Install =<br />
<br />
== Version ==<br />
<br />
'''The guide is fully up to date with release 0.76b1.'''<br />
<br />
To play online, you must have the same version as everyone else in the game.<br />
<br />
Most people should get the current release, version 0.76b1. There are usually<br />
between 100 and 200 people online in the lobby, and if you want to play with<br />
them, you need this.<br />
<br />
'''Do not use older than current release version''', unless you really know what you are doing.<br />
<br />
If you want to see the bleeding edge, you can checkout svn head of spring, but<br />
it can not be used to play with people who have the release, so you are<br />
practically limited to playing against nemo. This is mainly interesting for<br />
people who want to contribute to the project, for testing, finding bugs and<br />
fixing them, and implementing new features. Head can be seriously broken from<br />
time to time, or not even compile.<br />
<br />
== Packages ==<br />
<br />
If there is a package for your distributions preferred package manager, it is<br />
recommended to use it instead of compiling the program yourself from sources.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Etch ===<br />
<br />
This is not updated for 0.76b1. Somebody check if the install succeeds for the new release this way?<br />
<br />
This is for version 0.75b2.<br />
<br />
We need to use Yokozar's Ubuntu package, so we need some tricks.<br />
<br />
The --build step will take about 15 minutes. Hopefully we have precompiled binaries for etch soon too.<br />
<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
<br />
sudo apt-get update<br />
sudo apt-get build-dep spring -y<br />
sudo apt-get --build source spring -y<br />
sudo dpkg -i spring_0.75~b2-1_i386.deb spring-data_0.75~b2-1_all.deb<br />
</pre></code><br />
<br />
If you want to install SpringLobby also, follow the instructions in http://trac.springlobby.info/wiki/Install#Debian<br />
<br />
Your paths are: Spring executable in <code>/usr/games/spring </code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Unstable ===<br />
<br />
This is for version 0.76b1<br />
<br />
Ubuntu instructions work for debian unstable as is at the moment.<br />
Except two extra steps:<br />
<code><pre><br />
wget -q http://apt.wxwidgets.org/key.asc -O- | sudo apt-key add -<br />
<br />
echo "deb http://apt.wxwidgets.org/ etch-wx main" >> /etc/apt/sources.list<br />
</pre></code><br />
The rest is right below.<br />
<br />
=== http://www.springlobby.info/images/ubuntu-small.png Ubuntu ===<br />
<br />
This is for version 0.76b1.<br />
<br />
We now have a maintained and up to date APT repository for Ubuntu 7.10 (Gutsy)<br />
<br />
If you have some older version of ubuntu, you can easily upgrade to Gutsy with these instructions: http://www.ubuntu.com/getubuntu/upgrading<br />
<br />
Do the following:<br />
<br />
'''These lines are long and they are split to match the formatting of this page, you can copy-paste this to your terminal as is, as long as you copy the entire wrapped command and not just one line.'''<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
'''NOTE:''' If you get a "sudo" error (1st command) or an "unsupported scheme" error (2nd command) with the above code, then try this code instead:<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | sudo apt-key add -<br />
</pre></code><br />
<br />
<code><pre><br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
<code><pre><br />
sudo apt-get update<br />
sudo apt-get install spring spring-lobby-springlobby spring-maps-default -y<br />
</pre></code><br />
<br />
<br />
Also, if you want to download a few large maps you can do following:<br />
<br />
<code>sudo apt-get install spring-maps-hunterw spring-maps-deltasiege spring-maps-smallsupreme spring-maps-teamplay</code><br />
<br />
<br />
If you own the original Total Annihilation and want to use mods that require the original TA content, then do:<br />
<br />
<code>sudo apt-get install spring-data-nonfree</code><br />
<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at <code>/usr/games/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
IF the above do not work, read the following forum post regarding downloading Spring using the Synaptic Package Manager (GUI).<br />
[http://spring.clan-sy.com/phpbb/viewtopic.php?p=262539#p262539 Download using Synaptic Package Manager]<br />
<br />
=== http://www.winehq.org/images/distro/slackware.png Slackware 12 ===<br />
<br />
Working for version 0.76b1.<br />
<br />
There is all dependencies in precompiled tgz's:<br />
<br />
glew (http://www.linuxpackages.net/pkg_details.php?id=12051)<br/><br />
DeviL (http://www.linuxpackages.net/pkg_details.php?id=10571)<br/><br />
boost (http://www.linuxpackages.net/pkg_details.php?id=12046)<br/><br />
icu (http://www.linuxpackages.net/pkg_details.php?id=12034)<br/><br />
openal (http://www.linuxpackages.net/pkg_details.php?id=11993)<br/><br />
wxWidgets (http://www.linuxpackages.net/pkg_details.php?id=12072)<br/><br />
springlobby (http://www.linuxpackages.net/pkg_details.php?id=12177)<br/><br />
spring - thanks to leo moisio - (http://www.springlobby.info/slackware/spring-0.76b1-i486-1leo.tgz)<br/><br />
<br />
assuming that all .tgz are saved in the same direcory, open a console and cd inside that directory; later:<br />
<code><pre><br />
su -c "installpkg *.tgz"<br />
</pre></code><br />
<br />
when asked for the root password, give it.<br />
<br />
a menu entre for spring and another to springlobby will apear in KDE, XFCE and GNOME.<br />
<br />
also, spring and springlobby executables will be accessible via shell; put it on you fluxbox menu, ;D<br />
<br />
=== http://www.springlobby.info/images/gentoo-small.png Gentoo ===<br />
<br />
This is for version 0.76b1.<br />
<br />
'''OVERLAY CHANGED 2008-01-21. SpringLobby and Spring overlays are merged, so you need to add this overlay, if you haven't already, so you can upgrade again. If you are new user, you can ignore this.'''<br />
<br />
An overlay to use with layman is provided. If gentoo overlays and/or layman are new to you, [http://overlays.gentoo.org/ read about them], as they are an essential part of gentoo.<br />
<br />
This example assumes you never used layman before. If it's not your first time, you hopefully know what to do.<br />
<br />
<code><pre><br />
emerge layman<br />
layman -f -a springlobby \<br />
-o http://svn.springlobby.info/trunk/gentoo/overlays.xml<br />
echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf<br />
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords<br />
echo "games-util/springlobby ~x86" >> /etc/portage/package.keywords<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Layman makes upgrading really easy too:<br />
<br />
<code><pre><br />
layman --sync ALL<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
<br />
=== http://upload.wikimedia.org/wikipedia/en/thumb/9/95/Mandriva_logo.png/96px-Mandriva_logo.png Mandriva ===<br />
<br />
This is for version 0.76b1.<br />
<br />
Mandriva has Spring in the official Contrib repositories, follow the instructions at [http://easyurpmi.zarb.org Easy Urpmi] to add contrib mirrors<br />
<br />
after being done, to install enter the following command in a console:<br />
<br />
<code>su root -C "urpmi spring"</code><br />
<br />
and select yes to the confirmation question<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at /usr/games/spring and read-only data in /usr/share/games/spring.<br />
<br />
=== Binary for Other Linux Systems ===<br />
<br />
This is for version 0.76b1.<br />
<br />
There is an unofficial installer if none of the above work for you:<br />
http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12802<br />
<br />
== Build From Source ==<br />
<br />
'''You might encounter sync errors in online play if you are not using the exact same version of the compiler and same compiler settings as used for prebuilt packages!'''<br />
<br />
For 0.76b1 these are: TODO add them here.<br />
<br />
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.<br />
<br />
=== Get Source ===<br />
<br />
You can either download the source as a 3.9MB tarball (recommended; v. 0.76b1) or get it from the subversion repository. Either way, the result is the same.<br />
<br />
==== Tarball ====<br />
<br />
<code><pre><br />
cd /usr/local/src # or /var/tmp, or whatever<br />
wget http://spring.clan-sy.com/dl/spring_0.76b1_src.tar.bz2<br />
tar xjf spring_0.76b1_src.tar.bz2<br />
cd spring_0.76b1<br />
</pre></code><br />
<br />
'''NOTE: The .zip release is for windows only. Linux users have to get .bz2 like shown above.'''<br />
<br />
==== Subversion ====<br />
<br />
<code><pre><br />
aptitude install subversion # if you are not on debian, figure it out<br />
svn co https://spring.clan-sy.com/svn/spring/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
cd /usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
If the above subversion host happens to be down (which is unlikely since you're reading this wiki page now), you can try the following hourly updated mirror (replace the svn co line above with the following line):<br />
<code><pre><br />
svn co svn://caspring.org:3691/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
=== Dependencies ===<br />
<br />
For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the<br />
following to be the minimal set that is necessary to get. I have not tested<br />
with any version of Ubuntu, but the line is probably almost identical if not<br />
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007 WORKS. Note<br />
that Spring 0.75b2 depends on the boost libraries version 1.34.* and won't<br />
work on lower versions. (updated libboost-serialization-dev, and libvorbis-dev dependencies for 0.76b1)<br />
<br />
Also, on 64-bit be sure to build against devIl 1.6.8-rc2 or higher, 1.6.7 has a bug in the PNG loading code that causes issues.<br />
<br />
<code><pre><br />
aptitude install scons build-essential zlib1g-dev libfreetype6-dev<br />
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev<br />
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev<br />
aptitude install libboost-serialization-dev python2.5-dev zip<br />
aptitude install sun-java6-jdk libvorbis-dev<br />
</pre></code><br />
<br />
This has been tested to work with a clean install of gentoo 2007.0:<br />
<br />
<code><pre><br />
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0<br />
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost<br />
emerge media-libs/devil app-arch/zip media-libs/libogg<br />
</pre></code><br />
<br />
On Fedora 8, these dependencies should be sufficient:<br />
<br />
<code><pre><br />
yum install scons boost-devel openal-devel SDL-devel libvorbis-devel <br />
yum install devIl-devel glew-devel java-1.7.0-icedtea-devel<br />
</pre></code><br />
Users of other distributions should be able to figure out the correct package<br />
names from this. The scons configure will whine if you forget something, but it<br />
does not check if you remembered to install zip, even though you still need it.<br />
<br />
=== Build And Install ===<br />
<br />
The build will spew out warnings like the following, which you can safely ignore:<br />
<br />
<code><pre><br />
warning: division by zero<br />
warning: 'q' may be used uninitialized in this function<br />
</pre></code><br />
<br />
Configure and build:<br />
<br />
<code><pre><br />
scons configure<br />
scons<br />
</pre></code><br />
<br />
Install:<br />
<br />
<code><pre><br />
scons install<br />
mkdir -p /etc/spring<br />
echo '$HOME/.spring' > /etc/spring/datadir<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/local/games/spring</code> and<br />
read-only data in <code>/usr/local/share/games/spring</code>.<br />
<br />
== Network ==<br />
<br />
If you have a public ip and no firewall, then you don't need to do anything.<br />
<br />
If you don't want to host any games, just join them, you shouldn't need to do anything.<br />
<br />
If you have a firewall, to be able to host, you must enable incoming udp to port 8452. If you are behind a NAT, to be able to host you must either use nat traversal / hole punching feature in your lobby client, OR port forward that port from your public ip to your gaming machine.<br />
<br />
= Finalizing installation =<br />
<br />
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.<br />
<br />
I'm assuming bash here, but you can use anything you like to do it of course.<br />
<br />
== Data Directories ==<br />
<br />
Do this to create your per-user data directories. You will be downloading maps and mods etc to these dirs later.<br />
<br />
<code><pre><br />
mkdir -p ~/.spring/{base,maps,mods}<br />
</pre></code><br />
<br />
If the above did not work for you, then you can try:<br />
<br />
<code><pre><br />
mkdir ~/.spring ~/.spring/base ~/.spring/maps ~/.spring/mods<br />
</pre></code><br />
<br />
== Maps ==<br />
<br />
You need at least one map to succesfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
== Mods ==<br />
<br />
You need at least one mod to successfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.<br />
<br />
== OTA Content ==<br />
<br />
If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:<br />
<br />
<code><pre><br />
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip<br />
unzip -d ~/.spring/base base-ota-content.zip<br />
</pre></code><br />
<br />
Note that you need to own a copy of Total Annihilation, to download this file legally.<br />
<br />
Mods that do not require this file are at least NanoBlobs and Kernel Panic, TODO list other mods that don't need it.<br />
<br />
== Settings == <br />
<br />
Defaults should be usable, so you can ignore this until you want to maximize your eye candy or fps :)<br />
<br />
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.<br />
<br />
If you want a tool for editing the file, you can use [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] ([http://springlobby.info SpringLobby] has this integrated).<br />
<br />
=== Dual Head ===<br />
<br />
Automatic: if you are using [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] you can select a dual screen resolution in simple mode and the rest is done automatically. <br />
<br />
Manual: to make Dual Monitors work add/change these settings in your .springrc file. <br />
"DualScreenMiniMapOnLeft=1,<br />
DualScreenMode=1,<br />
XResolution=2560,<br />
YResolution=1024"<br />
<br />
Make sure to use your own resolution for the X,Y resolutions. For example: you have two monitors configured for 1280x1024, the X,Y is 2560x1024.<br />
<br />
Save then restart Spring.<br />
<br />
== LuaUI ==<br />
<br />
Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.<br />
<br />
Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI. <br />
<br />
To install some LuaUI scripts, start by copying LuaUI folder from you read-only data directory to your read-write data directory.<br />
<br />
<code><pre><br />
rm -r ~/.spring/LuaUI<br />
cp -r /usr/share/games/spring/LuaUI ~/.spring/LuaUI<br />
</pre></code><br />
<br />
Then go find the LuaUI scripts you need from [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section]. All LuaUI scripts are released there, so if you make good ones yourself, make sure to upload them.<br />
<br />
The scripts can come in any setup, so prepare to decompress them if they are compressed. They might have a whole directory structure, and they should have their own instructions on how to install them. Check which directory you need to extract them to. Most likely it is ~/.spring/LuaUI but it might be a directory inside this directory too for some script.<br />
<br />
Once you have copied the script into place, when you start spring next time, you can press F11 to enable/disable anything from your list of installed LuaUI scripts. If your new script is not there, you copied it wrong.<br />
<br />
== Lobby Client ==<br />
<br />
To setup online games, you need a lobby client. There are several options to choose from.<br />
<br />
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.<br />
<br />
Recommended lobby client for linux is either SpringLobby or AFLobby. You can use them in windows and mac too.<br />
<br />
=== Omni ===<br />
<br />
This project has been abandoned, and you should not use it.<br />
<br />
=== UnityLobby ===<br />
<br />
UnityLobby has been abandoned since april 2007, and you should not use it.<br />
<br />
=== [http://springlobby.info SpringLobby] ===<br />
<br />
SpringLobby is for (at least) Windows, Linux and Mac. It's now in a usable state and has a feature set close to that of TASClient for windows. Try it out! Bug reports and feature requests are very much welcome.<br />
<br />
Visit http://springlobby.info for all things SpringLobby.<br />
<br />
=== AFLobby ===<br />
<br />
This project is very promising, and is usable for online multi player. Its the oldest lobby still actively maintained.<br />
<br />
Official webpage for the project is http://www.darkstars.co.uk which should always have the latest release for download.<br />
<br />
=== TASClient ===<br />
<br />
= Troubleshooting =<br />
<br />
== Ingame ==<br />
<br />
=== LuaUI Crash Ingame ===<br />
<br />
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:<br />
<br />
<code><pre><br />
/resbar 1<br />
/tooltip 1<br />
</pre></code><br />
<br />
These might not be necessary in 0.75 anymore at all.<br />
<br />
Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.<br />
<br />
LuaUI can also be restarted after it crashed. Often this does the trick and it works fine the rest of the game:<br />
<br />
<code><pre><br />
/luaui reload<br />
</pre></code><br />
<br />
=== Mouse is slow in fullscreen mode ===<br />
<br />
Run:<br />
<code><pre><br />
echo 'export SDL_MOUSE_RELATIVE=0' >> ~/.bash_profile<br />
</pre></code><br />
And log out and log in again.<br />
<br />
The mouse should now be as fast as in windowed mode.<br />
<br />
=== Rotating Buildings Ingame ===<br />
<br />
You can rotate a building before you give the build order, but the keys that do this don't work in linux by default for some users. Issue the following commands in the beginning of the game:<br />
<br />
<code><pre><br />
/bind keycodex buildfacing inc<br />
/bind keycodey buildfacing dec<br />
</pre></code><br />
<br />
Keycodex and keycodey above are just placeholders. What you want to write depends on which key you want to use. To see what keycodes any keys have, do:<br />
<br />
<code><pre><br />
/keydebug yes<br />
</pre></code><br />
<br />
And then hit the keys you want to use, and spring prints the keycodes in the message buffer.<br />
<br />
TODO: add information on how to save the settings so that they work the next time you start spring.<br />
<br />
=== Map is White ===<br />
<br />
If the whole map is only shades of white and grey, there is a problem with your display driver. Maybe your gpu is very old and does not support some needed opengl feature. For example I had this problem with matrox g550 but not with some very old geforce.<br />
<br />
== Startup ==<br />
<br />
=== Missing Default Cursor ===<br />
<br />
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 [[SetupGuide#OTA_Content|earlier in this document]].<br />
<br />
=== could not open file: gamedata/defs.lua ===<br />
<br />
Make sure your ~/.spring does not contain an outdated version of base/springcontent.sdz because a new version of this file is distributed with spring.<br />
If you do, just remove it.<br />
<br />
=== sounds/button9.wav "cant find wav file" ===<br />
<br />
Same problem as above.<br />
<br />
=== Couldnt find matching GLX visual ===<br />
<br />
Reduce anti aliasing.<br />
<br />
=== GL_ARB_texture_compression not found ===<br />
<br />
This can be an issue with your gpu drivers. The drivers you are using do not support a feature that is required to run spring. You might have better luck with the closed source official drivers of nvidia or amd cards. If your gpu itself is really old, this might not help.<br />
<br />
If you use the fglrx ati-graphics driver and you are getting this error there might be a chance that still spring work (I use this with ubuntu gusty).<br />
At first we must check that fglrx is installed correctly:<br />
<br />
<code><pre><br />
~$ fglrxinfo<br />
display: :0.0 screen: 0<br />
OpenGL vendor string: ATI Technologies Inc.<br />
OpenGL renderer string: ATI Mobility Radeon X1400<br />
OpenGL version string: 2.0.6747 (8.40.4)<br />
</pre></code><br />
<br />
Then lets check the glx-extention.<br />
<br />
<code><pre><br />
~$ glxinfo | grep direct<br />
Xlib: extension "XFree86-DRI" missing on display ":1.0".<br />
direct rendering: No<br />
</pre></code><br />
<br />
If you get this message, notice that glxinfo releates to display ':1' and fglrxinfo to display ':0'!! Lets check the glx-extention on display :0 now.<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 glxinfo | grep direct<br />
direct rendering: Yes<br />
</pre></code><br />
<br />
This message mean that you can start spring by typing (in a terminal)<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 spring<br />
</pre></code><br />
<br />
If you use the TASclient with wine and the native linux spring. Start the whole TASclient-start-script by typing. <br />
<br />
<code><pre><br />
DISPLAY=:0 TASCLIENT-start-script<br />
</pre></code><br />
<br />
But Notice under circumstances is no windowmanager running on screen :0! This means there are NO windowframes at the TASClient window! You can't move it or close it by clicking the closebutton (unless you click at the close button on the terminal-window in witch you startet TAS). You can although close TAS with the keys ALT-F4<br />
<br />
=== OpenAL Segfault ===<br />
<br />
If spring crashes with this output:<br />
<br />
<code><pre><br />
OpenAL: ALC_EXT_capture AL_EXT_capture AL_EXT_vorbis AL_EXT_MP3<br />
AL_LOKI_quadriphonic AL_LOKI_play_position AL_LOKI_WAVE_format<br />
AL_LOKI_IMA_ADPCM_format AL_LOKI_buffer_data_callback ALC_LOKI_audio_channel<br />
Segmentation fault (core dumped)<br />
</pre></code><br />
<br />
Look into this thread on the forums for a fix: http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12568<br />
<br />
Then bug nemo in #taspring to finish this troubleshooting entry. He knows how to fix it.<br />
<br />
This is mod-related, ie. it only happens on some mods. Please list here the mod versions that give this error for you.<br />
<br />
- Star Wars mod, unknown version, by user report<br />
<br />
The problematic mod contains a sound file that crashes openal. You can try to unzip the mod file that crashed for you, and play each sound file. Please report any sound files that fail to play right, just list them here.<br />
<br />
- unknown file<br />
<br />
== Compiletime ==<br />
<br />
=== make_gamedata_arch.sh not found ===<br />
<br />
The .zip you downloaded is for windows, you must download a .bz2, instructions [[SetupGuide#Downloading_A_Tarball|earlier in this document]].<br />
<br />
=== invalid use of ILvoid ===<br />
<br />
During compiling, if you get a lot of the following errors:<br />
<br />
<code><pre><br />
/usr/include/IL/il.h:497: error: '<anonymous>' has incomplete type <br />
/usr/include/IL/il.h:497: error: invalid use of 'ILvoid'<br />
</pre></code><br />
<br />
This happens because the version of libdevil-dev you have installed is not compatible with gcc version 4.2 and newer.<br />
<br />
You should upgrade your libdevil-dev to fix this issue. However, in some distributions (at least gentoo), the fixed package has the SAME version number as the older unfixed package, so you might actually need to remove your current libdevil-dev package completely and reinstall it.<br />
<br />
TODO: add critical version numbers of libdevil.<br />
<br />
== Network Setup ==<br />
<br />
Usually you don't need to do any network setup whatsoever, because the lobbies take care of nat traversal with firewall hole punching, but if you need to know the topology, it goes like this:<br />
<br />
Host needs to enable incoming udp to port 8452, and outgoing replies to those.<br />
Non-host players need to enable outgoing udp, and incoming replies to those.<br />
So basically only non-host players initiate "connections", and only the server listens on a well-known port.<br />
<br />
== If You Still Have Problems ==<br />
<br />
Join to #taspring on Freenode or #sy on QuakeNet and try your luck.<br />
<br />
However, generic linux problems not really related to installing this should be asked elsewhere.<br />
<br />
Prepare to list your distribution, which installation method you used, and what exactly is the error. Don't ask if people are around or not, just go straight to business and tell all details, for maximizing your chances of getting help.<br />
<br />
== IRC ==<br />
<br />
# #taspring @ FreeNode<br />
# #sy @ QuakeNet<br />
<br />
== Asking For Help ==<br />
<br />
Ok so you need human help. This is how '''NOT''' to do it:<br />
<br />
<code><pre><br />
15:54 -!- **** [n=****@*] has joined #taspring<br />
15:54 < ****> Hi, i have a problem with compiling spring on debian<br />
15:54 < ****> can anyone help me?<br />
15:57 -!- **** [n=****@*] has quit [Client Quit]<br />
</pre></code><br />
<br />
Don't ask to ask, instead go straight to business by stating the exact problem you have, and giving all necessary information. What you were trying to achieve, how did you try to do it, what happened and what did you expect to happen.<br />
<br />
Then WAIT for someone to notice you.<br />
<br />
== Configure Options ==<br />
<br />
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:<br />
<br />
<code><pre><br />
$ scons --help<br />
scons: Reading SConscript files ...<br />
make: Nothing to be done for `all'.<br />
Succes building streflop!<br />
Updating bitmaps.sdz<br />
Updating springcontent.sdz<br />
scons: done reading SConscript files.<br />
<br />
platform: Set to linux, freebsd or windows<br />
default: None<br />
actual: linux<br />
<br />
debug: Set to yes to produce a binary with debug information<br />
default: 0<br />
actual: 3<br />
<br />
debugdefines: Set to no to suppress DEBUG and _DEBUG preprocessor #defines \<br />
(use to add symbols to release build)<br />
default: True<br />
actual: True<br />
<br />
syncdebug: Set to yes to enable the sync debugger<br />
default: False<br />
actual: False<br />
<br />
synccheck: Set to yes to enable sync checker & resyncer<br />
default: True<br />
actual: True<br />
<br />
optimize: Enable processor optimizations during compilation<br />
default: 1<br />
actual: 2<br />
<br />
profile: Set to yes to produce a binary with profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_generate: Set to yes to compile with -fprofile-generate \<br />
to generate profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_use: Set to yes to compile with -fprofile-use to use \<br />
profiling information<br />
default: False<br />
actual: False<br />
<br />
cpppath: Set path to extra header files<br />
default: []<br />
actual:<br />
<br />
libpath: Set path to extra libraries<br />
default: []<br />
actual:<br />
<br />
fpmath: Set to 387 or SSE on i386 and AMD64 architectures<br />
default: 387<br />
actual: 387<br />
<br />
prefix: Install prefix used at runtime<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
installprefix: Install prefix used for installion<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
datadir: Data directory (relative to prefix)<br />
default: share/games/spring<br />
actual: share/games/spring<br />
<br />
bindir: Directory for executables (rel. to prefix)<br />
default: games<br />
actual: games<br />
<br />
libdir: Directory for AI plugin modules (rel. to prefix)<br />
default: lib/spring<br />
actual: lib/spring<br />
<br />
strip: Discard symbols from the executable (only when neither \<br />
debugging nor profiling)<br />
default: True<br />
actual: False<br />
<br />
disable_avi: Set to no to turn on avi support<br />
default: False on windows, True otherwise<br />
actual: True<br />
<br />
use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation<br />
default: False<br />
actual: False<br />
<br />
use_mmgr: Use memory manager<br />
default: False<br />
actual: False<br />
<br />
dc_allowed: Specifies whether FPS mode (Direct Control) is allowed in game<br />
default: True<br />
actual: True<br />
<br />
cachedir: Cache directory (see scons manual)<br />
default: None<br />
actual:<br />
<br />
Use scons -H for help about command-line options.<br />
</pre></code><br />
<br />
= Tips =<br />
<br />
'''This section contains just some old crap I didn't write, and shouldn't be necessary.'''<br />
<br />
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.<br />
<br />
* 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)<br><br><code>(define devices '(alsa))<br>(define speaker-num 2)<br><br>(define alsa-out-device "hw:0,0")<br>(define alsa-in-device "hw:0,0")</code><br><br>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.<br />
<br />
* 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...<br />
:* Just poke any developer on IRC:<br />
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]<br />
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]<br />
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]<br />
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].<br />
<br />
''' [[Main_Page|<- Back to Main page]]'''<br />
<br />
[[Category:Linux Port]][[Category:Playing]]</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=SetupGuide&diff=16684SetupGuide2008-03-08T22:37:56Z<p>LordMatt: Undo revision 14292 by LordMatt (Talk)</p>
<hr />
<div>'''Fully updated for 0.76b1'''<br />
<br />
= Page Maintenance =<br />
<br />
When I first installed spring on linux, it was damn hard. I almost gave up a couple times, but finally got it to work, after lots of time wasted.<br />
<br />
This setup guide was horribly outdated back then. Since I liked the game, I gave sth back, by updating this page, and some patches for engine. It wasn't very hard to update this page, it just took some time and effort. Now it's basically in a state, where almost every question on the irc channel regarding linux setup is already answered here, if people just bother to check.<br />
<br />
This page doesn't probably require so much modification in the future, assuming no major changes to spring installation procedure. But I am not going to do that, I have no time anymore. This is probably the only up to date page on the whole wiki, and it might be that it again becomes outdated. So I challenge everyone who ever got helped by this page to keep it up to date in the future. <br />
<br />
It's a wiki so everyone can edit it, so when you see something that is wrong or missing, just fix it, and that means you! Making an account is trivial.<br />
<br />
- semi<br />
<br />
= Install =<br />
<br />
== Version ==<br />
<br />
'''The guide is fully up to date with release 0.76b1.'''<br />
<br />
To play online, you must have the same version as everyone else in the game.<br />
<br />
Most people should get the current release, version 0.76b1. There are usually<br />
between 100 and 200 people online in the lobby, and if you want to play with<br />
them, you need this.<br />
<br />
'''Do not use older than current release version''', unless you really know what you are doing.<br />
<br />
If you want to see the bleeding edge, you can checkout svn head of spring, but<br />
it can not be used to play with people who have the release, so you are<br />
practically limited to playing against nemo. This is mainly interesting for<br />
people who want to contribute to the project, for testing, finding bugs and<br />
fixing them, and implementing new features. Head can be seriously broken from<br />
time to time, or not even compile.<br />
<br />
== Packages ==<br />
<br />
If there is a package for your distributions preferred package manager, it is<br />
recommended to use it instead of compiling the program yourself from sources.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Etch ===<br />
<br />
This is not updated for 0.76b1. Somebody check if the install succeeds for the new release this way?<br />
<br />
This is for version 0.75b2.<br />
<br />
We need to use Yokozar's Ubuntu package, so we need some tricks.<br />
<br />
The --build step will take about 15 minutes. Hopefully we have precompiled binaries for etch soon too.<br />
<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
<br />
sudo apt-get update<br />
sudo apt-get build-dep spring -y<br />
sudo apt-get --build source spring -y<br />
sudo dpkg -i spring_0.75~b2-1_i386.deb spring-data_0.75~b2-1_all.deb<br />
</pre></code><br />
<br />
If you want to install SpringLobby also, follow the instructions in http://trac.springlobby.info/wiki/Install#Debian<br />
<br />
Your paths are: Spring executable in <code>/usr/games/spring </code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Unstable ===<br />
<br />
This is for version 0.76b1<br />
<br />
Ubuntu instructions work for debian unstable as is at the moment.<br />
Except two extra steps:<br />
<code><pre><br />
wget -q http://apt.wxwidgets.org/key.asc -O- | sudo apt-key add -<br />
<br />
echo "deb http://apt.wxwidgets.org/ etch-wx main" >> /etc/apt/sources.list<br />
</pre></code><br />
The rest is right below.<br />
<br />
=== http://www.springlobby.info/images/ubuntu-small.png Ubuntu ===<br />
<br />
This is for version 0.76b1.<br />
<br />
We now have a maintained and up to date APT repository for Ubuntu 7.10 (Gutsy)<br />
<br />
If you have some older version of ubuntu, you can easily upgrade to Gutsy with these instructions: http://www.ubuntu.com/getubuntu/upgrading<br />
<br />
Do the following:<br />
<br />
'''These lines are long and they are split to match the formatting of this page, you can copy-paste this to your terminal as is, as long as you copy the entire wrapped command and not just one line.'''<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
'''NOTE:''' If you get a "sudo" error (1st command) or an "unsupported scheme" error (2nd command) with the above code, then try this code instead:<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | sudo apt-key add -<br />
</pre></code><br />
<br />
<code><pre><br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
<code><pre><br />
sudo apt-get update<br />
sudo apt-get install spring spring-lobby-springlobby spring-maps-default -y<br />
</pre></code><br />
<br />
<br />
Also, if you want to download a few large maps you can do following:<br />
<br />
<code>sudo apt-get install spring-maps-hunterw spring-maps-deltasiege spring-maps-smallsupreme spring-maps-teamplay</code><br />
<br />
<br />
If you own the original Total Annihilation and want to use mods that require the original TA content, then do:<br />
<br />
<code>sudo apt-get install spring-data-nonfree</code><br />
<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at <code>/usr/games/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
IF the above do not work, read the following forum post regarding downloading Spring using the Synaptic Package Manager (GUI).<br />
[http://spring.clan-sy.com/phpbb/viewtopic.php?p=262539#p262539 Download using Synaptic Package Manager]<br />
<br />
=== http://www.winehq.org/images/distro/slackware.png Slackware 12 ===<br />
<br />
Working for version 0.76b1.<br />
<br />
There is all dependencies in precompiled tgz's:<br />
<br />
glew (http://www.linuxpackages.net/pkg_details.php?id=12051)<br/><br />
DeviL (http://www.linuxpackages.net/pkg_details.php?id=10571)<br/><br />
boost (http://www.linuxpackages.net/pkg_details.php?id=12046)<br/><br />
icu (http://www.linuxpackages.net/pkg_details.php?id=12034)<br/><br />
openal (http://www.linuxpackages.net/pkg_details.php?id=11993)<br/><br />
wxWidgets (http://www.linuxpackages.net/pkg_details.php?id=12072)<br/><br />
springlobby (http://www.linuxpackages.net/pkg_details.php?id=12177)<br/><br />
spring - thanks to leo moisio - (http://www.springlobby.info/slackware/spring-0.76b1-i486-1leo.tgz)<br/><br />
<br />
assuming that all .tgz are saved in the same direcory, open a console and cd inside that directory; later:<br />
<code><pre><br />
su -c "installpkg *.tgz"<br />
</pre></code><br />
<br />
when asked for the root password, give it.<br />
<br />
a menu entre for spring and another to springlobby will apear in KDE, XFCE and GNOME.<br />
<br />
also, spring and springlobby executables will be accessible via shell; put it on you fluxbox menu, ;D<br />
<br />
=== http://www.springlobby.info/images/gentoo-small.png Gentoo ===<br />
<br />
This is for version 0.76b1.<br />
<br />
'''OVERLAY CHANGED 2008-01-21. SpringLobby and Spring overlays are merged, so you need to add this overlay, if you haven't already, so you can upgrade again. If you are new user, you can ignore this.'''<br />
<br />
An overlay to use with layman is provided. If gentoo overlays and/or layman are new to you, [http://overlays.gentoo.org/ read about them], as they are an essential part of gentoo.<br />
<br />
This example assumes you never used layman before. If it's not your first time, you hopefully know what to do.<br />
<br />
<code><pre><br />
emerge layman<br />
layman -f -a springlobby \<br />
-o http://svn.springlobby.info/trunk/gentoo/overlays.xml<br />
echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf<br />
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords<br />
echo "games-util/springlobby ~x86" >> /etc/portage/package.keywords<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Layman makes upgrading really easy too:<br />
<br />
<code><pre><br />
layman --sync ALL<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
<br />
=== http://upload.wikimedia.org/wikipedia/en/thumb/9/95/Mandriva_logo.png/96px-Mandriva_logo.png Mandriva ===<br />
<br />
This is for version 0.76b1.<br />
<br />
Mandriva has Spring in the official Contrib repositories, follow the instructions at [http://easyurpmi.zarb.org Easy Urpmi] to add contrib mirrors<br />
<br />
after being done, to install enter the following command in a console:<br />
<br />
<code>su root -C "urpmi spring"</code><br />
<br />
and select yes to the confirmation question<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at /usr/games/spring and read-only data in /usr/share/games/spring.<br />
<br />
=== Binary for Other Linux Systems ===<br />
<br />
This is for version 0.76b1.<br />
<br />
There is an unofficial installer if none of the above work for you:<br />
http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12802<br />
<br />
== Build From Source ==<br />
<br />
'''You might encounter sync errors in online play if you are not using the exact same version of the compiler and same compiler settings as used for prebuilt packages!'''<br />
<br />
For 0.76b1 these are: TODO add them here.<br />
<br />
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.<br />
<br />
=== Get Source ===<br />
<br />
You can either download the source as a 3.9MB tarball (recommended; v. 0.76b1) or get it from the subversion repository. Either way, the result is the same.<br />
<br />
==== Tarball ====<br />
<br />
<code><pre><br />
cd /usr/local/src # or /var/tmp, or whatever<br />
wget http://spring.clan-sy.com/dl/spring_0.76b1_src.tar.bz2<br />
tar xjf spring_0.76b1_src.tar.bz2<br />
cd spring_0.76b1<br />
</pre></code><br />
<br />
'''NOTE: The .zip release is for windows only. Linux users have to get .bz2 like shown above.'''<br />
<br />
==== Subversion ====<br />
<br />
<code><pre><br />
aptitude install subversion # if you are not on debian, figure it out<br />
svn co https://spring.clan-sy.com/svn/spring/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
cd /usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
If the above subversion host happens to be down (which is unlikely since you're reading this wiki page now), you can try the following hourly updated mirror (replace the svn co line above with the following line):<br />
<code><pre><br />
svn co svn://caspring.org:3691/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
=== Dependencies ===<br />
<br />
For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the<br />
following to be the minimal set that is necessary to get. I have not tested<br />
with any version of Ubuntu, but the line is probably almost identical if not<br />
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007 WORKS. Note<br />
that Spring 0.75b2 depends on the boost libraries version 1.34.* and won't<br />
work on lower versions. (updated libboost-serialization-dev, and libvorbis-dev dependencies for 0.76b1)<br />
<br />
Also, on 64-bit be sure to build against devIl 1.6.8-rc2 or higher, 1.6.7 has a bug in the PNG loading code that causes issues.<br />
<br />
<code><pre><br />
aptitude install scons build-essential zlib1g-dev libfreetype6-dev<br />
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev<br />
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev<br />
aptitude install libboost-serialization-dev python2.5-dev zip<br />
aptitude install sun-java6-jdk libvorbis-dev<br />
</pre></code><br />
<br />
This has been tested to work with a clean install of gentoo 2007.0:<br />
<br />
<code><pre><br />
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0<br />
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost<br />
emerge media-libs/devil app-arch/zip media-libs/libogg<br />
</pre></code><br />
<br />
On Fedora 8, these dependencies should be sufficient:<br />
<br />
<code><pre><br />
yum install scons boost-devel openal-devel SDL-devel libvorbis-devel <br />
yum install devIl-devel glew-devel java-1.7.0-icedtea-devel<br />
</pre></code><br />
Users of other distributions should be able to figure out the correct package<br />
names from this. The scons configure will whine if you forget something, but it<br />
does not check if you remembered to install zip, even though you still need it.<br />
<br />
=== Build And Install ===<br />
<br />
The build will spew out warnings like the following, which you can safely ignore:<br />
<br />
<code><pre><br />
warning: division by zero<br />
warning: 'q' may be used uninitialized in this function<br />
</pre></code><br />
<br />
Configure and build:<br />
<br />
<code><pre><br />
scons configure<br />
scons<br />
</pre></code><br />
<br />
Install:<br />
<br />
<code><pre><br />
scons install<br />
mkdir -p /etc/spring<br />
echo '$HOME/.spring' > /etc/spring/datadir<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/local/games/spring</code> and<br />
read-only data in <code>/usr/local/share/games/spring</code>.<br />
<br />
== Network ==<br />
<br />
If you have a public ip and no firewall, then you don't need to do anything.<br />
<br />
If you don't want to host any games, just join them, you shouldn't need to do anything.<br />
<br />
If you have a firewall, to be able to host, you must enable incoming udp to port 8452. If you are behind a NAT, to be able to host you must either use nat traversal / hole punching feature in your lobby client, OR port forward that port from your public ip to your gaming machine.<br />
<br />
= Finalizing installation =<br />
<br />
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.<br />
<br />
I'm assuming bash here, but you can use anything you like to do it of course.<br />
<br />
== Data Directories ==<br />
<br />
Do this to create your per-user data directories. You will be downloading maps and mods etc to these dirs later.<br />
<br />
<code><pre><br />
mkdir -p ~/.spring/{base,maps,mods}<br />
</pre></code><br />
<br />
If the above did not work for you, then you can try:<br />
<br />
<code><pre><br />
mkdir ~/.spring ~/.spring/base ~/.spring/maps ~/.spring/mods<br />
</pre></code><br />
<br />
== Maps ==<br />
<br />
You need at least one map to succesfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
== Mods ==<br />
<br />
You need at least one mod to successfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.<br />
<br />
== OTA Content ==<br />
<br />
If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:<br />
<br />
<code><pre><br />
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip<br />
unzip -d ~/.spring/base base-ota-content.zip<br />
</pre></code><br />
<br />
Note that you need to own a copy of Total Annihilation, to download this file legally.<br />
<br />
Mods that do not require this file are at least NanoBlobs and Kernel Panic, TODO list other mods that don't need it.<br />
<br />
== Settings == <br />
<br />
Defaults should be usable, so you can ignore this until you want to maximize your eye candy or fps :)<br />
<br />
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.<br />
<br />
If you want a tool for editing the file, you can use [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] ([http://springlobby.info SpringLobby] has this integrated).<br />
<br />
=== Dual Head ===<br />
<br />
Automatic: if you are using [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] you can select a dual screen resolution in simple mode and the rest is done automatically. <br />
<br />
Manual: to make Dual Monitors work add/change these settings in your .springrc file. <br />
"DualScreenMiniMapOnLeft=1,<br />
DualScreenMode=1,<br />
XResolution=2560,<br />
YResolution=1024"<br />
<br />
Make sure to use your own resolution for the X,Y resolutions. For example: you have two monitors configured for 1280x1024, the X,Y is 2560x1024.<br />
<br />
Save then restart Spring.<br />
<br />
== LuaUI ==<br />
<br />
Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.<br />
<br />
Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI. <br />
<br />
To install some LuaUI scripts, start by copying LuaUI folder from you read-only data directory to your read-write data directory.<br />
<br />
<code><pre><br />
rm -r ~/.spring/LuaUI<br />
cp -r /usr/share/games/spring/LuaUI ~/.spring/LuaUI<br />
</pre></code><br />
<br />
Then go find the LuaUI scripts you need from [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section]. All LuaUI scripts are released there, so if you make good ones yourself, make sure to upload them.<br />
<br />
The scripts can come in any setup, so prepare to decompress them if they are compressed. They might have a whole directory structure, and they should have their own instructions on how to install them. Check which directory you need to extract them to. Most likely it is ~/.spring/LuaUI but it might be a directory inside this directory too for some script.<br />
<br />
Once you have copied the script into place, when you start spring next time, you can press F11 to enable/disable anything from your list of installed LuaUI scripts. If your new script is not there, you copied it wrong.<br />
<br />
== Lobby Client ==<br />
<br />
To setup online games, you need a lobby client. There are several options to choose from.<br />
<br />
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.<br />
<br />
Recommended lobby client for linux is either SpringLobby or AFLobby. You can use them in windows and mac too.<br />
<br />
=== Omni ===<br />
<br />
This project has been abandoned, and you should not use it.<br />
<br />
=== UnityLobby ===<br />
<br />
UnityLobby has been abandoned since april 2007, and you should not use it.<br />
<br />
=== [http://springlobby.info SpringLobby] ===<br />
<br />
SpringLobby is for (at least) Windows, Linux and Mac. It's now in a usable state and has a feature set close to that of TASClient for windows. Try it out! Bug reports and feature requests are very much welcome.<br />
<br />
Visit http://springlobby.info for all things SpringLobby.<br />
<br />
=== AFLobby ===<br />
<br />
This project is very promising, and is usable for online multi player. Its the oldest lobby still actively maintained.<br />
<br />
Official webpage for the project is http://www.darkstars.co.uk which should always have the latest release for download.<br />
<br />
=== TASClient ===<br />
<br />
I used to recommend wine+TASClient solution before, but now you should try SpringLobby or AFLobby first, before you go this route.<br />
<br />
Certain newish version of wine fails with tasclient, TODO can't remember which one. It should be fixed in the very latest version of wine.<br />
<br />
This is a windows program, but it works just fine under wine in linux, and can be used together with native linux spring. I used it myself before moving to SpringLobby.<br />
<br />
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).<br />
<br />
TODO there is a way to make it support rank increases too, using trepans cool proxy, add info.<br />
<br />
Download the installer of Spring for Windows, and run it in wine:<br />
<br />
<code><pre><br />
wget http://spring.clan-sy.com/dl/spring_0.76b1.exe<br />
wine spring_0.76b1.exe<br />
</pre></code><br />
<br />
No configuration of wine should be needed, if your distribution is sane.<br />
<br />
Complete the install, and let it install to the default location, which is Program Files\Spring.<br />
<br />
Assuming you completed the earlier step of creating the data directories, now we need to link the windows and linux data together:<br />
<br />
<code><pre><br />
WINESPRING=~/.wine/drive_c/Program\ Files/Spring<br />
NATIVE=~/.spring<br />
<br />
touch "${WINESPRING}/script.txt"<br />
ln -s "${WINESPRING}/script.txt" "${NATIVE}/script.txt"<br />
<br />
rm -r "${WINESPRING}/maps"<br />
ln -s "${NATIVE}/maps" "${WINESPRING}/maps"<br />
<br />
rm -r "${WINESPRING}/mods"<br />
ln -s "${NATIVE}/mods" "${WINESPRING}/mods"<br />
<br />
rm -r "${WINESPRING}/base"<br />
ln -s "${NATIVE}/base" "${WINESPRING}/base"<br />
<br />
rm -r "${WINESPRING}/demos"<br />
ln -s "${NATIVE}/demos" "${WINESPRING}/demos"<br />
</pre></code><br />
<br />
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:<br />
<br />
<code><pre><br />
#include <windows.h><br />
#include <stdio.h><br />
#include <tchar.h><br />
<br />
#define NATIVE_SPRING_LOCATION TEXT("/usr/games/spring")<br />
#define SPRING_VERSION_REPLY "Spring 0.76b1"<br />
<br />
int main (int argc, char **argv)<br />
{<br />
if (argc > 1 && !strcmp(argv[1], "/V"))<br />
{<br />
puts(SPRING_VERSION_REPLY);<br />
return 0;<br />
}<br />
<br />
STARTUPINFO si;<br />
ZeroMemory( &si, sizeof(si) );<br />
si.cb = sizeof(si);<br />
<br />
PROCESS_INFORMATION pi;<br />
ZeroMemory( &pi, sizeof(pi) );<br />
<br />
// Start the child process.<br />
if (!CreateProcess(<br />
_tcsdup(NATIVE_SPRING_LOCATION), // No module name (use command line)<br />
GetCommandLine(), // Command line<br />
NULL, // Process handle not inheritable<br />
NULL, // Thread handle not inheritable<br />
FALSE, // Set handle inheritance to FALSE<br />
0, // No creation flags<br />
NULL, // Use parent's environment block<br />
NULL, // Use parent's starting directory<br />
&si, // Pointer to STARTUPINFO structure<br />
&pi)) // Pointer to PROCESS_INFORMATION structure<br />
{<br />
printf( "CreateProcess failed (%d).\n", GetLastError() );<br />
return 1;<br />
}<br />
<br />
// Wait until child process exits. Wine actually does not know how to wait<br />
// for native linux process, so this will return instantly and your gametime<br />
// counter does not increase so you don't get any rank.<br />
WaitForSingleObject( pi.hProcess, INFINITE );<br />
<br />
// Close process and thread handles.<br />
CloseHandle( pi.hProcess );<br />
CloseHandle( pi.hThread );<br />
<br />
return 0;<br />
}<br />
</pre></code><br />
<br />
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.<br />
<br />
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:<br />
<br />
<code><pre><br />
aptitude install mingw32<br />
i586-mingw32msvc-g++ spring.cc -o ~/.wine/drive_c/Program\ Files/Spring/spring.exe<br />
</pre></code><br />
<br />
This assumed debian for installing the crosscompiler, but mingw32 is probably simple to install on other distributions as well.<br />
<br />
TODO should provide binary packages for this launcher, as all people don't have the possibility to set up cross compiler. I compiled it but I can't test it due to lack of Wine+TASClient setup. Here is the binary anyway: http://buildbot.no-ip.org/~tvo/spring/spring.exe<br />
<br />
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:<br />
<br />
<code><pre><br />
#!/usr/bin/env sh<br />
cd ~/.wine/drive_c/Program\ Files/Spring<br />
wine TASClient.exe<br />
</pre></code><br />
<br />
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.'''<br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
= Troubleshooting =<br />
<br />
== Ingame ==<br />
<br />
=== LuaUI Crash Ingame ===<br />
<br />
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:<br />
<br />
<code><pre><br />
/resbar 1<br />
/tooltip 1<br />
</pre></code><br />
<br />
These might not be necessary in 0.75 anymore at all.<br />
<br />
Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.<br />
<br />
LuaUI can also be restarted after it crashed. Often this does the trick and it works fine the rest of the game:<br />
<br />
<code><pre><br />
/luaui reload<br />
</pre></code><br />
<br />
=== Mouse is slow in fullscreen mode ===<br />
<br />
Run:<br />
<code><pre><br />
echo 'export SDL_MOUSE_RELATIVE=0' >> ~/.bash_profile<br />
</pre></code><br />
And log out and log in again.<br />
<br />
The mouse should now be as fast as in windowed mode.<br />
<br />
=== Rotating Buildings Ingame ===<br />
<br />
You can rotate a building before you give the build order, but the keys that do this don't work in linux by default for some users. Issue the following commands in the beginning of the game:<br />
<br />
<code><pre><br />
/bind keycodex buildfacing inc<br />
/bind keycodey buildfacing dec<br />
</pre></code><br />
<br />
Keycodex and keycodey above are just placeholders. What you want to write depends on which key you want to use. To see what keycodes any keys have, do:<br />
<br />
<code><pre><br />
/keydebug yes<br />
</pre></code><br />
<br />
And then hit the keys you want to use, and spring prints the keycodes in the message buffer.<br />
<br />
TODO: add information on how to save the settings so that they work the next time you start spring.<br />
<br />
=== Map is White ===<br />
<br />
If the whole map is only shades of white and grey, there is a problem with your display driver. Maybe your gpu is very old and does not support some needed opengl feature. For example I had this problem with matrox g550 but not with some very old geforce.<br />
<br />
== Startup ==<br />
<br />
=== Missing Default Cursor ===<br />
<br />
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 [[SetupGuide#OTA_Content|earlier in this document]].<br />
<br />
=== could not open file: gamedata/defs.lua ===<br />
<br />
Make sure your ~/.spring does not contain an outdated version of base/springcontent.sdz because a new version of this file is distributed with spring.<br />
If you do, just remove it.<br />
<br />
=== sounds/button9.wav "cant find wav file" ===<br />
<br />
Same problem as above.<br />
<br />
=== Couldnt find matching GLX visual ===<br />
<br />
Reduce anti aliasing.<br />
<br />
=== GL_ARB_texture_compression not found ===<br />
<br />
This can be an issue with your gpu drivers. The drivers you are using do not support a feature that is required to run spring. You might have better luck with the closed source official drivers of nvidia or amd cards. If your gpu itself is really old, this might not help.<br />
<br />
If you use the fglrx ati-graphics driver and you are getting this error there might be a chance that still spring work (I use this with ubuntu gusty).<br />
At first we must check that fglrx is installed correctly:<br />
<br />
<code><pre><br />
~$ fglrxinfo<br />
display: :0.0 screen: 0<br />
OpenGL vendor string: ATI Technologies Inc.<br />
OpenGL renderer string: ATI Mobility Radeon X1400<br />
OpenGL version string: 2.0.6747 (8.40.4)<br />
</pre></code><br />
<br />
Then lets check the glx-extention.<br />
<br />
<code><pre><br />
~$ glxinfo | grep direct<br />
Xlib: extension "XFree86-DRI" missing on display ":1.0".<br />
direct rendering: No<br />
</pre></code><br />
<br />
If you get this message, notice that glxinfo releates to display ':1' and fglrxinfo to display ':0'!! Lets check the glx-extention on display :0 now.<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 glxinfo | grep direct<br />
direct rendering: Yes<br />
</pre></code><br />
<br />
This message mean that you can start spring by typing (in a terminal)<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 spring<br />
</pre></code><br />
<br />
If you use the TASclient with wine and the native linux spring. Start the whole TASclient-start-script by typing. <br />
<br />
<code><pre><br />
DISPLAY=:0 TASCLIENT-start-script<br />
</pre></code><br />
<br />
But Notice under circumstances is no windowmanager running on screen :0! This means there are NO windowframes at the TASClient window! You can't move it or close it by clicking the closebutton (unless you click at the close button on the terminal-window in witch you startet TAS). You can although close TAS with the keys ALT-F4<br />
<br />
=== OpenAL Segfault ===<br />
<br />
If spring crashes with this output:<br />
<br />
<code><pre><br />
OpenAL: ALC_EXT_capture AL_EXT_capture AL_EXT_vorbis AL_EXT_MP3<br />
AL_LOKI_quadriphonic AL_LOKI_play_position AL_LOKI_WAVE_format<br />
AL_LOKI_IMA_ADPCM_format AL_LOKI_buffer_data_callback ALC_LOKI_audio_channel<br />
Segmentation fault (core dumped)<br />
</pre></code><br />
<br />
Look into this thread on the forums for a fix: http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12568<br />
<br />
Then bug nemo in #taspring to finish this troubleshooting entry. He knows how to fix it.<br />
<br />
This is mod-related, ie. it only happens on some mods. Please list here the mod versions that give this error for you.<br />
<br />
- Star Wars mod, unknown version, by user report<br />
<br />
The problematic mod contains a sound file that crashes openal. You can try to unzip the mod file that crashed for you, and play each sound file. Please report any sound files that fail to play right, just list them here.<br />
<br />
- unknown file<br />
<br />
== Compiletime ==<br />
<br />
=== make_gamedata_arch.sh not found ===<br />
<br />
The .zip you downloaded is for windows, you must download a .bz2, instructions [[SetupGuide#Downloading_A_Tarball|earlier in this document]].<br />
<br />
=== invalid use of ILvoid ===<br />
<br />
During compiling, if you get a lot of the following errors:<br />
<br />
<code><pre><br />
/usr/include/IL/il.h:497: error: '<anonymous>' has incomplete type <br />
/usr/include/IL/il.h:497: error: invalid use of 'ILvoid'<br />
</pre></code><br />
<br />
This happens because the version of libdevil-dev you have installed is not compatible with gcc version 4.2 and newer.<br />
<br />
You should upgrade your libdevil-dev to fix this issue. However, in some distributions (at least gentoo), the fixed package has the SAME version number as the older unfixed package, so you might actually need to remove your current libdevil-dev package completely and reinstall it.<br />
<br />
TODO: add critical version numbers of libdevil.<br />
<br />
== Network Setup ==<br />
<br />
Usually you don't need to do any network setup whatsoever, because the lobbies take care of nat traversal with firewall hole punching, but if you need to know the topology, it goes like this:<br />
<br />
Host needs to enable incoming udp to port 8452, and outgoing replies to those.<br />
Non-host players need to enable outgoing udp, and incoming replies to those.<br />
So basically only non-host players initiate "connections", and only the server listens on a well-known port.<br />
<br />
== If You Still Have Problems ==<br />
<br />
Join to #taspring on Freenode or #sy on QuakeNet and try your luck.<br />
<br />
However, generic linux problems not really related to installing this should be asked elsewhere.<br />
<br />
Prepare to list your distribution, which installation method you used, and what exactly is the error. Don't ask if people are around or not, just go straight to business and tell all details, for maximizing your chances of getting help.<br />
<br />
== IRC ==<br />
<br />
# #taspring @ FreeNode<br />
# #sy @ QuakeNet<br />
<br />
== Asking For Help ==<br />
<br />
Ok so you need human help. This is how '''NOT''' to do it:<br />
<br />
<code><pre><br />
15:54 -!- **** [n=****@*] has joined #taspring<br />
15:54 < ****> Hi, i have a problem with compiling spring on debian<br />
15:54 < ****> can anyone help me?<br />
15:57 -!- **** [n=****@*] has quit [Client Quit]<br />
</pre></code><br />
<br />
Don't ask to ask, instead go straight to business by stating the exact problem you have, and giving all necessary information. What you were trying to achieve, how did you try to do it, what happened and what did you expect to happen.<br />
<br />
Then WAIT for someone to notice you.<br />
<br />
== Configure Options ==<br />
<br />
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:<br />
<br />
<code><pre><br />
$ scons --help<br />
scons: Reading SConscript files ...<br />
make: Nothing to be done for `all'.<br />
Succes building streflop!<br />
Updating bitmaps.sdz<br />
Updating springcontent.sdz<br />
scons: done reading SConscript files.<br />
<br />
platform: Set to linux, freebsd or windows<br />
default: None<br />
actual: linux<br />
<br />
debug: Set to yes to produce a binary with debug information<br />
default: 0<br />
actual: 3<br />
<br />
debugdefines: Set to no to suppress DEBUG and _DEBUG preprocessor #defines \<br />
(use to add symbols to release build)<br />
default: True<br />
actual: True<br />
<br />
syncdebug: Set to yes to enable the sync debugger<br />
default: False<br />
actual: False<br />
<br />
synccheck: Set to yes to enable sync checker & resyncer<br />
default: True<br />
actual: True<br />
<br />
optimize: Enable processor optimizations during compilation<br />
default: 1<br />
actual: 2<br />
<br />
profile: Set to yes to produce a binary with profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_generate: Set to yes to compile with -fprofile-generate \<br />
to generate profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_use: Set to yes to compile with -fprofile-use to use \<br />
profiling information<br />
default: False<br />
actual: False<br />
<br />
cpppath: Set path to extra header files<br />
default: []<br />
actual:<br />
<br />
libpath: Set path to extra libraries<br />
default: []<br />
actual:<br />
<br />
fpmath: Set to 387 or SSE on i386 and AMD64 architectures<br />
default: 387<br />
actual: 387<br />
<br />
prefix: Install prefix used at runtime<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
installprefix: Install prefix used for installion<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
datadir: Data directory (relative to prefix)<br />
default: share/games/spring<br />
actual: share/games/spring<br />
<br />
bindir: Directory for executables (rel. to prefix)<br />
default: games<br />
actual: games<br />
<br />
libdir: Directory for AI plugin modules (rel. to prefix)<br />
default: lib/spring<br />
actual: lib/spring<br />
<br />
strip: Discard symbols from the executable (only when neither \<br />
debugging nor profiling)<br />
default: True<br />
actual: False<br />
<br />
disable_avi: Set to no to turn on avi support<br />
default: False on windows, True otherwise<br />
actual: True<br />
<br />
use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation<br />
default: False<br />
actual: False<br />
<br />
use_mmgr: Use memory manager<br />
default: False<br />
actual: False<br />
<br />
dc_allowed: Specifies whether FPS mode (Direct Control) is allowed in game<br />
default: True<br />
actual: True<br />
<br />
cachedir: Cache directory (see scons manual)<br />
default: None<br />
actual:<br />
<br />
Use scons -H for help about command-line options.<br />
</pre></code><br />
<br />
= Tips =<br />
<br />
'''This section contains just some old crap I didn't write, and shouldn't be necessary.'''<br />
<br />
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.<br />
<br />
* 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)<br><br><code>(define devices '(alsa))<br>(define speaker-num 2)<br><br>(define alsa-out-device "hw:0,0")<br>(define alsa-in-device "hw:0,0")</code><br><br>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.<br />
<br />
* 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...<br />
:* Just poke any developer on IRC:<br />
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]<br />
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]<br />
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]<br />
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].<br />
<br />
''' [[Main_Page|<- Back to Main page]]'''<br />
<br />
[[Category:Linux Port]][[Category:Playing]]</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=SetupGuide&diff=16683SetupGuide2008-03-08T22:32:50Z<p>LordMatt: /* TASClient */</p>
<hr />
<div>'''Fully updated for 0.76b1'''<br />
<br />
= Page Maintenance =<br />
<br />
When I first installed spring on linux, it was damn hard. I almost gave up a couple times, but finally got it to work, after lots of time wasted.<br />
<br />
This setup guide was horribly outdated back then. Since I liked the game, I gave sth back, by updating this page, and some patches for engine. It wasn't very hard to update this page, it just took some time and effort. Now it's basically in a state, where almost every question on the irc channel regarding linux setup is already answered here, if people just bother to check.<br />
<br />
This page doesn't probably require so much modification in the future, assuming no major changes to spring installation procedure. But I am not going to do that, I have no time anymore. This is probably the only up to date page on the whole wiki, and it might be that it again becomes outdated. So I challenge everyone who ever got helped by this page to keep it up to date in the future. <br />
<br />
It's a wiki so everyone can edit it, so when you see something that is wrong or missing, just fix it, and that means you! Making an account is trivial.<br />
<br />
- semi<br />
<br />
= Install =<br />
<br />
== Version ==<br />
<br />
'''The guide is fully up to date with release 0.76b1.'''<br />
<br />
To play online, you must have the same version as everyone else in the game.<br />
<br />
Most people should get the current release, version 0.76b1. There are usually<br />
between 100 and 200 people online in the lobby, and if you want to play with<br />
them, you need this.<br />
<br />
'''Do not use older than current release version''', unless you really know what you are doing.<br />
<br />
If you want to see the bleeding edge, you can checkout svn head of spring, but<br />
it can not be used to play with people who have the release, so you are<br />
practically limited to playing against nemo. This is mainly interesting for<br />
people who want to contribute to the project, for testing, finding bugs and<br />
fixing them, and implementing new features. Head can be seriously broken from<br />
time to time, or not even compile.<br />
<br />
== Packages ==<br />
<br />
If there is a package for your distributions preferred package manager, it is<br />
recommended to use it instead of compiling the program yourself from sources.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Etch ===<br />
<br />
This is not updated for 0.76b1. Somebody check if the install succeeds for the new release this way?<br />
<br />
This is for version 0.75b2.<br />
<br />
We need to use Yokozar's Ubuntu package, so we need some tricks.<br />
<br />
The --build step will take about 15 minutes. Hopefully we have precompiled binaries for etch soon too.<br />
<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
<br />
sudo apt-get update<br />
sudo apt-get build-dep spring -y<br />
sudo apt-get --build source spring -y<br />
sudo dpkg -i spring_0.75~b2-1_i386.deb spring-data_0.75~b2-1_all.deb<br />
</pre></code><br />
<br />
If you want to install SpringLobby also, follow the instructions in http://trac.springlobby.info/wiki/Install#Debian<br />
<br />
Your paths are: Spring executable in <code>/usr/games/spring </code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
=== http://www.springlobby.info/images/debian-small.png Debian Unstable ===<br />
<br />
This is for version 0.76b1<br />
<br />
Ubuntu instructions work for debian unstable as is at the moment.<br />
Except two extra steps:<br />
<code><pre><br />
wget -q http://apt.wxwidgets.org/key.asc -O- | sudo apt-key add -<br />
<br />
echo "deb http://apt.wxwidgets.org/ etch-wx main" >> /etc/apt/sources.list<br />
</pre></code><br />
The rest is right below.<br />
<br />
=== http://www.springlobby.info/images/ubuntu-small.png Ubuntu ===<br />
<br />
This is for version 0.76b1.<br />
<br />
We now have a maintained and up to date APT repository for Ubuntu 7.10 (Gutsy)<br />
<br />
If you have some older version of ubuntu, you can easily upgrade to Gutsy with these instructions: http://www.ubuntu.com/getubuntu/upgrading<br />
<br />
Do the following:<br />
<br />
'''These lines are long and they are split to match the formatting of this page, you can copy-paste this to your terminal as is, as long as you copy the entire wrapped command and not just one line.'''<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | \<br />
sudo apt-key add -<br />
<br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
'''NOTE:''' If you get a "sudo" error (1st command) or an "unsupported scheme" error (2nd command) with the above code, then try this code instead:<br />
<code><pre><br />
wget -q http://ppa.launchpad.net/spring/ubuntu/387EE263.gpg -O- | sudo apt-key add -<br />
</pre></code><br />
<br />
<code><pre><br />
sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list<br />
-O /etc/apt/sources.list.d/springproject.list<br />
</pre></code><br />
<br />
<br />
<code><pre><br />
sudo apt-get update<br />
sudo apt-get install spring spring-lobby-springlobby spring-maps-default -y<br />
</pre></code><br />
<br />
<br />
Also, if you want to download a few large maps you can do following:<br />
<br />
<code>sudo apt-get install spring-maps-hunterw spring-maps-deltasiege spring-maps-smallsupreme spring-maps-teamplay</code><br />
<br />
<br />
If you own the original Total Annihilation and want to use mods that require the original TA content, then do:<br />
<br />
<code>sudo apt-get install spring-data-nonfree</code><br />
<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at <code>/usr/games/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
IF the above do not work, read the following forum post regarding downloading Spring using the Synaptic Package Manager (GUI).<br />
[http://spring.clan-sy.com/phpbb/viewtopic.php?p=262539#p262539 Download using Synaptic Package Manager]<br />
<br />
=== http://www.winehq.org/images/distro/slackware.png Slackware 12 ===<br />
<br />
Working for version 0.76b1.<br />
<br />
There is all dependencies in precompiled tgz's:<br />
<br />
glew (http://www.linuxpackages.net/pkg_details.php?id=12051)<br/><br />
DeviL (http://www.linuxpackages.net/pkg_details.php?id=10571)<br/><br />
boost (http://www.linuxpackages.net/pkg_details.php?id=12046)<br/><br />
icu (http://www.linuxpackages.net/pkg_details.php?id=12034)<br/><br />
openal (http://www.linuxpackages.net/pkg_details.php?id=11993)<br/><br />
wxWidgets (http://www.linuxpackages.net/pkg_details.php?id=12072)<br/><br />
springlobby (http://www.linuxpackages.net/pkg_details.php?id=12177)<br/><br />
spring - thanks to leo moisio - (http://www.springlobby.info/slackware/spring-0.76b1-i486-1leo.tgz)<br/><br />
<br />
assuming that all .tgz are saved in the same direcory, open a console and cd inside that directory; later:<br />
<code><pre><br />
su -c "installpkg *.tgz"<br />
</pre></code><br />
<br />
when asked for the root password, give it.<br />
<br />
a menu entre for spring and another to springlobby will apear in KDE, XFCE and GNOME.<br />
<br />
also, spring and springlobby executables will be accessible via shell; put it on you fluxbox menu, ;D<br />
<br />
=== http://www.springlobby.info/images/gentoo-small.png Gentoo ===<br />
<br />
This is for version 0.76b1.<br />
<br />
'''OVERLAY CHANGED 2008-01-21. SpringLobby and Spring overlays are merged, so you need to add this overlay, if you haven't already, so you can upgrade again. If you are new user, you can ignore this.'''<br />
<br />
An overlay to use with layman is provided. If gentoo overlays and/or layman are new to you, [http://overlays.gentoo.org/ read about them], as they are an essential part of gentoo.<br />
<br />
This example assumes you never used layman before. If it's not your first time, you hopefully know what to do.<br />
<br />
<code><pre><br />
emerge layman<br />
layman -f -a springlobby \<br />
-o http://svn.springlobby.info/trunk/gentoo/overlays.xml<br />
echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf<br />
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords<br />
echo "games-util/springlobby ~x86" >> /etc/portage/package.keywords<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Layman makes upgrading really easy too:<br />
<br />
<code><pre><br />
layman --sync ALL<br />
emerge spring<br />
emerge springlobby<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
<br />
=== http://upload.wikimedia.org/wikipedia/en/thumb/9/95/Mandriva_logo.png/96px-Mandriva_logo.png Mandriva ===<br />
<br />
This is for version 0.76b1.<br />
<br />
Mandriva has Spring in the official Contrib repositories, follow the instructions at [http://easyurpmi.zarb.org Easy Urpmi] to add contrib mirrors<br />
<br />
after being done, to install enter the following command in a console:<br />
<br />
<code>su root -C "urpmi spring"</code><br />
<br />
and select yes to the confirmation question<br />
<br />
For configuring the lobbies, you can note that the package installs the Spring executable at /usr/games/spring and read-only data in /usr/share/games/spring.<br />
<br />
=== Binary for Other Linux Systems ===<br />
<br />
This is for version 0.76b1.<br />
<br />
There is an unofficial installer if none of the above work for you:<br />
http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12802<br />
<br />
== Build From Source ==<br />
<br />
'''You might encounter sync errors in online play if you are not using the exact same version of the compiler and same compiler settings as used for prebuilt packages!'''<br />
<br />
For 0.76b1 these are: TODO add them here.<br />
<br />
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.<br />
<br />
=== Get Source ===<br />
<br />
You can either download the source as a 3.9MB tarball (recommended; v. 0.76b1) or get it from the subversion repository. Either way, the result is the same.<br />
<br />
==== Tarball ====<br />
<br />
<code><pre><br />
cd /usr/local/src # or /var/tmp, or whatever<br />
wget http://spring.clan-sy.com/dl/spring_0.76b1_src.tar.bz2<br />
tar xjf spring_0.76b1_src.tar.bz2<br />
cd spring_0.76b1<br />
</pre></code><br />
<br />
'''NOTE: The .zip release is for windows only. Linux users have to get .bz2 like shown above.'''<br />
<br />
==== Subversion ====<br />
<br />
<code><pre><br />
aptitude install subversion # if you are not on debian, figure it out<br />
svn co https://spring.clan-sy.com/svn/spring/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
cd /usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
If the above subversion host happens to be down (which is unlikely since you're reading this wiki page now), you can try the following hourly updated mirror (replace the svn co line above with the following line):<br />
<code><pre><br />
svn co svn://caspring.org:3691/tags/spring_0.76b1 \<br />
/usr/local/src/spring_0.76b1<br />
</pre></code><br />
<br />
=== Dependencies ===<br />
<br />
For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the<br />
following to be the minimal set that is necessary to get. I have not tested<br />
with any version of Ubuntu, but the line is probably almost identical if not<br />
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007 WORKS. Note<br />
that Spring 0.75b2 depends on the boost libraries version 1.34.* and won't<br />
work on lower versions. (updated libboost-serialization-dev, and libvorbis-dev dependencies for 0.76b1)<br />
<br />
Also, on 64-bit be sure to build against devIl 1.6.8-rc2 or higher, 1.6.7 has a bug in the PNG loading code that causes issues.<br />
<br />
<code><pre><br />
aptitude install scons build-essential zlib1g-dev libfreetype6-dev<br />
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev<br />
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev<br />
aptitude install libboost-serialization-dev python2.5-dev zip<br />
aptitude install sun-java6-jdk libvorbis-dev<br />
</pre></code><br />
<br />
This has been tested to work with a clean install of gentoo 2007.0:<br />
<br />
<code><pre><br />
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0<br />
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost<br />
emerge media-libs/devil app-arch/zip media-libs/libogg<br />
</pre></code><br />
<br />
On Fedora 8, these dependencies should be sufficient:<br />
<br />
<code><pre><br />
yum install scons boost-devel openal-devel SDL-devel libvorbis-devel <br />
yum install devIl-devel glew-devel java-1.7.0-icedtea-devel<br />
</pre></code><br />
Users of other distributions should be able to figure out the correct package<br />
names from this. The scons configure will whine if you forget something, but it<br />
does not check if you remembered to install zip, even though you still need it.<br />
<br />
=== Build And Install ===<br />
<br />
The build will spew out warnings like the following, which you can safely ignore:<br />
<br />
<code><pre><br />
warning: division by zero<br />
warning: 'q' may be used uninitialized in this function<br />
</pre></code><br />
<br />
Configure and build:<br />
<br />
<code><pre><br />
scons configure<br />
scons<br />
</pre></code><br />
<br />
Install:<br />
<br />
<code><pre><br />
scons install<br />
mkdir -p /etc/spring<br />
echo '$HOME/.spring' > /etc/spring/datadir<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/local/games/spring</code> and<br />
read-only data in <code>/usr/local/share/games/spring</code>.<br />
<br />
== Network ==<br />
<br />
If you have a public ip and no firewall, then you don't need to do anything.<br />
<br />
If you don't want to host any games, just join them, you shouldn't need to do anything.<br />
<br />
If you have a firewall, to be able to host, you must enable incoming udp to port 8452. If you are behind a NAT, to be able to host you must either use nat traversal / hole punching feature in your lobby client, OR port forward that port from your public ip to your gaming machine.<br />
<br />
= Finalizing installation =<br />
<br />
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.<br />
<br />
I'm assuming bash here, but you can use anything you like to do it of course.<br />
<br />
== Data Directories ==<br />
<br />
Do this to create your per-user data directories. You will be downloading maps and mods etc to these dirs later.<br />
<br />
<code><pre><br />
mkdir -p ~/.spring/{base,maps,mods}<br />
</pre></code><br />
<br />
If the above did not work for you, then you can try:<br />
<br />
<code><pre><br />
mkdir ~/.spring ~/.spring/base ~/.spring/maps ~/.spring/mods<br />
</pre></code><br />
<br />
== Maps ==<br />
<br />
You need at least one map to succesfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
== Mods ==<br />
<br />
You need at least one mod to successfully run spring.<br />
<br />
Go to [http://www.unknown-files.net/spring/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.<br />
<br />
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.<br />
<br />
If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.<br />
<br />
== OTA Content ==<br />
<br />
If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:<br />
<br />
<code><pre><br />
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip<br />
unzip -d ~/.spring/base base-ota-content.zip<br />
</pre></code><br />
<br />
Note that you need to own a copy of Total Annihilation, to download this file legally.<br />
<br />
Mods that do not require this file are at least NanoBlobs and Kernel Panic, TODO list other mods that don't need it.<br />
<br />
== Settings == <br />
<br />
Defaults should be usable, so you can ignore this until you want to maximize your eye candy or fps :)<br />
<br />
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.<br />
<br />
If you want a tool for editing the file, you can use [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] ([http://springlobby.info SpringLobby] has this integrated).<br />
<br />
=== Dual Head ===<br />
<br />
Automatic: if you are using [http://trac.springlobby.info/wiki/SpringSettings SpringSettings] you can select a dual screen resolution in simple mode and the rest is done automatically. <br />
<br />
Manual: to make Dual Monitors work add/change these settings in your .springrc file. <br />
"DualScreenMiniMapOnLeft=1,<br />
DualScreenMode=1,<br />
XResolution=2560,<br />
YResolution=1024"<br />
<br />
Make sure to use your own resolution for the X,Y resolutions. For example: you have two monitors configured for 1280x1024, the X,Y is 2560x1024.<br />
<br />
Save then restart Spring.<br />
<br />
== LuaUI ==<br />
<br />
Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.<br />
<br />
Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI. <br />
<br />
To install some LuaUI scripts, start by copying LuaUI folder from you read-only data directory to your read-write data directory.<br />
<br />
<code><pre><br />
rm -r ~/.spring/LuaUI<br />
cp -r /usr/share/games/spring/LuaUI ~/.spring/LuaUI<br />
</pre></code><br />
<br />
Then go find the LuaUI scripts you need from [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section]. All LuaUI scripts are released there, so if you make good ones yourself, make sure to upload them.<br />
<br />
The scripts can come in any setup, so prepare to decompress them if they are compressed. They might have a whole directory structure, and they should have their own instructions on how to install them. Check which directory you need to extract them to. Most likely it is ~/.spring/LuaUI but it might be a directory inside this directory too for some script.<br />
<br />
Once you have copied the script into place, when you start spring next time, you can press F11 to enable/disable anything from your list of installed LuaUI scripts. If your new script is not there, you copied it wrong.<br />
<br />
== Lobby Client ==<br />
<br />
To setup online games, you need a lobby client. There are several options to choose from.<br />
<br />
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.<br />
<br />
Recommended lobby client for linux is either SpringLobby or AFLobby. You can use them in windows and mac too.<br />
<br />
=== Omni ===<br />
<br />
This project has been abandoned, and you should not use it.<br />
<br />
=== UnityLobby ===<br />
<br />
UnityLobby has been abandoned since april 2007, and you should not use it.<br />
<br />
=== [http://springlobby.info SpringLobby] ===<br />
<br />
SpringLobby is for (at least) Windows, Linux and Mac. It's now in a usable state and has a feature set close to that of TASClient for windows. Try it out! Bug reports and feature requests are very much welcome.<br />
<br />
Visit http://springlobby.info for all things SpringLobby.<br />
<br />
=== AFLobby ===<br />
<br />
This project is very promising, and is usable for online multi player. Its the oldest lobby still actively maintained.<br />
<br />
Official webpage for the project is http://www.darkstars.co.uk which should always have the latest release for download.<br />
<br />
moo<br />
<br />
= Troubleshooting =<br />
<br />
== Ingame ==<br />
<br />
=== LuaUI Crash Ingame ===<br />
<br />
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:<br />
<br />
<code><pre><br />
/resbar 1<br />
/tooltip 1<br />
</pre></code><br />
<br />
These might not be necessary in 0.75 anymore at all.<br />
<br />
Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.<br />
<br />
LuaUI can also be restarted after it crashed. Often this does the trick and it works fine the rest of the game:<br />
<br />
<code><pre><br />
/luaui reload<br />
</pre></code><br />
<br />
=== Mouse is slow in fullscreen mode ===<br />
<br />
Run:<br />
<code><pre><br />
echo 'export SDL_MOUSE_RELATIVE=0' >> ~/.bash_profile<br />
</pre></code><br />
And log out and log in again.<br />
<br />
The mouse should now be as fast as in windowed mode.<br />
<br />
=== Rotating Buildings Ingame ===<br />
<br />
You can rotate a building before you give the build order, but the keys that do this don't work in linux by default for some users. Issue the following commands in the beginning of the game:<br />
<br />
<code><pre><br />
/bind keycodex buildfacing inc<br />
/bind keycodey buildfacing dec<br />
</pre></code><br />
<br />
Keycodex and keycodey above are just placeholders. What you want to write depends on which key you want to use. To see what keycodes any keys have, do:<br />
<br />
<code><pre><br />
/keydebug yes<br />
</pre></code><br />
<br />
And then hit the keys you want to use, and spring prints the keycodes in the message buffer.<br />
<br />
TODO: add information on how to save the settings so that they work the next time you start spring.<br />
<br />
=== Map is White ===<br />
<br />
If the whole map is only shades of white and grey, there is a problem with your display driver. Maybe your gpu is very old and does not support some needed opengl feature. For example I had this problem with matrox g550 but not with some very old geforce.<br />
<br />
== Startup ==<br />
<br />
=== Missing Default Cursor ===<br />
<br />
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 [[SetupGuide#OTA_Content|earlier in this document]].<br />
<br />
=== could not open file: gamedata/defs.lua ===<br />
<br />
Make sure your ~/.spring does not contain an outdated version of base/springcontent.sdz because a new version of this file is distributed with spring.<br />
If you do, just remove it.<br />
<br />
=== sounds/button9.wav "cant find wav file" ===<br />
<br />
Same problem as above.<br />
<br />
=== Couldnt find matching GLX visual ===<br />
<br />
Reduce anti aliasing.<br />
<br />
=== GL_ARB_texture_compression not found ===<br />
<br />
This can be an issue with your gpu drivers. The drivers you are using do not support a feature that is required to run spring. You might have better luck with the closed source official drivers of nvidia or amd cards. If your gpu itself is really old, this might not help.<br />
<br />
If you use the fglrx ati-graphics driver and you are getting this error there might be a chance that still spring work (I use this with ubuntu gusty).<br />
At first we must check that fglrx is installed correctly:<br />
<br />
<code><pre><br />
~$ fglrxinfo<br />
display: :0.0 screen: 0<br />
OpenGL vendor string: ATI Technologies Inc.<br />
OpenGL renderer string: ATI Mobility Radeon X1400<br />
OpenGL version string: 2.0.6747 (8.40.4)<br />
</pre></code><br />
<br />
Then lets check the glx-extention.<br />
<br />
<code><pre><br />
~$ glxinfo | grep direct<br />
Xlib: extension "XFree86-DRI" missing on display ":1.0".<br />
direct rendering: No<br />
</pre></code><br />
<br />
If you get this message, notice that glxinfo releates to display ':1' and fglrxinfo to display ':0'!! Lets check the glx-extention on display :0 now.<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 glxinfo | grep direct<br />
direct rendering: Yes<br />
</pre></code><br />
<br />
This message mean that you can start spring by typing (in a terminal)<br />
<br />
<code><pre><br />
~$ DISPLAY=:0 spring<br />
</pre></code><br />
<br />
If you use the TASclient with wine and the native linux spring. Start the whole TASclient-start-script by typing. <br />
<br />
<code><pre><br />
DISPLAY=:0 TASCLIENT-start-script<br />
</pre></code><br />
<br />
But Notice under circumstances is no windowmanager running on screen :0! This means there are NO windowframes at the TASClient window! You can't move it or close it by clicking the closebutton (unless you click at the close button on the terminal-window in witch you startet TAS). You can although close TAS with the keys ALT-F4<br />
<br />
=== OpenAL Segfault ===<br />
<br />
If spring crashes with this output:<br />
<br />
<code><pre><br />
OpenAL: ALC_EXT_capture AL_EXT_capture AL_EXT_vorbis AL_EXT_MP3<br />
AL_LOKI_quadriphonic AL_LOKI_play_position AL_LOKI_WAVE_format<br />
AL_LOKI_IMA_ADPCM_format AL_LOKI_buffer_data_callback ALC_LOKI_audio_channel<br />
Segmentation fault (core dumped)<br />
</pre></code><br />
<br />
Look into this thread on the forums for a fix: http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12568<br />
<br />
Then bug nemo in #taspring to finish this troubleshooting entry. He knows how to fix it.<br />
<br />
This is mod-related, ie. it only happens on some mods. Please list here the mod versions that give this error for you.<br />
<br />
- Star Wars mod, unknown version, by user report<br />
<br />
The problematic mod contains a sound file that crashes openal. You can try to unzip the mod file that crashed for you, and play each sound file. Please report any sound files that fail to play right, just list them here.<br />
<br />
- unknown file<br />
<br />
== Compiletime ==<br />
<br />
=== make_gamedata_arch.sh not found ===<br />
<br />
The .zip you downloaded is for windows, you must download a .bz2, instructions [[SetupGuide#Downloading_A_Tarball|earlier in this document]].<br />
<br />
=== invalid use of ILvoid ===<br />
<br />
During compiling, if you get a lot of the following errors:<br />
<br />
<code><pre><br />
/usr/include/IL/il.h:497: error: '<anonymous>' has incomplete type <br />
/usr/include/IL/il.h:497: error: invalid use of 'ILvoid'<br />
</pre></code><br />
<br />
This happens because the version of libdevil-dev you have installed is not compatible with gcc version 4.2 and newer.<br />
<br />
You should upgrade your libdevil-dev to fix this issue. However, in some distributions (at least gentoo), the fixed package has the SAME version number as the older unfixed package, so you might actually need to remove your current libdevil-dev package completely and reinstall it.<br />
<br />
TODO: add critical version numbers of libdevil.<br />
<br />
== Network Setup ==<br />
<br />
Usually you don't need to do any network setup whatsoever, because the lobbies take care of nat traversal with firewall hole punching, but if you need to know the topology, it goes like this:<br />
<br />
Host needs to enable incoming udp to port 8452, and outgoing replies to those.<br />
Non-host players need to enable outgoing udp, and incoming replies to those.<br />
So basically only non-host players initiate "connections", and only the server listens on a well-known port.<br />
<br />
== If You Still Have Problems ==<br />
<br />
Join to #taspring on Freenode or #sy on QuakeNet and try your luck.<br />
<br />
However, generic linux problems not really related to installing this should be asked elsewhere.<br />
<br />
Prepare to list your distribution, which installation method you used, and what exactly is the error. Don't ask if people are around or not, just go straight to business and tell all details, for maximizing your chances of getting help.<br />
<br />
== IRC ==<br />
<br />
# #taspring @ FreeNode<br />
# #sy @ QuakeNet<br />
<br />
== Asking For Help ==<br />
<br />
Ok so you need human help. This is how '''NOT''' to do it:<br />
<br />
<code><pre><br />
15:54 -!- **** [n=****@*] has joined #taspring<br />
15:54 < ****> Hi, i have a problem with compiling spring on debian<br />
15:54 < ****> can anyone help me?<br />
15:57 -!- **** [n=****@*] has quit [Client Quit]<br />
</pre></code><br />
<br />
Don't ask to ask, instead go straight to business by stating the exact problem you have, and giving all necessary information. What you were trying to achieve, how did you try to do it, what happened and what did you expect to happen.<br />
<br />
Then WAIT for someone to notice you.<br />
<br />
== Configure Options ==<br />
<br />
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:<br />
<br />
<code><pre><br />
$ scons --help<br />
scons: Reading SConscript files ...<br />
make: Nothing to be done for `all'.<br />
Succes building streflop!<br />
Updating bitmaps.sdz<br />
Updating springcontent.sdz<br />
scons: done reading SConscript files.<br />
<br />
platform: Set to linux, freebsd or windows<br />
default: None<br />
actual: linux<br />
<br />
debug: Set to yes to produce a binary with debug information<br />
default: 0<br />
actual: 3<br />
<br />
debugdefines: Set to no to suppress DEBUG and _DEBUG preprocessor #defines \<br />
(use to add symbols to release build)<br />
default: True<br />
actual: True<br />
<br />
syncdebug: Set to yes to enable the sync debugger<br />
default: False<br />
actual: False<br />
<br />
synccheck: Set to yes to enable sync checker & resyncer<br />
default: True<br />
actual: True<br />
<br />
optimize: Enable processor optimizations during compilation<br />
default: 1<br />
actual: 2<br />
<br />
profile: Set to yes to produce a binary with profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_generate: Set to yes to compile with -fprofile-generate \<br />
to generate profiling information<br />
default: False<br />
actual: False<br />
<br />
profile_use: Set to yes to compile with -fprofile-use to use \<br />
profiling information<br />
default: False<br />
actual: False<br />
<br />
cpppath: Set path to extra header files<br />
default: []<br />
actual:<br />
<br />
libpath: Set path to extra libraries<br />
default: []<br />
actual:<br />
<br />
fpmath: Set to 387 or SSE on i386 and AMD64 architectures<br />
default: 387<br />
actual: 387<br />
<br />
prefix: Install prefix used at runtime<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
installprefix: Install prefix used for installion<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
datadir: Data directory (relative to prefix)<br />
default: share/games/spring<br />
actual: share/games/spring<br />
<br />
bindir: Directory for executables (rel. to prefix)<br />
default: games<br />
actual: games<br />
<br />
libdir: Directory for AI plugin modules (rel. to prefix)<br />
default: lib/spring<br />
actual: lib/spring<br />
<br />
strip: Discard symbols from the executable (only when neither \<br />
debugging nor profiling)<br />
default: True<br />
actual: False<br />
<br />
disable_avi: Set to no to turn on avi support<br />
default: False on windows, True otherwise<br />
actual: True<br />
<br />
use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation<br />
default: False<br />
actual: False<br />
<br />
use_mmgr: Use memory manager<br />
default: False<br />
actual: False<br />
<br />
dc_allowed: Specifies whether FPS mode (Direct Control) is allowed in game<br />
default: True<br />
actual: True<br />
<br />
cachedir: Cache directory (see scons manual)<br />
default: None<br />
actual:<br />
<br />
Use scons -H for help about command-line options.<br />
</pre></code><br />
<br />
= Tips =<br />
<br />
'''This section contains just some old crap I didn't write, and shouldn't be necessary.'''<br />
<br />
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.<br />
<br />
* 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)<br><br><code>(define devices '(alsa))<br>(define speaker-num 2)<br><br>(define alsa-out-device "hw:0,0")<br>(define alsa-in-device "hw:0,0")</code><br><br>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.<br />
<br />
* 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...<br />
:* Just poke any developer on IRC:<br />
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]<br />
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]<br />
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]<br />
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].<br />
<br />
''' [[Main_Page|<- Back to Main page]]'''<br />
<br />
[[Category:Linux Port]][[Category:Playing]]</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=Clans/LCC&diff=4379Clans/LCC2007-11-22T17:08:58Z<p>LordMatt: </p>
<hr />
<div>'''L'''''33t '''C'''ommander'S '''C'''luB<br />
<br />
'''Former name''' - '''L'''33t '''C'''PU '''C'''reW<br />
<br />
'''Clan Website''' - http://www.lcc-clan.com<br />
<br />
''*'''Members'''''<br />
<br />
*[LCC]LordMatt '''U.S''' <br />
*[LCC]quantum '''Italy''' <br />
*[LCC]Lion_heart[Ck] '''U.S''' <br />
*[LCC]Dynamoe2 '''U.S''' <br />
*[LCC]Baleeted '''Bahrain''' <br />
*[LCC]Licho '''CZECH Republic''' <br />
*[LCC]det '''U.S'''<br />
*[LCC]hydrix '''U.S'''<br />
*[LCC]Saktoth '''Australia'''<br />
*[LCC]Brawler[LF] '''U.S'''<br />
*[LCC]Islington '''CZECH Republic'''<br />
*[LCC]KingRaptor '''Malaysia'''<br />
*[LCC]szgezu[HSSD] '''Hungary'''<br />
*[LCC]Eastwood '''Hungary'''<br />
*[LCC]Teutooni '''Finland'''<br />
*[LCC]Vandervar '''Netherlands'''<br />
*[LCC]SLizer '''Finland'''<br />
*[LCC]Wilsby '''U.K'''<br />
*[LCC]Hael '''Finland'''<br />
*[LCC]Darthvader '''Netherlands'''<br />
*[LCC]TehPwnage '''Phillipines'''<br />
*[LCC]jK '''Germany'''<br />
*[LCC]Magus_X '''Brazil'''<br />
<br />
''*'''Countries''''' <br />
<br />
*'''U.S'''<br />
*'''Italy'''<br />
*'''Bahrain'''<br />
*'''Czech republic'''<br />
*'''Australia'''<br />
*'''Malaysia'''<br />
*'''Hungary'''<br />
*'''Finland'''<br />
*'''Netherlands'''<br />
*'''Finland'''<br />
*'''Phillipines'''<br />
*'''Brazil<br />
<br />
''*'''Complete Annihilation players'''''<br />
'''*[LCC]quantum''' <br />
'''*[LCC]Licho'''<br />
''' *[LCC]Saktoth''' <br />
''' *[LCC]KingRaptor'''<br />
'''*[LCC]jK''''''<br />
<br />
''*'''Retired Players?'''''<br />
<br />
'''*[LCC]Dynamoe2'''<br />
'''*[LCC]Hydrix'''<br />
'''*[LCC]TehPwnage'''<br />
'''*[LCC]Magus_X'''</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=SetupGuide&diff=16492SetupGuide2007-09-06T00:30:01Z<p>LordMatt: /* TASClient */</p>
<hr />
<div>== Linux Setup Guide ==<br />
<br />
=== Which Version To Install ===<br />
<br />
'''0.75b2 has been released not so long ago. This affects some parts of this guide. Currently this guide is MOSTLY updated. I will remove this notice when the pages are fully up to date. Everything that is not especially marked as old should be up to date.'''<br />
<br />
To play online, you must have the same version as everyone else in the game.<br />
<br />
Most people should get the current release, version 0.75b2. There are usually<br />
between 100 and 200 people online in the lobby, and if you want to play with<br />
them, you need this.<br />
<br />
'''Do not use older than current release version''', unless you really know what you are doing.<br />
<br />
If you want to see the bleeding edge, you can checkout svn head of spring, but<br />
it can not be used to play with people who have the release, so you are<br />
practically limited to playing against nemo. This is mainly interesting for<br />
people who want to contribute to the project, for testing, finding bugs and<br />
fixing them, and implementing new features. Head can be seriously broken from<br />
time to time, or not even compile.<br />
<br />
=== Installing With Package Managers On Various Distributions ===<br />
<br />
If there is a package for your distributions preferred package manager, it is<br />
recommended to use it instead of compiling the program yourself from sources.<br />
<br />
TODO Yokozar is the new official .deb maintainer, he should have debs for 0.75b2 in a repository sooner or later.<br />
<br />
==== 0.74b3 For Etch (Debian 4.0 Stable) With APT ====<br />
<br />
'''DO NOT USE THIS, IT IS FOR OLD VERSION'''<br />
<br />
<code><pre><br />
echo "deb http://www.osrts.info/~tvo/deb etch spring" >> /etc/apt/sources.list<br />
aptitude update<br />
aptitude install spring spring-data<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/games/spring </code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
==== 0.74b3 For Sid (Debian Unstable) With APT ====<br />
<br />
'''DO NOT USE THIS, IT IS FOR OLD VERSION'''<br />
<br />
The current .deb for Sid is broken, because it depends on some boost packages<br />
of version 1.33 that are not installable on sid, which has only 1.34. A<br />
slightly more complex way to install is necessary:<br />
<br />
<code><pre><br />
echo "deb http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list<br />
echo "deb-src http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list<br />
aptitude update<br />
aptitude install dpkg-dev devscripts<br />
apt-get source spring<br />
apt-get build-dep spring<br />
cd spring-0.74~b3/<br />
debuild -us -uc<br />
debi<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/games/spring </code> and<br />
read-only data in <code> /usr/share/games/spring</code>.<br />
<br />
==== 0.74b3 For Ubuntu (any version) With APT ====<br />
<br />
'''DO NOT USE THIS, IT IS FOR OLD VERSION'''<br />
<br />
If you have boost 1.33, then all you need is:<br />
<br />
<code><pre><br />
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list<br />
aptitude update<br />
aptitude install spring spring-data<br />
</pre></code><br />
<br />
If you have boost 1.34, you have to do it the same way as debian unstable:<br />
<br />
<code><pre><br />
echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list<br />
echo "deb-src http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list<br />
aptitude update<br />
aptitude install dpkg-dev devscripts<br />
apt-get source spring<br />
apt-get build-dep spring<br />
cd spring-0.74~b3/<br />
debuild -us -uc<br />
debi<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/games/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
==== 0.75b2 For Gentoo With Portage ====<br />
<br />
'''The location of the overlay will change as soon as we get this in official portage.'''<br />
<br />
An overlay to use with layman is provided. If gentoo overlays and/or layman are new to you, [http://overlays.gentoo.org/ read about them], as they are an essential part of gentoo.<br />
<br />
This example assumes you never used layman before. If it's not your first time, you hopefully know what to do.<br />
<br />
<code><pre><br />
emerge layman<br />
layman -f -a spring-unofficial \<br />
-o http://svn.springlobby.info/trunk/gentoo/overlays.xml<br />
echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf<br />
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords<br />
emerge spring<br />
</pre></code><br />
<br />
Layman makes upgrading really easy too:<br />
<br />
<code><pre><br />
layman --sync ALL<br />
emerge spring<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and<br />
read-only data in <code>/usr/share/games/spring</code>.<br />
<br />
=== Installing 0.75b2 From Source ===<br />
<br />
'''You might encounter sync errors in online play if you are not using the exact same version of the compiler and same compiler settings as used for prebuilt packages!'''<br />
<br />
For 0.75b2 these are: TODO add them here.<br />
<br />
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.<br />
<br />
==== Getting The Source ====<br />
<br />
You can either download the source as a 3.9MB tarball (recommended; v. 0.75b2) or get it from the subversion repository. Either way, the result is the same.<br />
<br />
===== Downloading A Tarball =====<br />
<br />
<code><pre><br />
cd /tmp<br />
wget http://spring.clan-sy.com/dl/spring_0.75b2_src.tar.bz2<br />
tar xjf spring_0.75b2_src.tar.bz2<br />
cd spring_0.75b2<br />
</pre></code><br />
<br />
===== Checking Out From Subversion =====<br />
<br />
<code><pre><br />
aptitude install subversion # if you are not on debian, figure it out<br />
svn co https://spring.clan-sy.com/svn/spring/tags/spring_0.75b2 /tmp/spring_0.75b2<br />
cd /tmp/spring_0.75b2<br />
</pre></code><br />
<br />
==== Getting The Dependencies ====<br />
<br />
For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the<br />
following to be the minimal set that is necessary to get. I have not tested<br />
with any version of Ubuntu, but the line is probably almost identical if not<br />
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007 WORKS.<br />
<br />
<code><pre><br />
aptitude install scons build-essential zlib1g-dev libfreetype6-dev<br />
aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev<br />
aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev<br />
aptitude install python2.4-dev zip<br />
aptitude install libsablevm1-dev<br />
</pre></code><br />
<br />
This has been tested to work with a clean install of gentoo 2007.0:<br />
<br />
<code><pre><br />
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0<br />
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost<br />
emerge media-libs/devil app-arch/zip<br />
</pre></code><br />
<br />
Users of other distributions should be able to figure out the correct package<br />
names from this. The scons configure will whine if you forget something, but it<br />
does not check if you remembered to install zip, even though you still need it.<br />
<br />
==== Building And Installing ====<br />
<br />
The build will spew out warnings like the following, which you can safely ignore:<br />
<br />
<code><pre><br />
warning: division by zero<br />
warning: 'q' may be used uninitialized in this function<br />
</pre></code><br />
<br />
Configure, build and install:<br />
<br />
<code><pre><br />
scons configure<br />
scons<br />
scons install<br />
mkdir -p /etc/spring<br />
echo '$HOME/.spring' > /etc/spring/datadir<br />
</pre></code><br />
<br />
Your paths are: Spring executable in <code>/usr/local/games/spring</code> and<br />
read-only data in <code>/usr/local/share/games/spring</code>.<br />
<br />
== Finalizing installation ==<br />
<br />
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.<br />
<br />
I'm assuming bash here, but you can use anything you like to do it of course.<br />
<br />
=== Making Data Directories ===<br />
<br />
<code><pre><br />
mkdir -p ~/.spring/{base,maps,mods}<br />
</pre></code><br />
<br />
=== Getting Maps ===<br />
<br />
You need at least one map to succesfully run spring.<br />
<br />
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.<br />
<br />
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.<br />
<br />
=== Getting Mods ===<br />
<br />
You need at least one mod to successfully run spring.<br />
<br />
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.<br />
<br />
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.<br />
<br />
If you want to play mods based on Total Annihilation, for example XTA, AA, BA, then you have to do the following:<br />
<br />
<code><pre><br />
wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip<br />
unzip -d ~/.spring/base base-ota-content.zip<br />
</pre></code><br />
<br />
Note that you need to own a copy of Total Annihilation, to download this file legally.<br />
<br />
If you want to view unit stats of mods, [http://modinfo.unknown-files.net/modit/modit.php this] is the site for you.<br />
<br />
=== Editing Settings === <br />
Defaults should be usable, so you can ignore this until you want to maximise your eye candy or fps :)<br />
<br />
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.<br />
<br />
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.<br />
<br />
=== Using LuaUI ===<br />
<br />
Spring UI is scriptable with Lua. This is called LuaUI, and it is not enabled per default.<br />
<br />
Replace LuaUI=0 with LuaUI=1 in your ~/.springrc to use LuaUI.<br />
<br />
Lua scripts for LuaUI can be found in [http://spring.unknown-files.net/category/19/Lua_Scripts/ Unknown Files LuaUI Section].<br />
<br />
<br />
TODO need more stuff here.<br />
<br />
=== Installing Lobby Client ===<br />
<br />
To setup online games, you need a lobby client. There are several options to choose from.<br />
<br />
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.<br />
<br />
Recommended lobby client for linux is either SpringLobby or AFLobby. You can use them in windows and mac too.<br />
<br />
==== Omni ====<br />
<br />
This project has been abandoned, and you should not use it.<br />
<br />
==== UnityLobby ====<br />
<br />
This project has been abandoned, and you should not use it.<br />
<br />
==== [http://springlobby.info SpringLobby] ====<br />
<br />
SpringLobby is for (at least) Windows, Linux and Mac. It's now in a usable state and has a feature set close to that of TASClient for windows. Try it out! Bug reports and feature requests are very much welcome.<br />
<br />
Visit http://springlobby.info for all things SpringLobby.<br />
<br />
==== AFLobby ====<br />
<br />
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<br />
<br />
==== TASClient ====<br />
<br />
I used to recommend wine+TASClient solution before, but now you should try SpringLobby or AFLobby first, before you go this route.<br />
<br />
Certain newish version of wine fails with tasclient, TODO can't remember which one. It should be fixed in the very latest version of wine.<br />
<br />
This is a windows program, but it works just fine under wine in linux, and can be used together with native linux spring. I used it myself before moving to SpringLobby.<br />
<br />
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).<br />
<br />
Download the installer of Spring for Windows, and run it in wine:<br />
<br />
<code><pre><br />
wget http://spring.clan-sy.com/dl/spring_0.75b2.exe<br />
wine spring_0.75b2.exe<br />
</pre></code><br />
<br />
No configuration of wine should be needed, if your distribution is sane.<br />
<br />
Complete the install, and let it install to the default location, which is Program Files\Spring.<br />
<br />
Assuming you completed the earlier step of creating the data directories, now we need to link the windows and linux data together:<br />
<br />
<code><pre><br />
WINESPRING=~/.wine/drive_c/Program\ Files/Spring<br />
NATIVE=~/.spring<br />
<br />
touch "${WINESPRING}/script.txt"<br />
ln -s "${WINESPRING}/script.txt" "${NATIVE}/script.txt"<br />
<br />
rm -r "${WINESPRING}/maps"<br />
ln -s "${NATIVE}/maps" "${WINESPRING}/maps"<br />
<br />
rm -r "${WINESPRING}/mods"<br />
ln -s "${NATIVE}/mods" "${WINESPRING}/mods"<br />
<br />
rm -r "${WINESPRING}/base"<br />
ln -s "${NATIVE}/base" "${WINESPRING}/base"<br />
<br />
rm -r "${WINESPRING}/demos"<br />
ln -s "${NATIVE}/demos" "${WINESPRING}/demos"<br />
</pre></code><br />
<br />
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:<br />
<br />
<code><pre><br />
#include <windows.h><br />
#include <stdio.h><br />
#include <tchar.h><br />
<br />
#define NATIVE_SPRING_LOCATION TEXT("/usr/games/spring")<br />
#define SPRING_VERSION_REPLY "Spring 0.75b2"<br />
<br />
int main (int argc, char **argv)<br />
{<br />
if (argc > 1 && !strcmp(argv[1], "/V"))<br />
{<br />
puts(SPRING_VERSION_REPLY);<br />
return 0;<br />
}<br />
<br />
STARTUPINFO si;<br />
ZeroMemory( &si, sizeof(si) );<br />
si.cb = sizeof(si);<br />
<br />
PROCESS_INFORMATION pi;<br />
ZeroMemory( &pi, sizeof(pi) );<br />
<br />
// Start the child process.<br />
if (!CreateProcess(<br />
_tcsdup(NATIVE_SPRING_LOCATION), // No module name (use command line)<br />
GetCommandLine(), // Command line<br />
NULL, // Process handle not inheritable<br />
NULL, // Thread handle not inheritable<br />
FALSE, // Set handle inheritance to FALSE<br />
0, // No creation flags<br />
NULL, // Use parent's environment block<br />
NULL, // Use parent's starting directory<br />
&si, // Pointer to STARTUPINFO structure<br />
&pi)) // Pointer to PROCESS_INFORMATION structure<br />
{<br />
printf( "CreateProcess failed (%d).\n", GetLastError() );<br />
return 1;<br />
}<br />
<br />
// Wait until child process exits. Wine actually does not know how to wait<br />
// for native linux process, so this will return instantly and your gametime<br />
// counter does not increase so you don't get any rank.<br />
WaitForSingleObject( pi.hProcess, INFINITE );<br />
<br />
// Close process and thread handles.<br />
CloseHandle( pi.hProcess );<br />
CloseHandle( pi.hThread );<br />
<br />
return 0;<br />
}<br />
</pre></code><br />
<br />
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.<br />
<br />
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:<br />
<br />
<code><pre><br />
aptitude install mingw32<br />
i586-mingw32msvc-g++ spring.cc -o ~/.wine/drive_c/Program\ Files/Spring/spring.exe<br />
</pre></code><br />
<br />
This assumed debian for installing the crosscompiler, but mingw32 is probably simple to install on other distributions as well.<br />
<br />
TODO should provide binary packages for this launcher, as all people don't have the possibility to set up cross compiler.<br />
<br />
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:<br />
<br />
<code><pre><br />
#!/usr/bin/env sh<br />
cd ~/.wine/drive_c/Program\ Files/Spring<br />
wine TASClient.exe<br />
</pre></code><br />
<br />
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.'''<br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
=== Troubleshooting ===<br />
<br />
==== game dies with sounds/button9.wav "cant find wav file" ====<br />
<br />
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.<br />
<br />
==== If You Still Have Problems ====<br />
<br />
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.<br />
<br />
However, generic linux problems not really related to installing this should be asked elsewhere.<br />
<br />
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.<br />
<br />
Other common problems and solutions coming soon.<br />
<br />
==== Can't See Configure Options Before Configuring ====<br />
<br />
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:<br />
<br />
<code><pre><br />
$ scons --help<br />
scons: Reading SConscript files ...<br />
make: Nothing to be done for `all'.<br />
Succes building streflop!<br />
Updating bitmaps.sdz<br />
Updating springcontent.sdz<br />
scons: done reading SConscript files.<br />
<br />
platform: Set to linux, freebsd or windows<br />
default: None<br />
actual: linux<br />
<br />
debug: Set to yes to produce a binary with debug information<br />
default: 0<br />
actual: 0<br />
<br />
syncdebug: Set to yes to enable the sync debugger<br />
default: False<br />
actual: False<br />
<br />
optimize: Enable processor optimizations during compilation<br />
default: 1<br />
actual: 2<br />
<br />
profile: Set to yes to produce a binary with profiling information<br />
default: False<br />
actual: False<br />
<br />
cpppath: Set path to extra header files<br />
default: []<br />
actual: <br />
<br />
libpath: Set path to extra libraries<br />
default: []<br />
actual: <br />
<br />
fpmath: Set to 387 or SSE on i386 and AMD64 architectures<br />
default: 387<br />
actual: 387<br />
<br />
prefix: Install prefix used at runtime<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
installprefix: Install prefix used for installion<br />
default: /usr/local<br />
actual: /usr/local<br />
<br />
datadir: Data directory (relative to prefix)<br />
default: share/games/spring<br />
actual: share/games/spring<br />
<br />
bindir: Directory for executables (rel. to prefix)<br />
default: games<br />
actual: games<br />
<br />
libdir: Directory for AI plugin modules (rel. to prefix)<br />
default: lib/spring<br />
actual: lib/spring<br />
<br />
strip: Discard symbols from the executable <br />
(only when neither debugging nor profiling)<br />
default: True<br />
actual: True<br />
<br />
disable_avi: Set to no to turn on avi support<br />
default: False on windows, True otherwise<br />
actual: True<br />
<br />
use_tcmalloc: Use tcmalloc from goog-perftools for memory allocation<br />
default: False<br />
actual: False<br />
<br />
use_mmgr: Use memory manager<br />
default: False<br />
actual: False<br />
<br />
cachedir: Cache directory (see scons manual)<br />
default: None<br />
actual: <br />
<br />
Use scons -H for help about command-line options.<br />
</pre></code><br />
<br />
==== LuaUI Crash Ingame ====<br />
<br />
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:<br />
<br />
<code><pre><br />
/resbar 1<br />
/tooltip 1<br />
</pre></code><br />
<br />
These might not be necessary in 0.75 anymore at all.<br />
<br />
Also, you won't be able to change the build menu page with mouse anymore, but keys , and . do the trick.<br />
<br />
=== Tips ===<br />
<br />
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.<br />
<br />
* 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)<br><br><code>(define devices '(alsa))<br>(define speaker-num 2)<br><br>(define alsa-out-device "hw:0,0")<br>(define alsa-in-device "hw:0,0")</code><br><br>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.<br />
<br />
* 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...<br />
:* Just poke any developer on IRC:<br />
::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]<br />
::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]<br />
:* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]<br />
:* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].<br />
<br />
''' [[Main_Page|<- Back to Main page]]'''<br />
<br />
[[Category:Linux Port]][[Category:Playing]]</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=XTA&diff=19650XTA2006-11-16T22:12:56Z<p>LordMatt: </p>
<hr />
<div>XTA was a balance mod for [[TA]], developed by the [[SY]] clan.<br />
Its latest TA version is 0.95.<br />
<br />
For spring, it was the first mod available, the first that was ported and is what comes with the installation of the Spring engine ready to play. Spring does not currently come with XTA version 8; only v7. You will have to download this update to join other XTA v8 games and experience its benefits.<br />
<br />
To download the update installer please follow this link: [[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=7743]] This link also doubles ups as the development pages. You will be able to read on the latest plans of XTA here, and contribute your own ideas on the mod itself.<br />
<br />
XTA was maintained by people from the [[SY]] clan.<br />
<br />
Development of this mod is now made by the KnoX clan and other contributors, the balance is almost near the last version made by the SY's, with some changes, as well as new build pictures, higher quality models and FX.<br />
<br />
Newer versions will continue to be released to incorporate more detailed visual effects/or models as the spring engine develops.<br />
<br />
There is a new functional unit guide should you wish to consult for costs buildtree etc. To view the unit guide please follow this link: [[http://p15111940.pureserver.info/xta_v8/]]<br />
<br />
What makes XTA Special, Unique, Addictive ?<br />
XTA in comparison to AA for example, has a much more of an authentic TA feel. With no turbo charged easy fix solutions. Each unit has been carefully and slowly modified over the years with no drastic pruning to incorporate massive needless units. We believe XTA should keep to the bair roots of TA and yet open the experience to more diverse tactics. Each new unit added is excessively tested and is open for discussion by the ever growing XTA community. The main difference from the original TA (apart from the new engine)would be the teck tree and the strength of the Commanders. By opening the teck tree to higher levels early the SY clan has made the mod multi map type friendly in respects to pure metal maps etc. The choice to build higher level building and units is there, however an intelligent player will quickly learn when and how to build what and where very quickly. This also leaves the prospect of re-building your base quickly if you suffer a severe blow. Thus making XTA a more ever moving form of developing game play always keeping the players challenged. <br />
<br />
This page will be updated in the next few days. <br />
<br />
Back to [[Mods]]<br />
<br />
[[Category:Mods]]<br />
<br />
{{Category:Mods}}</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=XTA&diff=19645XTA2006-11-16T19:55:39Z<p>LordMatt: </p>
<hr />
<div>xta was a balance mod for [[TA]], developed by the [[SY]] clan.<br />
Its latest TA version was xta0.95.<br />
<br />
For spring, it was the first mod aviable, the first that was ported and is what comes with the installation of the Spring engine ready to play.<br />
<br />
The development of xta has continued for Spring, and current version is 66SE.<br />
Its mantained by people from the [[SY]] clan.<br />
<br />
Development of this mod is now made by Noize, the balance is almost near the last version made by the SY's, with some changes, as well as new build pictures and higher quality models.<br />
<br />
<br />
There is a functional [http://taspring.clan-sy.com/warcows/XTAv6/ unit guide] you would like to consult for costs buildtree etc.<br />
<br />
<br />
The basics are that all units are worth its cost and role.<br />
<br />
For some basic info on XTA go here for now:<br><br />
http://www.clan-sy.com/download/xta/<br><br />
[[Units]]<br />
<br />
Back to [[Mods]]<br />
<br />
[[Category:Mods]]<br />
<br />
{{Category:Mods}}<br />
<br />
<br />
Test</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=Monthly_Topic_Rotation&diff=14722Monthly Topic Rotation2006-09-29T02:32:53Z<p>LordMatt: </p>
<hr />
<div>"Monthy Topic Rotation" is a term coined by Gnome referring to the fact that people keep coming into the forums and posting messages on the same subject. It seems that as Spring becomes more popular, more new people keep coming up with the same ideas and questions... think of this as the "Is your idea original?" FAQ as opposed to the "real" [[FAQ]].<br />
<br />
Now in some situations it's okay to repost on the same topic, if it has been only mentioned before in other people's topics or if you make reference to the fact that it is a known issue you are addressing with new ideas... but that doesn't excuse you from the list. One way or the other, the community might make fun of you for rehashing old topics, expecially when they aren't forgotten so much as people are bored of talking about them.<br />
<br />
This has now turned into a sort of game. You can see the current scores here: http://maelstrom.niiil.com/?l=mtr (Note from a visitor: link seems to be down)<br />
<br />
=The Topics=<br />
'''List of Generic Topics with brief discussion and list of topics posted on these subjects for quick reference:'''<br />
<br />
===Custom Resources===<br />
Requests or Suggestions that involve anything from different names for the resources we have, better control over the handling of resources, resources like those in other games etc. The best generalized suggestion is for a more dynamic, mod controlled resource and unit limit. Often coupled with suggestions for hacking or script based work arounds for the lack of the requested feature.<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=5932 A Third Resource PLEASE!]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=6277 A proposed System]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=6342 Mentioned in conjunction with other requests for resource related features]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=121014 Carbon or Something]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=5966 Reserach as a Resource]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=121186 spicing up economy]<br />
<br />
===OTA Style Music===<br />
Requests or Suggestions that the engine include music playback, especially music that changes depending on what kind of action is happening in game. Associated with requests for a sound track of any kind or asking for a link to get the orriginal TA Soundtrack in MP3 format.<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2856 Soundtracks.]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2786&highlight=music Original TA music]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2640&highlight=music TA Style music]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2363&highlight=music Music Player code]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2348&highlight=music Is original music needed?]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=80030#80030 Music support?]<br />
<br />
As a subnote, many of Spring's pre beta members have been working on code to get the music working, while yet others have spent time studying other games and their setups. Current thinking is of a THE SIMS style, where you can specify your own music.<br />
<br />
===Raise/Lower Terrain===<br />
People suggesting or requesting some kind of better control over deformable terrain or some kind of terraforming unit. Often associated with people posting pictures of cool effects they have achieved through the use of the current "blow a big hole and then restore to the desired surface" method.<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2838 Raise/Lower Terrain?]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=6346 Terraforming]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=121091 Building Holes]<br />
<br />
===Camera Angles===<br />
suggesting changes to current camera angles, popularly related to the inability of the rotatable and FPS cams to go outside the map boundries, making it difficult to see units close to the edges of the map.<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2821 The #2 item on my wishlist]<br />
<br />
Also, there's the problem of the world stopping at a rather steep drop.<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2789 What is good, and what is bad]<br />
<br />
===The New GUI===<br />
Anything related to how bad the current GUI is, suggestions for features that already exists but users do not know about because they are barely documented, or simply threads asking for or about the new GUI.<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2801 New GUI questions]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=1994 New GUI testing]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=35418 Wheres the new gui?]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=1643 re: about the newGUI]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=4110 New "Interface"]<br />
<br />
===Multiple transport load sharing via cable hooks===<br />
Seriously WTF, this isn't even a good idea, why does this keep coming up?<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2621 Transports]<br />
<br />
===Mobile factories===<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2017 Rise and walk, or how my factorie grew legs (and wings too).]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2809#38534 "Build pads" for units]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=35072#35072 air based factories for FF]<br />
<br />
===Day and Night===<br />
<br />
Wouldn't it be pretty to see a tank's headlights in the dark? Even prettier would be to have a dynamic sun to go with it. =) Watch the mountain's shadows lengthen...<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=5514#5514 Reviving the request list]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=1598 Day and Night]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=552 how about night and day]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2872 Gameplay idea: Night]<br />
<br />
<br />
===FPS mode hud/movement changes===<br />
Lots of people don't think the FPS mode implimentation is being all that it can be. They love to make forum topics about it.<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2917 Regarding the FPS "gimmick"]<br />
<br />
===Game lobby moderators===<br />
A well known issue. People always seem to request it...<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2770 Client moderators]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3065 We need moderators]<br />
<br />
===Gaia Player===<br />
<br />
Subject specific threads:<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=1410 first one?]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3189 Almost directly related]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=1204 This is the last one]<br />
<br />
But this request appears in random threads every now and then.<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3154&start=20 is gaia in cvs? Alantai says so.]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2791], [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2627], [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2293&start=20], [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=1395].<br />
<br />
===Improved feature reactivity===<br />
<br />
Bridges that you can acctually walk on, better hit detection, there are lots of improvements that could be made to the way spring units, models, and features react to eachother in the most basic sense. Often they are mentioned in the same topic. <br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=48196#48196 3D Collission Mesh?]<br />
<br />
===Spherical/Looping/Endless maps===<br />
<br />
A number of options are available for making the map "go on forever"... and apparently the '''new''' new map format includes support for extanding the map behond the playable area of the map (no more ugly edges).<br />
<br />
Usually what is being suggested if for maps to just loop, refered to a sphere but more like a "double cylinder" or "Torus"... some people basically think we could just "warp" units to the other side of the map, but issues have been brought up with ranged weapons, line of sight and figuring out where shots are coming from. If you go WAY WAY back you can even see this idea included in an idea for an MMORTS based on the spring engine.<br />
<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=64751#64751 Monster Truck Madness 2? Looping Maps.]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=4065 Even MORE 3D]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3275 Spherical Maps]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=473 stop talking about this!!!]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=655 Does anyone Want This?]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=870&highlight=mmorts Multiple Maps Linked together... would also require being able to join a battle already in progress]<br />
<br />
<br />
===What is that map with the trees... (and others)===<br />
<br />
Ok, so its a map, but me, and others I'm sure are fed up of repeting ourselves... The map with trees is NOT availble for download. Its part of aGorms imagination. Unfortunatly the engin currentlyt can't handel the trees very well so its not released... You will see the screen alot because... well people think its a realy good screen.<br />
<br />
See the said screen:<br />
[http://taspring.clan-sy.com/screenshots/screen87.jpg The Tree Map]<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=99835#99835 Spring on Wikipedia]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=5707&highlight=whats+map What's this wiki map]<br />
<br />
===Rewinding Replays===<br />
<br />
Many people want stuff such as a .jumpto (time) command, or the ability to rewind during a replay. The nature of replays and the spring simulation implies that rewinding can never happen, so discussing this is really pointless.<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=6009 Rewinding for Replays?]<br />
<br />
===Random Map Generator===<br />
People want maps randomly generated so no one has an advantage starting out. One potential problem is the randomly generated maps might be unbalanced or suck in other ways. Also there are the issues of distributing the randomly generated map and the time it takes to generate it.<br />
<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=6950&highlight=random+map Random Map Generator]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=117414&highlight=random+map#117414 Unexplored Random Maps]<br />
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=76766&highlight=random+map#76766 SJ's Random Map]<br />
<br />
[[Category:Content]]</div>LordMatthttps://springrts-wiki.p2004a.com/mediawiki/index.php?title=Community_news&diff=4967Community news2006-06-12T15:56:59Z<p>LordMatt: /* 2006-05-11 Absolute Annihilation 1.5 Released */</p>
<hr />
<div>On this page, you can post news items that will be seen in the top right section of the frontpage. You can use this to post if you have created or found something of interest to the Spring community, such as a new map, a useful tool or perhaps a new useful page in the wiki. Details on how to update this page can be found [[Community_news_editing | here]].<br />
<br />
----<br />
===2006-06-11 Absolute Annihilation 1.5 Released===<br />
1.5 Released; Download here: http://aaspring.tk<br />
<br />
===2006-05-18 Gundam 1.0 achieved and released!===<br />
After over a year of work I have acomplished what I have set out to do.<br />
<br />
http://www.fileuniverse.com/?p=showitem&ID=3208<br />
<br />
===2006-05-13 NTai XE8 and NanoBlobs 0.4 Final Released===<br />
5 new groupAI's, a powerful skirmish AI, 2 maps, and The last Nanoblobz!!!<br />
Download here: www.darkstars.co.uk<br />
Manual / Unit Guide here: http://taspring.clan-sy.com/phpbb/viewtopic.php?t=4276<br />
Argh/AF<br />
<br />
===2006-05-01 Absolute Annihilation 1.46 Released===<br />
1.46 Released. Download here: http://aaspring.tk Mod homepage here: http://ta-aa.sourceforge.net Unit Guide here: http://ta-aa.sourceforge.net/modweb<br />
<br />
===2006-05-01 Modweb Generator v0.4 Released===<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3842 Get it here!]<br />
This will create a set of HTML pages about your mod, units, and weapons. Check it out.<br />
<br />
===2006-04-18 Expand and Exterminate .152 Released!===<br />
[http://tinyurl.com/pmrhf Get it here!]<br />
Completely original mod, not based on OTA!<br />
<br />
===2006-04-18 OTAI 1.13===<br />
Minor Changes and Bugfixes.<br />
[http://www.fileuniverse.com/?p=showitem&ID=2994 DLLs] [http://www.fileuniverse.com/?p=showitem&ID=2993 Source]<br />
<br />
===2006-04-17 AAI 0.63 released===<br />
Minor improvements but a lot of bugfixes :)<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=70404#70404 Look here].<br />
<br />
===2006-04-16 Xect vs. Mynn v0.6 released, 100% legal===<br />
[http://www.ta-spring.com/mods/xectvsmynn/ Get it here],<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3005&postdays=0&postorder=asc&start=80 discuss it here].<br />
<br />
===2006-04-15 XTA Pimped Edition V5.5===<br />
[http://tinyurl.com/p4mtc Read and Grab it here!]<br />
<br />
===2006-04-10 AAI 0.60 released===<br />
Experimental water support, linux support and a lot more... [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=4509 Look here]<br />
<br />
===2006-04-05 FF v1.15===<br />
New Version of Final Frontier [http://tinyurl.com/q3u3e Here]<br />
<br />
===2006-03-30 OTAI v1.12===<br />
With working command buffering [http://tinyurl.com/e8fuh Here]<br />
<br />
===2006-03-27 XTA Pimped Edition V5===<br />
[http://tinyurl.com/kr95f Grab it here].<br />
<br />
===2006-03-26 NTai XE7.5 Skirmish AI===<br />
[http://www.darkstars.co.uk/ Get it here]. - AF<br />
<br />
===NanoBlobs 0.31(beta)===<br />
Exponential game design. Updated. Smaller. Faster. Even cooler. Get it [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=4276 Here]<br />
<br />
===2006-03-06 OTAI 1.10===<br />
Now works in 0.70, fixed nanostall somewhat. Get it [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3412 Here]<br />
<br />
===2006-02-25 AAI 0.55===<br />
A rather small release mainly adding support for the modified ai interface [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3886 get it here].<br />
<br />
===2006-02-25 NTAI XE6 for 0.70b1 Skirmish AI===<br />
Universal mod support, statistical unit learning, freeform buildtrees [http://www.darkstars.co.uk/index.php Get them here]. - AF<br />
<br />
===2006-02-19 AAI 0.52===<br />
AAI 0.52 is only a small bugfix release [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3886 get it here].<br />
<br />
===2006-02-13 Absolute Annihilation 1.44===<br />
AA 1.44 completed and uploaded.[http://www.planetannihilation.com/aa AA Homepage].<br />
.<br />
[[SWTA]] [[Final_Frontier]] [[Absolute_Annihilation]]<br />
<br />
===2006-2-19 AAI 0.52 Released===<br />
AAI 0.52 is only a small bugfix release for AAI 0.5 - hopefully all crashes are gone now<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3886 click here].<br />
<br />
===2006-2-15 NTAI XE 3 Released===<br />
XE 3 has support map specific build data, 9 new keywords, StarWars/Gundam support, numerous fixes, and should run a lot faster ^^ [http://www.darkstars.co.uk/index.php here]. - AF<br />
<br />
===2006-02-13 Absolute Annihilation 1.44 Released===<br />
AA 1.44 completed and uploaded. Readme and changelog available at the [http://www.planetannihilation.com/aa AA Homepage].<br />
<br />
===2006-2-06 OTAI 1.08 Released===<br />
Now uses multithreading to reduce freezing!<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?p=55624#55624 Forum] [http://www.fileuniverse.com/?p=showitem&ID=2354 Download]<br />
<br />
===2006-02-01 World Domination 5B62 Released===<br />
This version fixes the crashes related to missing .cob-files.<br />
Download [http://www.fileuniverse.com/?p=showitem&ID=2311 here].<br />
<br />
===2006-1-31 Star Wars Spring Manual Released===<br />
[http://spring.clan-sy.com/wiki/SWTA_Manual Read the SWS Manual right now!] It contains everything you would ever want to know about SWS, including: Installation Guide, In-Depth Unit Guide as well as a Strategy & Tactics section.<br />
<br />
===2006-1-27 OTAI 1.07 Released===<br />
Veylon released OTAI version 1.07. Now builds Dragon's Teeth and crashes less!<br />
Download [http://www.geocities.com/veylon_ii/TASpring/ here].<br />
<br />
===2006-11-19 UpSpring Tutorial Released===<br />
Maestro R Setiawan released [http://tinyurl.com/cd25b a very comprehensive tutorial] to UpSpring, the application to import new models to Spring. Now you won't have any excuse to not use UV mapped S3O!<br />
<br />
===2006-01-16 NTAI 0.29a Released===<br />
NTAI 0.29a released, go get it here [http://taspring.clan-sy.com/phpbb/viewtopic.php?p=50716#50716 Download]<br />
<br />
===2006-01-16 Absolute Annihilation 1.42 Released===<br />
AA 1.42 completed and uploaded. Readme and changelog available at the [http://www.planetannihilation.com/aa AA Homepage].<br />
<br />
<b>[http://prdownloads.sourceforge.net/ta-aa/AASpring142.zip?download Download]</b> (9 mb)<br />
<br />
===2006-01-12 AAI 0.4 Released===<br />
AAI 0.4 now supports air units as well as construction units assisting others. <br />
Edit: Small Bugfix Version AAI 0.42 released<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3527 AAI v0.42].<br />
<br />
===2006-1-07 Gundam Annihilation 0.98.sd7 Released===<br />
This is a .sd7 for your spring lobby usage. I have corrected a few of the spring specific bugs in this release. Enjoy. [http://www.planetannihilation.com/gundam/ Gundam annihilation homepage]<br />
<br />
[http://www.planetannihilation.com/gundam/shots/screen039.jpg http://www.planetannihilation.com/gundam/shots/screen039_thumb.gif] [http://www.planetannihilation.com/gundam/shots/screen012.jpg http://www.planetannihilation.com/gundam/shots/screen012_thumb.gif]<br />
<br />
<br />
===2005-12-15 AAI 0.3 Released===<br />
AAI 0.3 includes a lot of bug fixes and placement of defence buildings. [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3195 AAI v0.3].<br />
<br />
===2005-12-14 Absolute Annihilation 1.35 Released===<br />
AA 1.35 completed and uploaded. Readme and changelog available at the [http://www.planetannihilation.com/aa AA Homepage].<br />
<br />
<b>[http://prdownloads.sourceforge.net/ta-aa/AASpring135.zip?download Download]</b> (16 mb)<br />
<br />
===2005-12-13 OTAI 1.03b Released===<br />
A fixed version of OTAI 1.03 now available.<br />
<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3184 Forum Thread]<br />
[http://www.geocities.com/veylon_ii/TASpring/OTAI_v103b.zip Download]<br />
<br />
===2005-12-13 The Lost Legacy v1.04 Released===<br />
The Lost Legacy Race, originally by M3G, ported to Spring by NOiZE.<br />
<br />
This is the TA:Spring version of the masterpiece race created by the TA creation veterans M3G and Nik. Striving for perfection, they have completed an astoundishing number of 150 new units. This is by far the most expanded and carefully balanced race that has been created to this point. Explore the strategic values of the new submarine pens, defensive constructions and the many supersized monsters that let you toy with the opponent.<br />
<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2860 Forum Thread]<br />
[http://www.fileuniverse.com/?p=showitem&ID=1967 Download]<br />
<br />
===2005-12-07 Star Wars: Spring 1.0 Released===<br />
The well known Star Wars TC for TA has been ported to Spring.<br />
<br />
One of the most complete TCs that existed for TA has now been fully ported to Spring - all of the bugs that plagued the quick and dirty earlier port have been fixed. Some balancing issues that came up in Spring has also been taken care of, along with a few other minor modifications, to ensure that this modification is made specifically for the Spring engine, so that you can enjoy it as such. Furthermore, many of the uglier low-polygon units for SWTA have been remodelled for Spring, so that you can now enjoy high-poly infantry units, as well as a few other vehecular changes.<br />
<br />
Feel free to come join us on our own chat channel (itself a good 5 years old), where you can organise games, discuss balance, and report bugs:<br />
<br />
Server: irc.gnug.org<br />
<br />
Channel: #SWTA<br />
<br />
An in-depth manual, with help regarding strategies and unit descriptions can be located [http://www.planetannihilation.com/swta/readme.asp here], however, bear in mind that while much of this will be very helpful, it was originally intended for the Original Total Annihilation release, and so is not 100% accurate or reliable with regards to the Spring release. A Spring-specific manual is in the works.<br />
<br />
SWS features around 130 units ranging from all six movies and the expanded universe for the Galactic Empire and Rebel Alliance. Join this galaxy spanning war today, download SWS!<br />
<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3166 Forum Thread]<br />
[http://www.fileuniverse.com/?p=showitem&ID=1988 Download]<br />
[http://www.planetannihilation.com/swta/ SWTA Homepage]<br />
<br />
===2005-12-07 The Lost Legacy v1.03 Released===<br />
The Lost Legacy Race, originally by M3G, ported to Spring by NOiZE.<br />
<br />
This is the TA:Spring version of the masterpiece race created by the TA creation veterans M3G and Nik. Striving for perfection, they have completed an astoundishing number of 150 new units. This is by far the most expanded and carefully balanced race that has been created to this point. Explore the strategic values of the new submarine pens, defensive constructions and the many supersized monsters that let you toy with the opponent.<br />
<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2860 Forum Thread]<br />
[http://www.fileuniverse.com/?p=showitem&ID=1967 Download]<br />
<br />
===2005-12-05 NTAI 0.28.10+ installer FIXED)===<br />
Counter attacking, and numrous fixes, modifications. All who've downlaoded it redownload as I made a terrible mistake copying the wrong files over. - Alantai<br />
<br />
[http://www.fileuniverse.com/?p=showitem&ID=1950 Download Installer]<br />
[http://img479.imageshack.us/img479/8186/screen0121oq.jpg Screenshot]<br />
<br />
===2005-12-01 NTAI 0.28Beta 7 Released===<br />
Working Attack code, vastly improved building, Xect, Rhyoss, Mynn, TLL, XTA and AA support. - Alantai<br />
<br />
[http://www.fileuniverse.com/?p=showitem&ID=1909 Download]<br />
[http://img479.imageshack.us/img479/8186/screen0121oq.jpg Screenshot]<br />
<br />
===2005-12-01 OTAI for 0.67 Released===<br />
Veylons latest installment of OTAI, with a slew of improovements.<br />
[http://www.geocities.com/veylon_ii/TASpring/OTAI_v102.zip Downlaod]<br />
<br />
===2005-11-11 Cursor groupAI Released===<br />
Show Allies what untis you have selected and where your mouse cursor is.<br />
<br />
[http://www.fileuniverse.com/?p=showitem&ID=1873 Link]<br />
[http://img479.imageshack.us/img479/8186/screen0121oq.jpg Screenshot]<br />
<br />
(This is a new version from beta 6.5 released yesterday)<br />
<br />
===2005-11-12 NTAI 028BETA 7.1 Released===<br />
Full ARM + TLL support, and improved attacking.<br />
<br />
[http://www.fileuniverse.com/?p=showitem&ID=1887 Linky]<br />
[http://www.fileuniverse.com/?p=showimage&ID=1755 Screenshot]<br />
<br />
(This is a new version from beta 6.5 released yesterday)<br />
<br />
===2005-11-12 - NTAI 0.27 Released===<br />
Water map support, krogoths, vehicles, aircraft, and more!<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2829 Details]<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2827 Screenshots]<br />
<br />
===2005-10-29 - NTAI 0.25 Released===<br />
The latest version of NTAI released today with many new abilities, such as a greatly improved attack system, and the ability to scout.<br />
<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2687 Forum Thread]<br />
<br />
===2005-10-20 - Absolute Annihilation: Spring Released===<br />
The highly popular OTA mod, Absolute Annihilation, has now been fully converted for compatibility with Spring. Unlike the original Spring version released some months ago, the new version is fully compatible with the mod switching system. It also features many visual and strategic enhancements only possible in Spring, and uses the latest version of the AA dataset, 6.0.<br />
<br />
Already a new version is available, 1.25, which corrects several major bugs.<br />
<br />
[http://files.filefront.com/AASpring125zip/;4417183;;/fileinfo.html Direct Download (1.25)]<br />
<br />
[http://prdownloads.sourceforge.net/ta-aa/AATrailer.zip?download Mod Trailer]<br />
<br />
[http://www.planetannihilation.com/aa AA Homepage]<br />
<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2633 Forum Thread]<br />
<br />
===2005-10-16 - KuroTA v0.45 Released===<br />
This is the second public release of this fairly popular mod. It all started out as a bunch of custom units in a TA installation from years gone by, but thanks to dedication it's been turned into a playable and fairly balanced mod for everyone to play on Spring. For more info at [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2514 read this thread]. And it can be downloaded from [http://www.fileuniverse.com/?p=showitem&ID=1646 FileUniverse].<br />
<br />
===2005-10-15 - UberHack, SpringVersion1.3 Released===<br />
This port of the famous balance mod for TA, done by NOiZE, has been made as good as bug free now. This mod would not have been possible without help from: zwzsg, Gnome and Kuroneko. For more info at [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2540 read this thread]. And it can be downloaded from [http://www.fileuniverse.com/?p=showitem&ID=1633 FileUniverse].<br />
<br />
===2005-10-12 - Maelstroms SMD Creator===<br />
[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2420 Maelstroms SMD Creator] has been relesed, to help people create SMD Map files with an easy to use GUI.<br />
<br />
===2005-10-11 - JCAI 0.20 Released===<br />
[http://spring.clan-sy.com/phpbb/viewtopic.php?p=33275#33275 JCAI 0.20 skirmish AI] is released for Spring 0.64b1 with a modified spring exe, it is much more stable now. JCAI 0.20 is included in current release (0.65b1)<br />
<br />
===2005-09-28 - UberHack, SpringVersion1.2 Released===<br />
This port of the famous balance mod for TA, done by NOiZE, has been made as good as bug free now. This mod would not have been possible without help from: zwzsg, Gnome and Kuroneko. For more info at [http://spring.clan-sy.com/phpbb/viewtopic.php?t=2364 read this thread]. And it can be downloaded from [http://www.fileuniverse.com/?p=showitem&ID=1552 FileUniverse].<br />
<br />
===2005-08-20 - wiki Button Added===<br />
As you probably already have noticed, the SY's have added a wiki button (Made by aGorm) to the Navigation bar. Hopefully, this will make people more aware of the wiki, as some have never even heard of it! More info on [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=1917 this thread]. If you don't see the wiki button, empty the cache of your browser and refresh.<br />
<br />
===2005-08-16 - JCAI Released===<br />
Zaphod has released alpha 1 of his skirmish AI JCAI for spring,[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=1920 see forum post]<br />
TAI code has been released but doesnt work. [http://www.fileuniverse.com/?p=showitem&ID=1322 Get it here]<br />
<br />
===2005-08-03 - Mods and Maps===<br />
zwzsg made a 3.6MB mod package with: OTA balance, Evolva models, UTASP Buildpics. Install and use easy thanks to the new mod switcher introduced in Spring 0.60b1.<br />
<br>- [http://spring.clan-sy.com/phpbb/viewtopic.php?t=1843 More info and discussion]<br />
<br>- [http://www.fileuniverse.com/?p=showitem&ID=1257 Download link]<br />
<br />
[http://zwzsg.hosted.luckz.de/img/spring/Azure%20Rampart%20-%20evnbp%20-%20Bomber.png http://www.fileuniverse.com/images/Azure%20Rampart%20-%20evnbp%20-%20Bomber.jpg-thumb.png][http://www.fileuniverse.com/images/Ahspen%20-%20evnbp%20-%20Tanks%20Tracks.jpg http://www.fileuniverse.com/images/Ahspen%20-%20evnbp%20-%20Tanks%20Tracks.jpg-thumb.png][http://www.fileuniverse.com/images/RedHaven%20-%20evnbp%20-%20Core.jpg http://www.fileuniverse.com/images/RedHaven%20-%20evnbp%20-%20Core.jpg-thumb.png][http://www.fileuniverse.com/images/causticscreenshot.jpg http://www.fileuniverse.com/images/causticscreenshot.jpg-thumb.png]<br />
<br />
Spring 0.60b1 made all previous maps obsolete, but as the pictures above show, there's a steadily increasing [http://www.fileuniverse.com/?p=listing&ID=121 choice of new maps], either old ones converted to the new format or brand new.</div>LordMatt