--System Req

About 1ghz cpu and gf2+ gpu. Need a ARB_vertex_program/ARB_fragment_program capable card for some graphic effects.


--Installation

1 Get the files into a directory
2 Run settings.exe, since you probably has a super fast computer turn on most options(maybe except dynamic clouds) and rise the detail sliders a bit. A screen res of 1024*768 or greater is preferable.
3 Run spring.exe


--Quick start
To see the computer battle it out automatically

-Air battle
Choose to be server and then select the air combat test script.

-Land battle
Choose not to be server and enter battle.sdf as server name.

-Camera controls
Move camera with arrow keys or placing cursor at screen border. Ctrl make it move faster and shift slower. Turn on mouse look with mouse button 3 (or backspace). Use ctrl+mouse3 to toggle overhead camera mode. In the air combat test you can also lock the camera to an aircraft with the h key. Space toggles larger units to ease identification.


--Creating a random map

Run mapgen. Spring dont syncronizes maps automatically at the moment so you need to make sure that every player has the same map. To avoid sending files mapgen can take a seed number as its first argument that will generate identical map for identical seeds. 
Optionally as a second argument mapgen can take a hint picture. This must be a 24 bit bmp with 2^n x 2^n resolution (0<n<9). The red channel control terrain roughness, green forest density and blue terrain height. White (255,255,255) is treated differently and is seen as a hint of where to place a city. Some example files are included. Mapgen can also take some more arguments, in order they are
mapgen.exe randseed hintpicture numCities numNeutralCities incomeMod supplyMod outputfilename


--Using higher resolution ground

To increase the resolution of the ground you need to run the texgen.exe program which will generate the textures used (with the standard low res ground these are generated at startup) and enable it in the settings program. This will use a lot of texture memory. Note there seem to be some sort of bug when using this mode on GF3 (other nvidia to?) hardware where craters can cause a dramatic slowdown sometimes.


--Game concepts
Spring contains a number of new or modified concepts compared with most RTSes. Some of the concepts are interlinked so if one seems strange try reading the others.

-Cities
The main target for your attacks will likely be the opponents cities. Each city has a townhall at its center and an area that belongs to it. The team that controls the townhall is seen as the owner of the city. Owning a city has two main effects.
1 Terrain belonging to the city will slowly change ownership to the owner of the city.
2 The townhall functions as a supply center and can produce builder units.

-Terrain ownership
Terrain has two sort of ownership.
1 City affilation. Each city owns the land around it.
2 Team affilation. All terrain belongs to a team. To take control of terrain either move units over it or if you own the closest city the terrain will slowly change its affilation to you.

-Houses
Dotted around the map and more concentrated in cities is houses. These belongs to the team that owns the land they stand on. The owning team receives an income from the houses that depends on the house supply and health.

-Gold
Each team has a gold income that is used in three ways. Fund reserch, economy improvemt, increase the treasury. The gold in the treasuary is used to build units and paying the units upkeep. Weapons also cost some gold to fire so having some gold in storage might be smart before a large battle.

-Supply
Each unit can store supply. The amount of stored supply affect the units performance in a number of way. Supply is lost in three ways, when it fires, when it moves, and a low fixed rate. Units receives supply based on the supply value of the map area it occupies.'

-Map supply
The supply value for a map area is calculated in several steps

First a value is calculated for how distant each of the players supply centers is from the players capital. The supply centers has a value indicating how much supply they have stored and this value is increased based on the above value and decreased when units draw supply from the center. From the supply centers supply flows out to the units. The strenght of these flows are calculated from how much supply is in the supply center and then decreased with distance. A unit can only draw supply from one center at a time but will automatically choose the best one.

The two distances mentioned above is not pure geometric distances but rather calculated from how easy the terrain it to pass with the lowest cost for roads and the highest for dense forest/mountains. The costs for the capital->supply centers are lower than supply center->units so its beneficial to have supply centers close to the front. Supply can also only pass over land that your team controls so having your army surrounded by enemies is bad.

-Morale 
Each unit has a morale value that will affect how well it fights. If the morale get to low it will panic and try to flee. Morale is lost when the unit takes damage or the supply gets to low. It will regenerate morale if its well supplied (faster if idle).

-Experience
Each unit has an experience value that greatly effects its abilities like health,morale,accuracy,speed. Experience is gained when the unit deals damage and units can also gain a certain amount of experience by being idle in a well supplied area (training)

-Cross fire
Units take more fire if they are attacked from several different direction instead of only one.

-Reserch
A percentage of your income is used for reserch that can be used in four different fields. Reserch has two different effects inside its field.
1 It gives small random improvement to the units in that field
2 At some levels new units become available
If you use to much of your income to reserch or use to much of the available reserch in a specific field the efficieny will be reduced so its better to use a small amount over a long time then varying the reserch level a lot.


--Game controls

-Keys

Mouse1: Select units, drag to select a group, double click to select of same type etc. Gives order if a specific order has been selected
Mouse2: Give the default order for the unit
Mouse3: toggle mouse look
Mouse3+Ctrl: toggle overhead view
Arrow keys: move camera
Ctrl/Shift: Increase/Decrease camera movement speed.
Mousewheel: move up/down

Space: Draw the units double size
F1: color code map for terrain elevation
F2: color code map for city affilation
F3: color code map for supply value
F5: colod code map for team affilation
(press the same map coding twice to revert to normal mode)
f6: toggle trees
f7: toggle dynamic sky
f12: Screenshot
ins/del: increase/decrease game speed.
pause: pauses
Enter: chat
b: see debug data
h: hides the interface

See also uikeys.txt for other keys.


--Unit status bars

Horizontal

Red: Health
Green: Stored supply, a small red line indicating map supply value.
Blue: Morale

Vertical

White: Experience
Red: Either how far they are in being built or how far they have come in building another unit.