|
|
| (358 intermediate revisions by 44 users not shown) |
| Line 1: |
Line 1: |
| == Linux Setup Guide ==
| | =Linux/Unix Setup Guide= |
|
| |
|
| === Which Version To Install ===
| | {{#css: |
| | table.glossy { |
| | margin: 4px; padding:10px; |
| | border: 1px solid rgba(0,0,0,0.5); |
| | border-radius: 10px 10px 10px 10px; |
| | box-shadow: 0 2px 6px rgba(0,0,0,0.5), inset 0 1px rgba(255,255,255,0.3), inset 0 10px rgba(255,255,255,0.2), inset 0 10px 20px rgba(255,255,255,0.25), inset 0 -15px 30px rgba(0,0,0,0.3); |
| | text-align: center; |
| | } |
| | /*table.glossy:hover { |
| | background: rgba(160,160,220,0.4); |
| | }*/ |
| | }} |
|
| |
|
| To play online, you must have the same version as everyone else in the game.
| |
|
| |
|
| Most people should get the current release, version 0.74b3. There are usually
| |
| between 100 and 200 people online in the lobby, and if you want to play with
| |
| them, you need this.
| |
|
| |
|
| Older versions should only be interesting to software archeologists.
| | {| style="width:70%; margin-left:15%; margin-right:15%;" | |
|
| |
|
| If you want to see the bleeding edge, you can checkout svn head of spring, but
| | |{{Template:LinuxSetupGuideButton|name=From Source|link=Build_from_source|icon=Git.png}} |
| it can not be used to play with people who have the release, so you are
| |
| practically limited to playing against nemo. This is mainly interesting for
| |
| people who want to contribute to the project, for testing, finding bugs and
| |
| fixing them, and implementing new features. Head can be seriously broken from
| |
| time to time, or not even compile.
| |
|
| |
|
| === Installing With Package Managers On Various Distributions === | | |{{Template:LinuxSetupGuideButton|name=Snaps|link=Snaps_install }} |
|
| |
|
| If there is a package for your distributions preferred package manager, it is
| | |{{Template:LinuxSetupGuideButton|name=Ubuntu|link=Ubuntu_install|icon=Distributions-ubuntu.png}} |
| recommended to use it instead of compiling the program yourself from sources.
| |
|
| |
|
| ==== 0.74b3 For Etch (Debian 4.0 Stable) With APT ==== | | |{{Template:LinuxSetupGuideButton|name=Gentoo|link=Gentoo_install|icon=Distributions-gentoo.png}} |
|
| |
|
| <code><pre>
| | |- |
| echo "deb http://www.osrts.info/~tvo/deb etch spring" >> /etc/apt/sources.list
| |
| aptitude update
| |
| aptitude install spring spring-data
| |
| </pre></code>
| |
|
| |
|
| Your paths are: Spring executable in <code>/usr/games/spring </code> and
| | |{{Template:LinuxSetupGuideButton|name=Slackware|link=Slackware12_install|icon=Distributions-slackware.png}} |
| read-only data in <code>/usr/share/games/spring</code>.
| |
|
| |
|
| ==== 0.74b3 For Sid (Debian Unstable) With APT ==== | | |{{Template:LinuxSetupGuideButton|name=Debian|link=Debian_install|icon=Distributions-debian.png}} |
|
| |
|
| The current .deb for Sid is broken, because it depends on some boost packages
| | |{{Template:LinuxSetupGuideButton|name=Mandriva|link=Mandriva_install|icon=Distributions-mandriva_linux.png}} |
| of version 1.33 that are not installable on sid, which has only 1.34. A
| |
| slightly more complex way to install is necessary:
| |
|
| |
|
| <code><pre>
| | |- |
| echo "deb http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
| |
| echo "deb-src http://www.osrts.info/~tvo/deb sid spring" >> /etc/apt/sources.list
| |
| aptitude update
| |
| aptitude install dpkg-dev devscripts
| |
| apt-get source spring
| |
| apt-get build-dep spring
| |
| cd spring-0.74~b3/
| |
| debuild -us -uc
| |
| debi
| |
| </pre></code>
| |
|
| |
|
| Your paths are: Spring executable in <code>/usr/games/spring </code> and
| | |{{Template:LinuxSetupGuideButton|name=openSUSE|link=openSUSE_install|icon=Distributions-opensuse_linux.png}} |
| read-only data in <code> /usr/share/games/spring</code>.
| |
|
| |
|
| ==== 0.74b3 For Ubuntu (any version) With APT ==== | | |{{Template:LinuxSetupGuideButton|name=Fedora|extlink=http://projects.springlobby.info/projects/springlobby/wiki/Install#Fedora-10|icon=Distributions-fedora.png}} |
|
| |
|
| If you have boost 1.33, then all you need is:
| | |{{Template:LinuxSetupGuideButton|name=FreeBSD|link=FreeBSD_install|icon=Distributions-freebsd.png}} |
| | |} |
|
| |
|
| <code><pre>
| |
| echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
| |
| aptitude update
| |
| aptitude install spring spring-data
| |
| </pre></code>
| |
|
| |
|
| If you have boost 1.34, you have to do it the same way as debian unstable:
| | <span style="float:right">[[Linux:Packaging | Package Maintainers]]</span> |
|
| |
|
| <code><pre>
| | [[Category:Linux]] |
| echo "deb http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
| |
| echo "deb-src http://www.osrts.info/~tvo/deb edgy spring" >> /etc/apt/sources.list
| |
| aptitude update
| |
| aptitude install dpkg-dev devscripts
| |
| apt-get source spring
| |
| apt-get build-dep spring
| |
| cd spring-0.74~b3/
| |
| debuild -us -uc
| |
| debi
| |
| </pre></code>
| |
| | |
| Your paths are: Spring executable in <code>/usr/games/spring</code> and
| |
| read-only data in <code>/usr/share/games/spring</code>.
| |
| | |
| ==== 0.74b3 For Gentoo With Portage ====
| |
| | |
| Make an overlay for portage, download the ebuilds, and extract to populate the overlay:
| |
| | |
| <code><pre>
| |
| mkdir -p /usr/local/portage
| |
| echo 'PORTDIR_OVERLAY="/usr/local/portage"' >> /etc/make.conf
| |
| wget http://download.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2 ||
| |
| wget http://download2.berlios.de/taspring-linux/spring-ebuilds-0.74-r3.tar.bz2
| |
| tar xjf spring-ebuilds-0.74-r3.tar.bz2 -C /usr/local/portage/
| |
| </pre></code>
| |
| | |
| If you are not running unstable (~x86), do the following:
| |
| | |
| <code><pre>
| |
| echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords
| |
| echo "games-strategy/spring-base-ota ~x86" >> /etc/portage/package.keywords
| |
| echo "games-strategy/spring-mod-xta ~x86" >> /etc/portage/package.keywords
| |
| echo "games-strategy/spring-mod-gundamrts ~x86" >> /etc/portage/package.keywords
| |
| echo "games-strategy/spring-mod-nanoblobs ~x86" >> /etc/portage/package.keywords
| |
| </pre></code>
| |
| | |
| Some packages need to be built with certain use flags set, this makes sure it happens:
| |
| | |
| <code><pre>
| |
| echo "media-libs/libsdl X opengl" >> /etc/portage/package.use
| |
| echo "dev-libs/boost threads" >> /etc/portage/package.use
| |
| emerge media-libs/libsdl dev-libs/boost
| |
| </pre></code>
| |
| | |
| Add yourself to the group <code>games</code>. Don't do this as root, do this as
| |
| the user you normally use to play (you have to relogin afterwards to make it
| |
| work):
| |
| | |
| <code><pre>
| |
| gpasswd -a $(whoami) games
| |
| </pre></code>
| |
| | |
| And finally emerge spring itself, along with some datafile packages (ignore the
| |
| use flags for spring ebuild):
| |
| | |
| <code><pre>
| |
| emerge unzip spring spring-base-ota spring-mod-xta spring-mod-gundamrts
| |
| emerge spring-mod-nanoblobs
| |
| etc-update
| |
| </pre></code>
| |
| | |
| Your paths are: Spring executable in <code>/usr/games/bin/spring</code> and
| |
| read-only data in <code>/usr/share/games/spring</code>.
| |
| | |
| === Installing 0.74b3 From Source ===
| |
| | |
| ==== Getting The Source ====
| |
| | |
| You can either download the source as a 4.7MB tarball (recommended) or get it
| |
| from the subversion repository. Either way, the result is the same for 0.74b3.
| |
| | |
| ===== Downloading A Tarball =====
| |
| | |
| <code><pre>
| |
| cd /tmp
| |
| wget http://download.berlios.de/taspring-linux/spring_0.74b3_src.tar.bz2 ||
| |
| wget http://download2.berlios.de/taspring-linux/spring_0.74b3_src.tar.bz2
| |
| tar xjf spring_0.74b3_src.tar.bz2
| |
| cd spring_0.74b3
| |
| </pre></code>
| |
| | |
| ===== Checking Out From Subversion =====
| |
| | |
| <code><pre>
| |
| aptitude install subversion # if you are not on debian, figure it out
| |
| svn co https://taspring.clan-sy.com/svn/spring/tags/taspring_0.74b3 /tmp/spring_0.74b3
| |
| cd /tmp/spring_0.74b3
| |
| </pre></code>
| |
| | |
| ==== Getting The Dependencies ====
| |
| | |
| For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the
| |
| following to be the minimal set that is necessary to get. I have not tested
| |
| with any version of Ubuntu, but the line is probably almost identical if not
| |
| the same.
| |
| | |
| <code><pre>
| |
| aptitude install scons build-essential zlib1g-dev libfreetype6-dev
| |
| aptitude install libsdl1.2-dev libopenal-dev libglew-dev libboost-dev
| |
| aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev
| |
| aptitude install python2.4-dev zip
| |
| </pre></code>
| |
| | |
| This has been tested to work with a clean install of gentoo 2007.0:
| |
| | |
| <code><pre>
| |
| emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0
| |
| emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost
| |
| emerge media-libs/devil app-arch/zip
| |
| </pre></code>
| |
| | |
| Users of other distributions should be able to figure out the correct package
| |
| names from this. The scons configure will whine if you forget something, but it
| |
| does not check if you remembered to install zip, even though you still need it.
| |
| | |
| ==== Building And Installing ====
| |
| | |
| The build will spew out warnings like the following, which you can safely ignore:
| |
| | |
| <code><pre>
| |
| warning: division by zero
| |
| warning: 'q' may be used uninitialized in this function
| |
| </pre></code>
| |
| | |
| Configure, build and install:
| |
| | |
| <code><pre>
| |
| scons configure
| |
| scons
| |
| scons install
| |
| mkdir -p /etc/spring/datadir
| |
| echo '$HOME/.spring' > /etc/spring/datadir
| |
| </pre></code>
| |
| | |
| Your paths are: Spring executable in <code>/usr/local/games/spring</code> and
| |
| read-only data in <code>/usr/local/share/games/spring</code>.
| |
| | |
| | |
| == Linux Setup Guide ==
| |
| === Gentoo linux ===
| |
| * 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].<br>The best way to install the ebuild in gentoo would be to add an portage overlay and copy the file into the overlay. Now in detail:<br>
| |
| :# <b>mkdir /usr/local/portage</b>
| |
| :# add this line to you /etc/make.conf<br> <b>PORTDIR_OVERLAY="/usr/local/portage"</b>
| |
| :# download the ebuild you want, for example: spring-ebuilds-0.74-r3.tar.bz2
| |
| :# <b>mv spring-ebuilds-0.74-r3.tar.bz2 /usr/local/portage</b>
| |
| :# <b>cd /usr/local/portage</b>
| |
| :# <b>tar jxvf spring-ebuilds-0.74-r3.tar.bz2</b>
| |
| :# most likely you don't run a ~x86 system (unstable) so do a:<br> <b>echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords</b>
| |
| :# <b>echo "dev-libs/boost threads" >> /etc/portage/package.use</b>
| |
| :# if you want spring's evn version instead of stable do: <br> <b>emerge spring-svn</b>
| |
| :# You might want to have a look at the USE flags, type:<br><b>emerge -pv spring</b>
| |
| :# the current useflags are debug, optimize(which i enabled and worked without errors), omni (for omni lobby) and unity (for Unity Lobby).
| |
| :# finally install it with:<br><b>emerge spring</b>
| |
| :* if you get this error:
| |
| :: Calculating dependencies... done!
| |
| :: >>> Emerging (1 of 1) games-strategy/taspring-linux-release-0.72-r1 to /
| |
| :: >>> checking ebuild checksums ;-)
| |
| :: >>> checking auxfile checksums ;-)
| |
| :: >>> checking miscfile checksums ;-)
| |
| :: >>> checking taspring-linux-data-0.72b1.tar.bz2 ;-)
| |
| :: >>> Unpacking source...
| |
| ::
| |
| :: !!! ERROR: games-strategy/taspring-linux-release-0.72-r1 failed.
| |
| :: Call stack:
| |
| :: ebuild.sh, line 1539: Called dyn_unpack
| |
| :: ebuild.sh, line 711: Called src_unpack
| |
| :: taspring-linux-release-0.72-r1.ebuild, line 45: Called subversion_src_unpack
| |
| :: subversion.eclass, line 278: Called subversion_fetch
| |
| :: subversion.eclass, line 127: Called die
| |
| :: !!! subversion.eclass: ESVN_REPO_URI is empty.
| |
| :: !!! If you need support, post the topmost build error, and the call stack if relevant.
| |
| ::
| |
| :: !!! This ebuild is from an overlay: '/usr/local/portage'
| |
| :* Then try: <b>rm -Rf /usr/portage/distfiles/svn-src/spring</b>
| |
| :* Afterwards do: <b>emerge spring</b>
| |
| | |
| | |
| === Debian, Ubuntu & derivatives ===
| |
| * Add one of the following lines to your /etc/apt/sources.list file to enable the repository with spring packages.<br><br><code>deb http://www.osrts.info/~tvo/deb edgy spring # Ubuntu Edgy Eft<br>deb http://www.osrts.info/~tvo/deb etch spring # Debian Testing<br>deb http://www.osrts.info/~tvo/deb sid spring # Debian Unstable<br></code> <small>As this file is by default read-only, you will have to start your file-explorer with root priviliges, usually by entering: <code>sudo [name of explorer]</code> in your console.</small>
| |
| | |
| * Update your local package database by running: <code>sudo apt-get update</code><br>(Or use the update feature of your favorite package manager, Synaptic, Adept, aptitude, etc.)
| |
| | |
| * Install the spring package: <code>sudo apt-get install spring</code> . <small> This will also automagically install all the packages Spring depends on.</small><br><small> If you get errors at the last stage (dependencies not found, e.g.could not find libboost-regex1.33.1) then you will have to edit /etc/apt/sources.list once more. Basicly you will have to add package source links which are more up to date then the ones you have, however I can not be specific, as it depends on which Debian-derivative you are using. </small>
| |
| | |
| * Create directories for data files: <code>mkdir -p ~/.spring/{maps,mods,base}</code>
| |
| | |
| * Point your browser to [http://spring.unknown-files.net/ Unknown Files]. Download at least one map from the map section (put it in ~/.spring/maps), and at least one mod from the mod section (put in ~/.spring/mods). The default maps are [http://spring.unknown-files.net/file/2106/SmallDivide/ SmallDivide] and [http://spring.unknown-files.net/file/2107/Mars/ Mars]. Default mods are either [http://spring.unknown-files.net/file/1967/XTA_v8.1/ XTA] or [http://spring.unknown-files.net/file/1977/NanoBlobs_0.64GPL_Release./ NanoBlobs] (XTA is based on Total Annihilation content, NanoBlobs is free). Note: do NOT unzip .sdz and .sd7 files!
| |
| | |
| * If you downloaded XTA in the previous step, or ever want to play mods that depend on Total Annihilation content (XTA, AA, BA, etc.), then do the following:<br><br><code>wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip<br>unzip -d ~/.spring/base base-ota-content.zip</code><br><br>Note that you are legally required to own a copy of Total Annihilation if you perform this last step.
| |
| | |
| === All other linux distributions ===
| |
| * Make sure you have the following packages installed:<br><br><code>build-essential sun-java6-jdk sun-java6-jre libsdl-dev libopenal-dev libglew-dev libboost-dev libboost-thread-dev libboost-regex-dev libdevil-dev libfreetype6-dev python2.4-dev scons subversion zip 7zip</code>
| |
| | |
| * Create a working directory, we'll use this to compile spring:<br><br><code>mkdir ~/workdir<br>cd ~/workdir</code>
| |
| | |
| * Download the most recent source tarball (.tar.bz2 file) from [http://developer.berlios.de/project/showfiles.php?group_id=4358 BerliOS], save it in ~/workdir.
| |
| | |
| * Extract the tarball and switch to the directory (adjust version numbers if necessary):<br><br><code>tar xfj spring_0.74b3_src.tar.bz2<br>cd spring_0.74b3</code><br><small>Watch out when using graphical extraction tools. They don't always create the included empty directories, causing later steps to fail. It is recommended to extract the archive using the above command.</small>
| |
| | |
| * Configure: <code>scons configure</code><br>If this doesn't work, be sure to check you installed all dependencies, and peek at the file config.log, which may show the reason it didn't work in detail. To tune the configuration (installation paths, debugging, etc.), refer to: <code>scons -H</code>
| |
| | |
| * Compile by running: <code>scons</code><br>This can take 5-15 minutes depending on your system.
| |
| | |
| * To install spring, run the following as root: <code>scons install</code>
| |
| | |
| * Set up spring to look in your home directory for data files (run as root):<br><br><code>mkdir -p /etc/spring<br>echo '$HOME/.spring' > /etc/spring/datadir'</code><br><br>Alternatively you can specify it in ~/.springrc (if you don't have root access):<br><br><code>echo "SpringData=$HOME/.spring" >> ~/.springrc</code>
| |
| | |
| * Now continue at the fourth (4th) step under <b>Debian, Ubuntu & derivatives</b>: "Create directories for data files".
| |
| | |
| Tips:
| |
| | |
| * If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.
| |
| | |
| * Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo)<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.
| |
| | |
| * If you really can't figure out how to get spring compiled, or you think there's a bug in the code or the buildsystem...
| |
| :* Just poke any developer on IRC:
| |
| ::* channel <code>#taspring</code> on [http://freenode.net/ FreeNode]
| |
| ::* or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]
| |
| :* Post it on [http://taspring.clan-sy.com/phpbb/ the forum]
| |
| :* or file a bug in our [http://taspring.clan-sy.com/mantis/ bug tracking system].
| |
| | |
| === Settings Editing ===
| |
| the .springrc file is difficult to edit by hand, and the windows settings editor won't change your settings, so use Kloot's [http://members.chello.nl/mjtobi/Settings++.tar.gz Settings++]. untar it anywhere and open it by typing "./Settings++" and edit away.
| |
| | |
| ''' [[Main_Page|<- Back to Main page]]'''
| |
| | |
| [[Category:Linux Port]][[Category:Playing]] | |
