Download

From Spring
Revision as of 20:38, 29 August 2009 by Auswaschbar (talk | contribs)
Jump to navigationJump to search

Spring RTS Engine

On this page you will find information on how to download the latest releases from the Spring project for various platforms.

Windows

Game installers (for players)

As Spring itself is just an engine and does not contain game content, we advice to go to the website of the game you want to play for an all inclusive installer. Below are some download pages of games using the Spring engine:

Kernel Panic

Spring 1944

Engine installer (Bare Bones Installer)

Click here to download version 0.80.3 ~21MB, added 2009-08-29

Backup in case the above doesn't work version 0.80.3 ~21MB, added 2009-08-29

As all Spring-based games don't have their own installer, the engine installer can also be used by players to play other games. This installer provides the core files for Spring, the multiplayer lobby client and the autodownloader. Use the autodownloader to get maps and games, or download them from some hosting sites (listed in the lobby #main channel).

Experimental Multithreading executable version 0.80.2, added 2009-08-26 ~3MB. Unzip to your installation folder. Does not work with all mods.

Portable archive


Nightly Builds (for engine/game developers/testers)

click here for a list of test builds (only for testing purposes)


Linux Linux

The Linux set up guide provides set up information for various Linux distributions.

Please note that due to the amount of distributions out there, we cannot provide binary packages for each of them. If yours is not listed there, you most likely need to build it yourself. If you do so, please share your results with others.


Mac OS X

Sorry no download yet. The Mac OS X port is rough and unfinished. Help with its development would be greatly appreciated. More information on the current state of this port can be found here.



Source Code

Tarballs

(For playing online official games on lobby.springrts.com - the spring lobby server)

Using Git is the recommended way to get the sources of the engine. In spite of, you can use the official tarballs to compile Spring without git.

Note: Do NOT use the zip-files from github, they are missing important data to compile Spring.

See Building spring for build instructions.

Git

Spring project page at github

Master repo URI: git://github.com/spring/spring.git
Backup repo: git://git.code.sf.net/p/springrts/code

Branches of interest:

  • master - latest stable, enforced for official games on lobby.springrts.com
  • maintenance - fixes for the latest stable
  • develop - major developments (most active, larger developments)

Assuming the GIT command line client is installed, you can clone (get locally) the repository with the commands below.

Latest Stable (master branch, useless for development purposes, lives as maintenance moving forward)

git clone --recursive git://github.com/spring/spring.git -b master

To later update it (get the changes other people did) with:

git pull --rebase

Maintenance (maintenance branch)

git clone --recursive git://github.com/spring/spring.git -b maintenance

Bleeding-edge (develop branch)

git clone --recursive git://github.com/spring/spring.git -b develop

Working with git

Please note that patches to the code must be done for either develop or maintenance. Such patches can be then sent to one of the developers with repository access. If you are new to git and github, you may want to have a look at this guide to get you started.

Note: you can switch branches this way:<syntaxhighlight lang="bash">

  1. (optional) backup your current code changes

git stash

  1. switch branch

git checkout $MY_OTHER_BRANCH

  1. sometimes needed
  2. note, it deletes all your unstashed changes and all non-pushed commits on the new branch,
  3. but it doesn't delete untracked files.
  4. git reset --hard
  1. update/sync with remote repo

git pull --rebase

  1. (optional) if you want to apply the code changes backed-up in the first step
  2. git stash pop # reapplies your changes and DELETES the backup
  3. or
  4. git stash apply --index 0 # reapplies your changes and keep the backup (see `git stash list`)

</syntaxhighlight>

Submodules

To obtain the submodules you should clone the repository with --recursive as mentioned above. If you haven't done this, you can execute the following code <syntaxhighlight lang="bash"> git submodule sync git submodule update --init

</syntaxhighlight>

To update the submodules, you have to execute the same commands again or pull normally.

Building instructions

If you want to compile it yourself, see Building_spring for some tips.

Lobby server

If you do not want (or are unable) to use the public lobby server, you can download the server software here to run your own. See the readme here.

Click here to download 100.7kb, added 2008-03-02 (requires Java Runtime Environment)