Spring - User contributions [en]

Linux

2006-08-15T10:56:44Z

Pheldens: /* Running Spring via wine */

Spring is running on Linux''!''
But it's not ready for a release, networking and sound need love for example.

To compile spring yourself, refer to the [[SetupGuide]].

The [[LinuxReleaseRoadmap| Linux release Roadmap]] is useful if you want to know how you can help.
The Linux porting effort is underway at BerliOS. 
http://developer.berlios.de/projects/taspring-linux/ 
The linux port wiki startpoint is: http://taspring.clan-sy.com/wiki/MultiplatformSpring
The old linux port wiki (which may or may not work at the moment) was: http://taspring-linux.berlios.de/wikka.php?wakka=HomePage 
The old location for Linux development was https://opensvn.csie.org/traccgi/taspring_linux/trac.cgi/wiki 

The Linux porting mailinglist can be found at http://lolut.utbm.info/cgi-bin/mailman/listinfo/taspring-linux a move to the mailinglist provided by BerliOS is posible in the (near) future.

[[Image:Screen1.jpg|center]]
The first sceenshot of Spring running on Linux.

=Running Spring via wine=

Even though a native Linux port of Spring is progressing well you can play Spring on Linux using [http://winehq.org/ Wine]:

'''''This is unconfirmed, if it's not working please figure it out and update this wiki page!''''' 
And if you had success with these guidelines please let us know.

'''1 - You'll need, of course, Wine installed.''' 
Just use the version included with your distribution. 
You can compile from source but that is generally unnecessary.

'''2 - Be sure to have 3D hardware acceleration enabled.''' 
Spring is a fully 3D accelerated game and will require this. Confirmed to work stable with [http://dri.freedesktop.org/wiki/R300_20Application r300 open driver] (Mesa 6.5.1).
You can also install the nVidia/Ati commercial drivers. Obtain the package for your distribution. If you're having problems installing these, you'll also probably find better help at their websites.
The Spring forums are not really for general linux help, so refer to your distribution's forums - if they have any.

To know if you have 3D acceleration working, you can execute the following command:
glxinfo
If it shows the line:
direct rendering: yes
You probably have it working.

'''3 - Install Spring or use an already installed Spring in Windows.''' 
* If you already have Spring installed in Windows, make sure that partition is accessible in Linux, and using a terminal window change directory (cd) into that directory and execute:
wine TASClient.exe
* If you don't have Spring installed yet, install it by executing the following command in a terminal window where the installer file is located:
wine taspring_0.72b1.exe
(or whatever else the installer might be called)
Then, change directory to where you installed it to, generally:
cd ~/.wine/drive_c/Program\ Files/TASpring
(the command line only accepts " " spaces in paths if they have an "\" before, like: cd Program\ Files)
And, similarly, execute:
wine TASClient.exe

Suse Linux 9.3 installs Wine by default and had the option, through the YOU auto-updating tool, to automatically install the commercial drivers. If your distribution also has such options, it can save you much work.

It should be noted that in the multiplatform code releases of Spring (0.7x) you may need to run Spring in full-screen mode or the mouse will not scroll the world when you push against the edges of the screen. Only Spring needs to run in full-screen mode; the other programs do not. You can have wine emulate a virtual desktop and run Spring in full-screen mode inside that.

[[Category:Source development]]

[[Category:Linux Port]]

Linux

2006-08-15T10:53:15Z

Pheldens: /* Running Spring via wine */

Spring is running on Linux''!''
But it's not ready for a release, networking and sound need love for example.

To compile spring yourself, refer to the [[SetupGuide]].

The [[LinuxReleaseRoadmap| Linux release Roadmap]] is useful if you want to know how you can help.
The Linux porting effort is underway at BerliOS. 
http://developer.berlios.de/projects/taspring-linux/ 
The linux port wiki startpoint is: http://taspring.clan-sy.com/wiki/MultiplatformSpring
The old linux port wiki (which may or may not work at the moment) was: http://taspring-linux.berlios.de/wikka.php?wakka=HomePage 
The old location for Linux development was https://opensvn.csie.org/traccgi/taspring_linux/trac.cgi/wiki 

The Linux porting mailinglist can be found at http://lolut.utbm.info/cgi-bin/mailman/listinfo/taspring-linux a move to the mailinglist provided by BerliOS is posible in the (near) future.

[[Image:Screen1.jpg|center]]
The first sceenshot of Spring running on Linux.

=Running Spring via wine=

Even though a native Linux port of Spring is progressing well you can play Spring on Linux using [http://winehq.org/ Wine]:

'''''This is unconfirmed, if it's not working please figure it out and update this wiki page!''''' 
And if you had success with these guidelines please let us know.

'''1 - You'll need, of course, Wine installed.''' 
Just use the version included with your distribution. 
You can compile from source but that is generally unnecessary.

'''2 - Be sure to have 3D hardware acceleration enabled.''' 
Spring is a fully 3D accelerated game and will require this. This usually means you have to install the nVidia/Ati commercial drivers. Confirmed to work stable with [http://dri.freedesktop.org/wiki/R300_20Application r300 open driver] (Mesa 6.5.1).
Install the package from you distribution.
If you're having problems installing these, you'll also probably find better help at their web sites.
The Spring forums are not really for general linux help, so refer to your distribution's forums - if they have any.

To know if you have 3D acceleration working, you can execute the following command:
glxinfo
If it shows the line:
direct rendering: yes
You probably have it working.

'''3 - Install Spring or use an already installed Spring in Windows.''' 
* If you already have Spring installed in Windows, make sure that partition is accessible in Linux, and using a terminal window change directory (cd) into that directory and execute:
wine TASClient.exe
* If you don't have Spring installed yet, install it by executing the following command in a terminal window where the installer file is located:
wine taspring_0.72b1.exe
(or whatever else the installer might be called)
Then, change directory to where you installed it to, generally:
cd ~/.wine/drive_c/Program\ Files/TASpring
(the command line only accepts " " spaces in paths if they have an "\" before, like: cd Program\ Files)
And, similarly, execute:
wine TASClient.exe

Suse Linux 9.3 installs Wine by default and had the option, through the YOU auto-updating tool, to automatically install the commercial drivers. If your distribution also has such options, it can save you much work.

It should be noted that in the multiplatform code releases of Spring (0.7x) you may need to run Spring in full-screen mode or the mouse will not scroll the world when you push against the edges of the screen. Only Spring needs to run in full-screen mode; the other programs do not. You can have wine emulate a virtual desktop and run Spring in full-screen mode inside that.

[[Category:Source development]]

[[Category:Linux Port]]

Linux

2006-08-15T10:52:25Z

Pheldens: /* Running Spring via wine */

Spring is running on Linux''!''
But it's not ready for a release, networking and sound need love for example.

To compile spring yourself, refer to the [[SetupGuide]].

The [[LinuxReleaseRoadmap| Linux release Roadmap]] is useful if you want to know how you can help.
The Linux porting effort is underway at BerliOS. 
http://developer.berlios.de/projects/taspring-linux/ 
The linux port wiki startpoint is: http://taspring.clan-sy.com/wiki/MultiplatformSpring
The old linux port wiki (which may or may not work at the moment) was: http://taspring-linux.berlios.de/wikka.php?wakka=HomePage 
The old location for Linux development was https://opensvn.csie.org/traccgi/taspring_linux/trac.cgi/wiki 

The Linux porting mailinglist can be found at http://lolut.utbm.info/cgi-bin/mailman/listinfo/taspring-linux a move to the mailinglist provided by BerliOS is posible in the (near) future.

[[Image:Screen1.jpg|center]]
The first sceenshot of Spring running on Linux.

=Running Spring via wine=

Even though a native Linux port of Spring is progressing well you can play Spring on Linux using [http://winehq.org/ Wine]:

'''''This is unconfirmed, if it's not working please figure it out and update this wiki page!''''' 
And if you had success with these guidelines please let us know.

'''1 - You'll need, of course, Wine installed.''' 
Just use the version included with your distribution. 
You can compile from source but that is generally unnecessary.

'''2 - Be sure to have 3D hardware acceleration enabled.''' 
Spring is a fully 3D accelerated game and will require this. This usually means you have to install the nVidia/Ati commercial drivers. Confirmed to work stable with [ link r300 open driver] (Mesa 6.5.1).
Install the package from you distribution.
If you're having problems installing these, you'll also probably find better help at their web sites.
The Spring forums are not really for general linux help, so refer to your distribution's forums - if they have any.

To know if you have 3D acceleration working, you can execute the following command:
glxinfo
If it shows the line:
direct rendering: yes
You probably have it working.

'''3 - Install Spring or use an already installed Spring in Windows.''' 
* If you already have Spring installed in Windows, make sure that partition is accessible in Linux, and using a terminal window change directory (cd) into that directory and execute:
wine TASClient.exe
* If you don't have Spring installed yet, install it by executing the following command in a terminal window where the installer file is located:
wine taspring_0.72b1.exe
(or whatever else the installer might be called)
Then, change directory to where you installed it to, generally:
cd ~/.wine/drive_c/Program\ Files/TASpring
(the command line only accepts " " spaces in paths if they have an "\" before, like: cd Program\ Files)
And, similarly, execute:
wine TASClient.exe

Suse Linux 9.3 installs Wine by default and had the option, through the YOU auto-updating tool, to automatically install the commercial drivers. If your distribution also has such options, it can save you much work.

It should be noted that in the multiplatform code releases of Spring (0.7x) you may need to run Spring in full-screen mode or the mouse will not scroll the world when you push against the edges of the screen. Only Spring needs to run in full-screen mode; the other programs do not. You can have wine emulate a virtual desktop and run Spring in full-screen mode inside that.

[[Category:Source development]]

[[Category:Linux Port]]

Strategy and Tactics

2006-08-14T05:52:09Z

Pheldens: /* Common Strategies */

{|border="0" cellpadding="4" cellspacing="10" width="100%"
|width="100%" valign="top" style="background: #e6e6fa; border: 1px #aaa solid;"|
Strategy and tactics are best described as "concepts on how to win". Strategy is a chosen global way of action, while tactics are short-term actions to attain specific goals (i. e. takeover of a choke point, destruction of frontline defense, crippling economy etc.)
|}

{|border="0" cellpadding="4" cellspacing="10" width="100%"
|width="33%" valign="top" style="background: #e6e6fa; border: 1px #aaa solid;"|
===Common Strategies===
'''[[Rushing]]''' - (early rush) 
'''[[Porcing]]''' - (fortress building) 
'''[[Map Control]]''' 
'''[[Uberweapon]]''' 
'''[[Expansion]]''' 

|width="33%" valign="top" style="background: #e6e6fa; border: 1px #aaa solid;"|

===Common tactics===
'''[[Commander bombing]]''' 
'''[[Commander kidnapping]]''' 
'''[[Raiding]]''' 
'''[[Swarming]]''' 
'''[[Nuke strike]]''' 
'''[[Chokepoint]]''' 
'''[[Teching]]''' 
'''[[Defensive Lines]]''' 
'''[[Transports and setting up supply Lines]]''' 
'''[[Dedicated Spamming]]''' 
'''[[Classic Pincer]]''' 
'''[[Air Domination]]''' 
|width="33%" valign="top" style="background: #e6e6fa; border: 1px #aaa solid;"|

===Tips and Other===
'''[[Spring guide!]]''' 
'''[[Base building tips]]''' 
'''[[Spring for RTS Players]]''' 
'''[[Spring Replays]]''' 
'''[[Mods, and their strategies/tactics]]''' 
'''[[Advanced Strategy Discussion]]''' 
'''[[Resources]]''' 
'''[[Theory On Strategy]]''' 
'''[[Aggressive Vs. Passive Strategy]]'''
|}

Return to [[Main Page]]

[[Category:Playing]]
[[category:Strategy]]

Strategy and Tactics

2006-08-14T05:50:43Z

Pheldens: /* Common Strategies */

{|border="0" cellpadding="4" cellspacing="10" width="100%"
|width="100%" valign="top" style="background: #e6e6fa; border: 1px #aaa solid;"|
Strategy and tactics are best described as "concepts on how to win". Strategy is a chosen global way of action, while tactics are short-term actions to attain specific goals (i. e. takeover of a choke point, destruction of frontline defense, crippling economy etc.)
|}

{|border="0" cellpadding="4" cellspacing="10" width="100%"
|width="33%" valign="top" style="background: #e6e6fa; border: 1px #aaa solid;"|
===Common Strategies===
'''[[Rushing]]''' - (early rush) 
'''[[Porcing]]''' - (fortress building) 
'''[[Map Control]]''' 
'''[[ÃƒÅ“berweapon]]''' 
'''[[Expansion]]''' 

|width="33%" valign="top" style="background: #e6e6fa; border: 1px #aaa solid;"|

===Common tactics===
'''[[Commander bombing]]''' 
'''[[Commander kidnapping]]''' 
'''[[Raiding]]''' 
'''[[Swarming]]''' 
'''[[Nuke strike]]''' 
'''[[Chokepoint]]''' 
'''[[Teching]]''' 
'''[[Defensive Lines]]''' 
'''[[Transports and setting up supply Lines]]''' 
'''[[Dedicated Spamming]]''' 
'''[[Classic Pincer]]''' 
'''[[Air Domination]]''' 
|width="33%" valign="top" style="background: #e6e6fa; border: 1px #aaa solid;"|

===Tips and Other===
'''[[Spring guide!]]''' 
'''[[Base building tips]]''' 
'''[[Spring for RTS Players]]''' 
'''[[Spring Replays]]''' 
'''[[Mods, and their strategies/tactics]]''' 
'''[[Advanced Strategy Discussion]]''' 
'''[[Resources]]''' 
'''[[Theory On Strategy]]''' 
'''[[Aggressive Vs. Passive Strategy]]'''
|}

Return to [[Main Page]]

[[Category:Playing]]
[[category:Strategy]]

SetupGuide

2006-08-12T09:58:29Z

Pheldens: /* Linux Setup Guide */

== Linux Setup Guide ==
* If you're running [http://www.gentoo.org Gentoo linux], you're lucky, because [http://developer.berlios.de/project/showfiles.php?group_id=4358 an ebuild is already available]. If not, a short walk-trough to compile, run and debug spring on provided below.

* In short, to get spring compiled under linux, make sure you've got all necessary development packages installed. On [http://www.ubuntu.com/ (K)Ubuntu linux], and maybe [http://www.debian.org/ Debian] too, this can be done by copying the following in a root terminal (or use the graphical package manager Synaptic or Adept if you can't stand commandline): <code>apt-get install build-essential subversion scons libsdl-dev libopenal-dev libglew-dev libboost-dev libboost-thread-dev libboost-filesystem-dev libboost-regex-dev libdevil-dev libfreetype6-dev python2.4-dev</code> For any other distribution, grab these libraries and the base development packages too (for Gentoo, base development packages aren't needed, because everything is compiled from source: they're already installed). I've no clue about RPM based distros. But [http://www.google.com google] is your friend.

* Grab the latest work-in-progress sourcecode from subversion (using commandline SVN): <code>svn co https://taspring.clan-sy.com/svn/spring/trunk</code> Or look in https://taspring.clan-sy.com/svn/spring/tags/ for the last official release.

* To compile the sourcecode, switch to the trunk directory created by the svn checkout in the previous step. Then type: <code>scons configure</code> to configure the build. (You can fine tune the build by passing options to this command [for enabling debugging/optimizing etc.]. Type <code>scons --help</code> to view the available options.) Now, if you really installed all development package, the scons configure will output: "Everything seems OK. Run `scons' now to build.". If it outputs with an error you're probably missing a development package.

* As instructed on end of previous step, type: <code>scons</code> Spring will now build including [[NTAI]], [[JCAI]] and a few [[GroupAI]]s. You should end up with a file <code>trunk/game/spring</code> (the executable) and some shared objects (SOs or DLLs) in <code>trunk/game/aidll</code>

* Now, grab [https://developer.berlios.de/project/showfiles.php?group_id=4358 the linux data tarball] and extract it somewhere. This will create a directory taspring-linux-data-0.71b1 (or higher version number).

* Put a symlink to the spring executable in the data directory: <code>ln -s /path/to/trunk/game/spring /path/to/taspring-linux-data-0.71b1/spring</code>

* Optionally, make symlinks for the shared objects in <code>trunk/game/aidll too</code>.

* Now run spring by <code>cd</code>'ing (change dir) to the <code>taspring-linux-data-0.71b1</code> directory and typing: <code>./spring</code> If you've compiled with debugging enabled, you might want to run inside gdb to provide the devs with a backtrace if spring crashes: <code>gdb ./spring</code>
** Basic commands inside gdb are:
*** <code>'''r'''un</code> - Run the program (spring)
*** <code>'''bt'''</code> - Print a backtrace
*** <code>'''q'''uit</code> - Quit
*** <code>'''help'''</code> - This one's important

* Be happy!

Tips:

* Checkout [http://www.fileuniverse.com File Universe] for much more maps & mods.
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.
* A binary release of [[AAI]], a skirmish AI, is included in the data package.
* Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo)

<code>
(define devices '(alsa)) 
(define speaker-num 2) 
(define alsa-out-device "hw:0,0") 
(define alsa-in-device "hw:0,0") 
</code>
Adventurous people with an emu10k1 based card (sblive) can try the accelerated openal version. http://www.lost.org.uk/openal.html , don't submit audiobugs if you do.

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

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

SetupGuide

2006-08-12T09:27:23Z

Pheldens: /* Linux Setup Guide */

== Linux Setup Guide ==
* If you're running [http://www.gentoo.org Gentoo linux], you're lucky, because [http://developer.berlios.de/project/showfiles.php?group_id=4358 an ebuild is already available]. If not, a short walk-trough to compile, run and debug spring on provided below.

* In short, to get spring compiled under linux, make sure you've got all necessary development packages installed. On [http://www.ubuntu.com/ (K)Ubuntu linux], and maybe [http://www.debian.org/ Debian] too, this can be done by copying the following in a root terminal (or use the graphical package manager Synaptic or Adept if you can't stand commandline): <code>apt-get install build-essential subversion scons libsdl-dev libopenal-dev libglew-dev libboost-dev libboost-thread-dev libboost-filesystem-dev libboost-regex-dev libdevil-dev libfreetype6-dev python2.4-dev</code> For any other distribution, grab these libraries and the base development packages too (for Gentoo, base development packages aren't needed, because everything is compiled from source: they're already installed). I've no clue about RPM based distros. But [http://www.google.com google] is your friend.

* Grab the latest work-in-progress sourcecode from subversion (using commandline SVN): <code>svn co https://taspring.clan-sy.com/svn/spring/trunk</code> Or look in https://taspring.clan-sy.com/svn/spring/tags/ for the last official release.

* To compile the sourcecode, switch to the trunk directory created by the svn checkout in the previous step. Then type: <code>scons configure</code> to configure the build. (You can fine tune the build by passing options to this command [for enabling debugging/optimizing etc.]. Type <code>scons --help</code> to view the available options.) Now, if you really installed all development package, the scons configure will output: "Everything seems OK. Run `scons' now to build.". If it outputs with an error you're probably missing a development package.

* As instructed on end of previous step, type: <code>scons</code> Spring will now build including [[NTAI]], [[JCAI]] and a few [[GroupAI]]s. You should end up with a file <code>trunk/game/spring</code> (the executable) and some shared objects (SOs or DLLs) in <code>trunk/game/aidll</code>

* Now, grab [https://developer.berlios.de/project/showfiles.php?group_id=4358 the linux data tarball] and extract it somewhere. This will create a directory taspring-linux-data-0.71b1 (or higher version number).

* Put a symlink to the spring executable in the data directory: <code>ln -s /path/to/trunk/game/spring /path/to/taspring-linux-data-0.71b1/spring</code>

* Optionally, make symlinks for the shared objects in <code>trunk/game/aidll too</code>.

* Now run spring by <code>cd</code>'ing (change dir) to the <code>taspring-linux-data-0.71b1</code> directory and typing: <code>./spring</code> If you've compiled with debugging enabled, you might want to run inside gdb to provide the devs with a backtrace if spring crashes: <code>gdb ./spring</code>
** Basic commands inside gdb are:
*** <code>'''r'''un</code> - Run the program (spring)
*** <code>'''bt'''</code> - Print a backtrace
*** <code>'''q'''uit</code> - Quit
*** <code>'''help'''</code> - This one's important

* Be happy!

Tips:

* Checkout [http://www.fileuniverse.com File Universe] for much more maps & mods.
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.
* A binary release of [[AAI]], a skirmish AI, is included in the data package.
* Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo)

<code>
(define devices '(alsa)) 
(define speaker-num 2) 
(define alsa-out-device "hw:0,0") 
(define alsa-in-device "hw:0,0") 
</code>

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

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

SetupGuide

2006-08-12T09:26:14Z

Pheldens: /* Linux Setup Guide */

== Linux Setup Guide ==
* If you're running [http://www.gentoo.org Gentoo linux], you're lucky, because [http://developer.berlios.de/project/showfiles.php?group_id=4358 an ebuild is already available]. If not, a short walk-trough to compile, run and debug spring on provided below.

* In short, to get spring compiled under linux, make sure you've got all necessary development packages installed. On [http://www.ubuntu.com/ (K)Ubuntu linux], and maybe [http://www.debian.org/ Debian] too, this can be done by copying the following in a root terminal (or use the graphical package manager Synaptic or Adept if you can't stand commandline): <code>apt-get install build-essential subversion scons libsdl-dev libopenal-dev libglew-dev libboost-dev libboost-thread-dev libboost-filesystem-dev libboost-regex-dev libdevil-dev libfreetype6-dev python2.4-dev</code> For any other distribution, grab these libraries and the base development packages too (for Gentoo, base development packages aren't needed, because everything is compiled from source: they're already installed). I've no clue about RPM based distros. But [http://www.google.com google] is your friend.

* Grab the latest work-in-progress sourcecode from subversion (using commandline SVN): <code>svn co https://taspring.clan-sy.com/svn/spring/trunk</code> Or look in https://taspring.clan-sy.com/svn/spring/tags/ for the last official release.

* To compile the sourcecode, switch to the trunk directory created by the svn checkout in the previous step. Then type: <code>scons configure</code> to configure the build. (You can fine tune the build by passing options to this command [for enabling debugging/optimizing etc.]. Type <code>scons --help</code> to view the available options.) Now, if you really installed all development package, the scons configure will output: "Everything seems OK. Run `scons' now to build.". If it outputs with an error you're probably missing a development package.

* As instructed on end of previous step, type: <code>scons</code> Spring will now build including [[NTAI]], [[JCAI]] and a few [[GroupAI]]s. You should end up with a file <code>trunk/game/spring</code> (the executable) and some shared objects (SOs or DLLs) in <code>trunk/game/aidll</code>

* Now, grab [https://developer.berlios.de/project/showfiles.php?group_id=4358 the linux data tarball] and extract it somewhere. This will create a directory taspring-linux-data-0.71b1 (or higher version number).

* Put a symlink to the spring executable in the data directory: <code>ln -s /path/to/trunk/game/spring /path/to/taspring-linux-data-0.71b1/spring</code>

* Optionally, make symlinks for the shared objects in <code>trunk/game/aidll too</code>.

* Now run spring by <code>cd</code>'ing (change dir) to the <code>taspring-linux-data-0.71b1</code> directory and typing: <code>./spring</code> If you've compiled with debugging enabled, you might want to run inside gdb to provide the devs with a backtrace if spring crashes: <code>gdb ./spring</code>
** Basic commands inside gdb are:
*** <code>'''r'''un</code> - Run the program (spring)
*** <code>'''bt'''</code> - Print a backtrace
*** <code>'''q'''uit</code> - Quit
*** <code>'''help'''</code> - This one's important

* Be happy!

Tips:

* Checkout [http://www.fileuniverse.com File Universe] for much more maps & mods.
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.
* A binary release of [[AAI]], a skirmish AI, is included in the data package.
* Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo)
<code>
(define devices '(alsa)) 
(define speaker-num 2) 
(define alsa-out-device "hw:0,0") 
(define alsa-in-device "hw:0,0") 
(define oss-out-device "hw:0,0") 
(define oss-in-device "hw:0,0")
</code>

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

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

SetupGuide

2006-08-12T09:25:23Z

Pheldens: /* Linux Setup Guide */

== Linux Setup Guide ==
* If you're running [http://www.gentoo.org Gentoo linux], you're lucky, because [http://developer.berlios.de/project/showfiles.php?group_id=4358 an ebuild is already available]. If not, a short walk-trough to compile, run and debug spring on provided below.

* In short, to get spring compiled under linux, make sure you've got all necessary development packages installed. On [http://www.ubuntu.com/ (K)Ubuntu linux], and maybe [http://www.debian.org/ Debian] too, this can be done by copying the following in a root terminal (or use the graphical package manager Synaptic or Adept if you can't stand commandline): <code>apt-get install build-essential subversion scons libsdl-dev libopenal-dev libglew-dev libboost-dev libboost-thread-dev libboost-filesystem-dev libboost-regex-dev libdevil-dev libfreetype6-dev python2.4-dev</code> For any other distribution, grab these libraries and the base development packages too (for Gentoo, base development packages aren't needed, because everything is compiled from source: they're already installed). I've no clue about RPM based distros. But [http://www.google.com google] is your friend.

* Grab the latest work-in-progress sourcecode from subversion (using commandline SVN): <code>svn co https://taspring.clan-sy.com/svn/spring/trunk</code> Or look in https://taspring.clan-sy.com/svn/spring/tags/ for the last official release.

* To compile the sourcecode, switch to the trunk directory created by the svn checkout in the previous step. Then type: <code>scons configure</code> to configure the build. (You can fine tune the build by passing options to this command [for enabling debugging/optimizing etc.]. Type <code>scons --help</code> to view the available options.) Now, if you really installed all development package, the scons configure will output: "Everything seems OK. Run `scons' now to build.". If it outputs with an error you're probably missing a development package.

* As instructed on end of previous step, type: <code>scons</code> Spring will now build including [[NTAI]], [[JCAI]] and a few [[GroupAI]]s. You should end up with a file <code>trunk/game/spring</code> (the executable) and some shared objects (SOs or DLLs) in <code>trunk/game/aidll</code>

* Now, grab [https://developer.berlios.de/project/showfiles.php?group_id=4358 the linux data tarball] and extract it somewhere. This will create a directory taspring-linux-data-0.71b1 (or higher version number).

* Put a symlink to the spring executable in the data directory: <code>ln -s /path/to/trunk/game/spring /path/to/taspring-linux-data-0.71b1/spring</code>

* Optionally, make symlinks for the shared objects in <code>trunk/game/aidll too</code>.

* Now run spring by <code>cd</code>'ing (change dir) to the <code>taspring-linux-data-0.71b1</code> directory and typing: <code>./spring</code> If you've compiled with debugging enabled, you might want to run inside gdb to provide the devs with a backtrace if spring crashes: <code>gdb ./spring</code>
** Basic commands inside gdb are:
*** <code>'''r'''un</code> - Run the program (spring)
*** <code>'''bt'''</code> - Print a backtrace
*** <code>'''q'''uit</code> - Quit
*** <code>'''help'''</code> - This one's important

* Be happy!

Tips:

* Checkout [http://www.fileuniverse.com File Universe] for much more maps & mods.
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.
* A binary release of [[AAI]], a skirmish AI, is included in the data package.
* Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo)
<code>
(define devices '(alsa))
(define speaker-num 2)
(define alsa-out-device "hw:0,0")
(define alsa-in-device "hw:0,0")
(define oss-out-device "hw:0,0")
(define oss-in-device "hw:0,0")
</code>

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

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