HOWTO: TA Spring Linux SVN Startup
Posted: 09 Aug 2006, 05:25
I'm going to shamelessly rip off the Ubuntu forums with the howto syntax. This is intended to be a simple, step-by-step guide to get spring downloaded, installed, and running on linux USING SVN. Deb-spring still offers a simpler solution for debian-ish users, but this is for those who want to put things together themselves. I've been meaning to put this together for a while now.
This guide is primarily based off of the wiki setup guide (http://spring.clan-sy.com/wiki/SetupGuide) but I takes a slightly different path in the locations of files and use of links. There really isn't a right or wrong to that part...
0. Get what you need
These are the packages you must first download with your package manager of choice:
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
May vary from distro to distro. You'll know very quickly if you've missed something, so don't fret.
1. Get the source code
Using subversion, you can check out a branch of the latest stable ("tagged") build, currently 0.74b3.
Create a new directory for source files
Check out, using subversion, the tagged branch
2. Build the source
Enter the new directory and use scons (an alternative to make) to build the game.
The scons configure step should end by telling you everything looks OK. If it fails, find the library it complains about and make sure you have installed the corresponding '-dev' package in step 0.
3. Put the game in its own place
This is where things start getting optional, somebody please let me know if it is unpleasant or wrong.
Create a directory for the program. I chose a hidden home directory, you don't have to. Copy the contents of the 'game' folder into this location.
4. Get Linux Data
Additional data required to correctly run in linux can be found here: http://prdownload.berlios.de/taspring-l ... b1.tar.bz2
Download the archive and extract the contents to the same location. It should be okay to overwrite files (can somebody confirm this? It's done me no harm and makes things very simple).
5. Symbolic links are your friend
To make things easy, you can make a symbolic link to your usr/bin directory that points to your new spring executable so that calling "spring" from a command prompt starts the program.
NOTE: YOU MAY NEED ROOT ACCESS FOR THIS. Debian users can probably use sudo, others may want to su.
5a. Tell spring where spring is
Spring looks in a few places to find out where the data directory (called the datadir) is located. So, let's inform it by placing the path into a setting file in /etc...
6. Run, Spring, Run!
If all goes well, it should bring up a simple in-game menu. I recommend running the Air Combat Test on SmallDivide with XTAPE, although you have little choice at this point. Watch some planes blow each other up.
7. Get more stuff!
Check out the following places for maps and other content
http://www.ta-spring.com/maps
http://www.unknown-files.net
Also search around the forums for more content like mods and AI's.
Keep in mind that this guide refers you to how to install the tagged 0.73b1 release. If you want to be on the bleeding edge, you can replace step 1's URL with https://taspring.clan-sy.com/svn/spring/trunk and get the latest revision. However, this may be unstable or broken at any point.
Optional: Spring-gui
Our local pygtk hero hollowsoul made a very nice gui which is currently the only way to automatically set up a spring game if you download svn (deb-spring has a nice command line script but this guide assumes an svn install)
Download Spring-GUI-3.12.
Extract it into your spring directory, which in this config is $HOME/.spring
Build unitsync.so and export it to spring-gui:
Again, symlinks are your friend...
Finally, you need to edit the file "Global.py" in the spring-gui-3.12 folder to make sure that it is pointing to the right place for the spring executable and paths. This should be self-explanatory when you look at the file.
Now get your GUI on...
*Thanks to AF, for the content links (and being awesome), and hollowsoul, for datadir settings and spring-gui (and being awesome).
This guide is primarily based off of the wiki setup guide (http://spring.clan-sy.com/wiki/SetupGuide) but I takes a slightly different path in the locations of files and use of links. There really isn't a right or wrong to that part...
0. Get what you need
These are the packages you must first download with your package manager of choice:
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
May vary from distro to distro. You'll know very quickly if you've missed something, so don't fret.
1. Get the source code
Using subversion, you can check out a branch of the latest stable ("tagged") build, currently 0.74b3.
Create a new directory for source files
Code: Select all
mkdir src
cd src
Code: Select all
svn checkout https://taspring.clan-sy.com/svn/spring/tags/taspring_0.74b3/
Enter the new directory and use scons (an alternative to make) to build the game.
Code: Select all
cd taspring_0.74b3
scons configure
scons
3. Put the game in its own place
This is where things start getting optional, somebody please let me know if it is unpleasant or wrong.
Create a directory for the program. I chose a hidden home directory, you don't have to. Copy the contents of the 'game' folder into this location.
Code: Select all
cd game
mkdir ~/.spring
cp -R * ~/.spring
Additional data required to correctly run in linux can be found here: http://prdownload.berlios.de/taspring-l ... b1.tar.bz2
Download the archive and extract the contents to the same location. It should be okay to overwrite files (can somebody confirm this? It's done me no harm and makes things very simple).
5. Symbolic links are your friend
To make things easy, you can make a symbolic link to your usr/bin directory that points to your new spring executable so that calling "spring" from a command prompt starts the program.
NOTE: YOU MAY NEED ROOT ACCESS FOR THIS. Debian users can probably use sudo, others may want to su.
Code: Select all
ln -s /home/YOUR_USER_NAME/.springdir/spring /usr/bin
Spring looks in a few places to find out where the data directory (called the datadir) is located. So, let's inform it by placing the path into a setting file in /etc...
Code: Select all
mkdir -p /etc/spring
echo '$HOME/.spring' > /etc/spring/datadir
6. Run, Spring, Run!
Code: Select all
spring
7. Get more stuff!
Check out the following places for maps and other content
http://www.ta-spring.com/maps
http://www.unknown-files.net
Also search around the forums for more content like mods and AI's.
Keep in mind that this guide refers you to how to install the tagged 0.73b1 release. If you want to be on the bleeding edge, you can replace step 1's URL with https://taspring.clan-sy.com/svn/spring/trunk and get the latest revision. However, this may be unstable or broken at any point.
Optional: Spring-gui
Our local pygtk hero hollowsoul made a very nice gui which is currently the only way to automatically set up a spring game if you download svn (deb-spring has a nice command line script but this guide assumes an svn install)
Download Spring-GUI-3.12.
Extract it into your spring directory, which in this config is $HOME/.spring
Build unitsync.so and export it to spring-gui:
Code: Select all
cd ~/src/taspring_0.73b1
scons omni
cd omni
cp unitsync.so $HOME/.spring/spring-gui-3.12
Code: Select all
chmod a+x $HOME/.spring/spring-gui-3.12/main.py
ln -s $HOME/.spring/spring-gui-3.12/main.py /usr/bin/spring-gui
Now get your GUI on...
Code: Select all
spring-gui
*Thanks to AF, for the content links (and being awesome), and hollowsoul, for datadir settings and spring-gui (and being awesome).
, he put a bit saying his spring didn't work unless he made the folder .springrc, i was pointing out mine worked without it :)