Spring - User contributions [en]

Google Summer of Code

2012-03-08T20:02:43Z

Koshi: /* I'm a Student -- What's this all about? */

= Introduction =

Welcome to the [http://www.google-melange.com/gsoc/homepage/google/gsoc2012 GSoC 2012] page!
This year, Spring wants to participate in Google's fantastic Summer of Code program. We can't do this alone, however -- everyone has to pitch in to make the experience a good one.

== I'm already a Springer -- How can I help? ==

If you're knowledgeable about the engine or with regard to content creation, you can apply to be a mentor.

Volunteers can also help by cleaning up and expanding the documentation, especially pages pertinent to GSoC.

== I'm a Student -- What's this all about? ==

If you want to help Spring out and learn something along the way, you can join us as a student!

For possible projects, look at the [[Project proposals|project proposals]] page. You can also come up with your own ideas. If our projects gets accepted, send your application to Google.

To participate, see the [[GSoC:student_application|student application]] page.

To get in contact with the Spring community create a forum account, join one of our irc channels or create a lobby account and join #sy in the game lobby.
(#sy / #taspring is bridged by an irc bot)

To get in touch with spring, [http://springrts.com/wiki/Building_spring download Spring's source code & setup a build enviroment] to get familiar with it.

See the [http://www.google-melange.com/gsoc/events/google/gsoc2012 timeline at GSoC] for more details.

= Contact =
You can reach the Spring developers at:
* [http://springrts.com/phpbb/viewforum.php?f=12 The Spring forum]
* IRC (at irc.freenode.net in channel [irc://irc.freenode.net/taspring #taspring] or at irc.quakenet.org in [irc://irc.quakenet.org/sy #sy])
* On Spring's lobby server in channel #sy
* [[File:mailinglist.png|link=mailto:springrts-team@SPAMPROTECTED]]

Please read [http://code.google.com/intl/de/soc/ Google's Summer of Code Website] for more information.

[[Category:GSoC]]

Google Summer of Code

2012-03-08T20:01:59Z

Koshi: /* I'm already a Springer -- How can I help? */

= Introduction =

Welcome to the [http://www.google-melange.com/gsoc/homepage/google/gsoc2012 GSoC 2012] page!
This year, Spring wants to participate in Google's fantastic Summer of Code program. We can't do this alone, however -- everyone has to pitch in to make the experience a good one.

== I'm already a Springer -- How can I help? ==

If you're knowledgeable about the engine or with regard to content creation, you can apply to be a mentor.

Volunteers can also help by cleaning up and expanding the documentation, especially pages pertinent to GSoC.

== I'm a Student -- What's this all about? ==

If you want to help Spring out and learn something along the way, you can join us as a student!

For possible projects, look at the [[Project proposals|project proposals]] page. You can also come up with your own ideas. If our projects gets accepted, send your application to Google.

To participate, see the [[GSoC:student_application|student application]] page.

To get in contact with the Spring community create a forum account, join one of our irc channels or create a lobby account and join #sy in the game lobby.
(#sy / #taspring is bridget with an irc bot)

To get in touch with spring, [http://springrts.com/wiki/Building_spring download Spring's source code & setup a build enviroment] to get familiar with it.

See the [http://www.google-melange.com/gsoc/events/google/gsoc2012 timeline at GSoC] for more details.

= Contact =
You can reach the Spring developers at:
* [http://springrts.com/phpbb/viewforum.php?f=12 The Spring forum]
* IRC (at irc.freenode.net in channel [irc://irc.freenode.net/taspring #taspring] or at irc.quakenet.org in [irc://irc.quakenet.org/sy #sy])
* On Spring's lobby server in channel #sy
* [[File:mailinglist.png|link=mailto:springrts-team@SPAMPROTECTED]]

Please read [http://code.google.com/intl/de/soc/ Google's Summer of Code Website] for more information.

[[Category:GSoC]]

Project proposals

2012-03-08T16:24:04Z

Koshi: grammar/spelling

= Google Summer of Code=
__NOTOC__
==[http://www.google-melange.com/gsoc/homepage/google/gsoc2012 GSoC 2012 Homepage]==
==I want to be one of your Google Summer of Code students, what should I do...==
* join either #taspring @ FreeNode, #sy @ QuakeNet or #sy via the game lobby (all channels are bridged via a bot)
* create a forum account (also needed to edit this wiki)
* [http://springrts.com/wiki/Building_spring download Spring's source code & setup a build enviroment] to get familiar with it
* visit [[GSoC:student_application]]
* submit your application to Google till April 6th

=Project proposals=
Below is a list of project ideas by the developers.

==GSoC project proposals==

=== Limited play area ===

Estimated difficulty: '''medium'''

Spring uses a finite-world model, where the scene has distinct bounds that all actors must obey.
Current Spring map formats have a hardcoded rectangle boundary geometry; they also provide very limited support for defining aesthetics of the surrounding environment outside the play area.

The new system should allow the map's developer to restrict the playable area to a subset of the global area, possibly adding support for multiple shapes and/or non rectangular shape restrictions.

The restriction shapes should be readable and changeable mid-game through the engine's Lua API. Proper handling of units which are suddenly off-map needs to be implemented.

'''Details:''' [[GSoC_Limited_play_area]]

'''Mentors:''' abma, midknight

=== Sensor handling redesign / simplification ===

Estimated difficulty: '''high'''

Currently there are a number of different "sensor" systems in the engine: LineOfSight, Radar, Sonar, and Seismic.
Some sensors can be jammed, some cannot. Some respect terrain, and some are always circular in coverage.

A new sensor system should integrate the current LOS, Radar, Sonar, Seismic systems into a streamlined codebase, to reduce amount of code in each implementation, and it should add additional features which would then be available for all types, while improving efficiency where possible.

Preferably all this should also be faster than the current system or a compelling argument/experiment should be made that shows there cannot be a faster system with the same features.

'''Details:''' [[GSoC_Sensor_handling_redesign]]

'''Mentors:''' abma, midnight

=== Engine level abstraction of resources ===

Estimated difficulty: '''medium to high'''

The Spring engine has its roots in an older Real-Time Strategy title, where only two resources were incorporated into the game design.
The current resource system is largely present in the codebase being hardcoded in a lot of critical places.

The old system needs to be replaced, the new one should be flexible enough to reproduce everything that the old system did and be able to imitate the behaviour of most common RTS game titles.

The engine's Lua API to fetch resources will have to be adapted to the new system, and new calls will have to be added to it.

'''Details:''' [[GSoC_Engine_resource_abstraction]]

'''Mentors:''' abma, midnight

=== Basic ingame lobby ===

Estimated difficulty: '''high'''

All existing Spring interfaces (lobbies) are either difficult to customize for game developers or have a different look and feel from the game itself and require focus switch from the game itself to operate.

A new lobby should be implemented with customization and control in mind, using Lua scripting and reusing Spring codebase where possible.

The engine's start screen should be replaced and integrated with it.

'''Details:''' [[GSoC_Ingame_lobby]]

'''Mentors:''' abma, koshi

=== Implementing a Scene Graph ===

Estimated difficulty: '''high'''

The Spring rendering engine uses a lot of FFP (fixed function pipeline) OpenGL functions. This model is becoming deprecated and is generally slower and less flexible than more modern approaches.

Under this proposal, the rendering code should get a complete overhaul and moved into a Scene Graph.
Allowing to replace the old code optionally with shader based approaches, including techniques as normal/relief mapping or 100% GPU based rendering of particles.

'''Details:''' [[GSoC_New_rendering_system]]

'''Mentors:''' abma, jK, midnight

=== New shadowmap techniques ===

Estimated difficulty: '''high'''

Currently Spring uses a single shadowtexture causing disturbed shadows when the viewrange increases.
The proposal is to implement one of the newer techniques like cascaded shadowmaps (CSM), percentage-closer filtering (PCF) or variance shadowmaps (VSM). Support for transparent shadows is appreciated.

'''Mentors:''' jK

=== FontConfig support ===

Estimated difficulty: '''medium'''

Spring already uses freetype2 for the font texture atlas generation. But it loads the used fonts from its VFS and cannot access system installed fonts yet, neither does it allow selecting the font's `style` (cursive, bold, ...) if it is included in the same ttf. Using fontconfig would solve all this. Windows support is wanted, too.

'''Mentors:''' jK

=== Host change during a match ===

Estimated difficulty: '''medium to high'''

Spring's network model implies the existence of a server to host a battle. For various reasons the network link between host and clients can be interrupted.
A system should be designed to allow manual and/or automatic switching of the game's host (possibly using an existing player after testing load handling capabilities).

'''Details:''' [[GSoC_Reconnect_Host_change]]

'''Mentors:''' abma, koshi

==General ideas for new developers==

These projects are interesting, but do not fit into the time schedule of GSoC.

=== In source Lua-API documentation ===

Estimated difficulty: '''low to medium'''

write a tool, that creates html from in-source comments to document the lua api. For Example:
<code><pre>
/*-
Prints a message
@param msg
*/
static int Echo(lua_State* L);

</pre></code>

this should create the function in the lua-api-docs

Spring.Echo

(this is just a suggestion)

see also [http://springrts.com/phpbb/viewtopic.php?f=73&t=27771 meeting minutes] (possible solution for in-source lua documentation)

=== Port spring to ARM/Android ===

Estimated difficulty: '''medium to very high'''

Spring currently seems to not work on the ARM architecture as streflop currently doesn't support ARM. Also there will be possible compile/linker/sync errors that have to be fixed first to make it run flawlessly.
Also its not clear if its possible if spring can be made syncing to x86 platforms because on some ARM processors no FPU available.

For a possible starting point see the [[Spring_on_ARM|Spring on ARM]] page.

=== 3D map format ===

Estimated difficulty: '''very high'''

The current map format is 2d only (with heightmaps), adding a real 3d map format would allow real bridges or some fancy maps.

[http://code.google.com/p/recastnavigation/ Recast navigation] could be used as pathfinder. This project is really difficult, as many / most parts of the engine have to be changed.

[[Category:GSoC]]
[[Category:Development]]

GSoC Ingame lobby

2012-03-04T16:17:15Z

Koshi: libSpringLobby hint is better placed here than on the overview page

= GSoC idea: Basic ingame lobby =

== Why ==
All existing Spring interfaces (lobbies) are either difficult to customize for game developers or have a different look and feel from the game itself and require focus switch from the game itself to operate.

== What ==
A new lobby should be implemented with customization and control in mind, using Lua scripting and reusing Spring codebase when possible. It should be running as a separate process overlaying to the game's UI.

Optionally, the engine's start screen should be replaced and integrated with it.

== Required skills ==
* Knowledge of C++
* Knowledge of Lua
* Knowledge of Lua API/C bindings
* Knowledge of basic OpenGL programming

== Difficulty ==
Estimated: hard

== Technical details ==

* ensure Spring can clean up properly
* ensure Spring can change mod during program runtime (requires that some singletons be converted to Spring's *handler pattern)
* The lobby API should reuse/be identical to spring's LuaUI where possible ( GL calls, access to game infos )
* to prevent Spring <-> lobby crash propagations they should run as separate processes, with lobby overlaying on top of Spring's UI, the only exception could be made for start screen.
* create a new Lua context or initalize current context earlier in the code and rewrite Spring's start interface using Lua scripting.

There is some potential of re-using/adapting libSpringLobby for the server interaction. Contact koshi in our IRC/Lobby channels if you are interested.
[[Category:GSoC]]

Project proposals

2012-03-04T16:15:56Z

Koshi: Reverted edits by Koshi (talk) to last revision by Midknight

= Project proposals =

This is the list of project ideas for new developers willing to work on the Spring engine.

== Port spring to ARM/Android ==

Estimated difficulty: '''high'''

Spring currently seems to not work on the ARM architecture as streflop currently doesn't support ARM. Also there will be possible compile/linker/sync errors that have to be fixed first to make it run flawesly.

For a possible start see the [[Spring_on_ARM|Spring on ARM]] page.

== Limited play area ==

Estimated difficulty: '''medium'''

Spring uses a finite-world model, where the scene has distinct bounds that all actors must obey.
Current Spring map formats have a hardcoded rectangle boundary geometry; they also provide very limited support for defining aesthetics of the surrounding environment outside the play area.

The new system should allow the map's developer to restrict the playable area to a subset of the global area, possibly adding support for multiple shapes and/or non rectangular shape restrictions.

The restriction shapes should be readable and changeable mid-game through the engine's Lua API. Proper handling of units which are suddenly off-map needs to be implemented.

'''Details:''' [[GSoC_Limited_play_area]]

== Sensor handling redesign / simplification ==

Estimated difficulty: '''high'''

Currently there are a number of different "sensor" systems in the engine: LineOfSight, Radar, Sonar, and Seismic.
Some sensors can be jammed, some cannot. Some respect terrain, and some are always circular in coverage.

A new sensor system should integrate the current LOS, Radar, Sonar, Seismic systems into a streamlined codebase, to reduce amount of code in each implementation, and it should add additional features which would then be available for all types, while improving efficiency where possible.

Preferably all this should also be faster than the current system or a compelling argument/experiment should be made that shows there cannot be a faster system with the same features.

'''Details:''' [[GSoC_Sensor_handling_redesign]]

== Engine level abstraction of resources ==

Estimated difficulty: '''medium to high'''

The Spring engine has its roots in an older Real-Time Strategy title, where only two resources were incorporated into the game design.
The current resource system is largely present in the codebase being hardcoded in a lot of critical places.

The old system needs to be replaced, the new one should be flexible enough to reproduce everything that the old system did and be able to imitate the behaviour of most common RTS game titles.

The engine's Lua API to fetch resources will have to be adapted to the new system, and new calls will have to be added to it.

'''Details:''' [[GSoC_Engine_resource_abstraction]]

== Basic ingame lobby ==

Estimated difficulty: '''high'''

All existing Spring interfaces (lobbies) are either difficult to customize for game developers or have a different look and feel from the game itself and require focus switch from the game itself to operate.

A new lobby should be implemented with customization and control in mind, using Lua scripting and reusing Spring codebase where possible.
It should be running as a separate process overlaying the game's UI.

Optionally, the engine's start screen should be replaced and integrated with it.

'''Details:''' [[GSoC_Ingame_lobby]]

== Smarter pathfinder ==

Estimated difficulty: '''high'''

Spring's pathfinder uses a 2d grid and is somewhat limited in functionality.
A partial/full rewrite should be introduced to add support for navigating using more than 8 primary directions and selectively ignore certain unit types for performance reasons.

Spring's Lua API should be extended to allow game developers to push new nodes/links and be able to alter or delete existing ones (for pathfinder-aware tunnels/teleporting/etc.).

Preferably this should all be faster than the current system, or a compelling argument/experiment should be made that shows there cannot be a faster system with the same features.

'''Details:''' [[GSoC_Smarter_pathfinder]]

== More AI interfaces ==

Estimated difficulty: '''medium'''

The Spring engine's AI interface supports bindings for multiple languages, currently C++, C and java are supported.

Bindings for more languages and/or virtual machines should be added to allow broader AI developing audience (for example: Ruby, Perl, JavaScript, Python, D, Go, Mono, LLVM, Parrot).

'''Details:''' [[GSoC_More_AI_interfaces]]

== New Rendering System ==

Estimated difficulty: '''medium'''

The Spring rendering engine uses a lot of FFP (fixed function pipeline) OpenGL functions. This model is becoming deprecated and is generally slower and less flexible than more modern approaches.

Under this proposal, the rendering code should get a complete overhaul using modern graphic programming techniques such as shaders, implement load support for more standardised model formats (backwards compatibility with current available formats is mandatory either through direct load or automatic conversion to the new types) and eventually introduce some graphic enhancing features (bump mapping, normal mapping, multitexturing, etc.).

'''Details:''' [[GSoC_New_rendering_system]]

== Reconnect / Host change during a match ==

Estimated difficulty: '''medium to high'''

Spring's network model implies the existence of a server to host a battle. For various reasons the network link between host and clients can be interrupted.
A system should be designed to allow manual and/or automatic switching of the game's host (possibly using an existing player after testing load handling capabilities) and manual and/or automatic reconnection from client side if host remains the same.

'''Details:''' [[GSoC_Reconnect_Host_change]]

== In source Lua-API documentation ==

write a doxygen filter, that a allows to document the lua-api in-source. For example:

<code><pre>
/*-
Prints a message
@param msg
*/
static int Echo(lua_State* L);

</pre></code>

this should create the function in the lua-api

Spring.Echo

[[Category:GSoC]]
[[Category:Development]]

Project proposals

2012-03-04T16:14:29Z

Koshi: added libSpringLobby hint

= Project proposals =

This is the list of project ideas for new developers willing to work on the Spring engine.

== Port spring to ARM/Android ==

Estimated difficulty: '''high'''

Spring currently seems to not work on the ARM architecture as streflop currently doesn't support ARM. Also there will be possible compile/linker/sync errors that have to be fixed first to make it run flawesly.

For a possible start see the [[Spring_on_ARM|Spring on ARM]] page.

== Limited play area ==

Estimated difficulty: '''medium'''

Spring uses a finite-world model, where the scene has distinct bounds that all actors must obey.
Current Spring map formats have a hardcoded rectangle boundary geometry; they also provide very limited support for defining aesthetics of the surrounding environment outside the play area.

The new system should allow the map's developer to restrict the playable area to a subset of the global area, possibly adding support for multiple shapes and/or non rectangular shape restrictions.

The restriction shapes should be readable and changeable mid-game through the engine's Lua API. Proper handling of units which are suddenly off-map needs to be implemented.

'''Details:''' [[GSoC_Limited_play_area]]

== Sensor handling redesign / simplification ==

Estimated difficulty: '''high'''

Currently there are a number of different "sensor" systems in the engine: LineOfSight, Radar, Sonar, and Seismic.
Some sensors can be jammed, some cannot. Some respect terrain, and some are always circular in coverage.

A new sensor system should integrate the current LOS, Radar, Sonar, Seismic systems into a streamlined codebase, to reduce amount of code in each implementation, and it should add additional features which would then be available for all types, while improving efficiency where possible.

Preferably all this should also be faster than the current system or a compelling argument/experiment should be made that shows there cannot be a faster system with the same features.

'''Details:''' [[GSoC_Sensor_handling_redesign]]

== Engine level abstraction of resources ==

Estimated difficulty: '''medium to high'''

The Spring engine has its roots in an older Real-Time Strategy title, where only two resources were incorporated into the game design.
The current resource system is largely present in the codebase being hardcoded in a lot of critical places.

The old system needs to be replaced, the new one should be flexible enough to reproduce everything that the old system did and be able to imitate the behaviour of most common RTS game titles.

The engine's Lua API to fetch resources will have to be adapted to the new system, and new calls will have to be added to it.

'''Details:''' [[GSoC_Engine_resource_abstraction]]

== Basic ingame lobby ==

Estimated difficulty: '''high'''

All existing Spring interfaces (lobbies) are either difficult to customize for game developers or have a different look and feel from the game itself and require focus switch from the game itself to operate.

A new lobby should be implemented with customization and control in mind, using Lua scripting and reusing Spring codebase where possible.
It should be running as a separate process overlaying the game's UI.

Optionally, the engine's start screen should be replaced and integrated with it.

There is some potential of re-using/adapting libSpringLobby for the server interaction. Contact koshi in our IRC/Lobby channels if you are interested.
'''Details:''' [[GSoC_Ingame_lobby]]

== Smarter pathfinder ==

Estimated difficulty: '''high'''

Spring's pathfinder uses a 2d grid and is somewhat limited in functionality.
A partial/full rewrite should be introduced to add support for navigating using more than 8 primary directions and selectively ignore certain unit types for performance reasons.

Spring's Lua API should be extended to allow game developers to push new nodes/links and be able to alter or delete existing ones (for pathfinder-aware tunnels/teleporting/etc.).

Preferably this should all be faster than the current system, or a compelling argument/experiment should be made that shows there cannot be a faster system with the same features.

'''Details:''' [[GSoC_Smarter_pathfinder]]

== More AI interfaces ==

Estimated difficulty: '''medium'''

The Spring engine's AI interface supports bindings for multiple languages, currently C++, C and java are supported.

Bindings for more languages and/or virtual machines should be added to allow broader AI developing audience (for example: Ruby, Perl, JavaScript, Python, D, Go, Mono, LLVM, Parrot).

'''Details:''' [[GSoC_More_AI_interfaces]]

== New Rendering System ==

Estimated difficulty: '''medium'''

The Spring rendering engine uses a lot of FFP (fixed function pipeline) OpenGL functions. This model is becoming deprecated and is generally slower and less flexible than more modern approaches.

Under this proposal, the rendering code should get a complete overhaul using modern graphic programming techniques such as shaders, implement load support for more standardised model formats (backwards compatibility with current available formats is mandatory either through direct load or automatic conversion to the new types) and eventually introduce some graphic enhancing features (bump mapping, normal mapping, multitexturing, etc.).

'''Details:''' [[GSoC_New_rendering_system]]

== Reconnect / Host change during a match ==

Estimated difficulty: '''medium to high'''

Spring's network model implies the existence of a server to host a battle. For various reasons the network link between host and clients can be interrupted.
A system should be designed to allow manual and/or automatic switching of the game's host (possibly using an existing player after testing load handling capabilities) and manual and/or automatic reconnection from client side if host remains the same.

'''Details:''' [[GSoC_Reconnect_Host_change]]

== In source Lua-API documentation ==

write a doxygen filter, that a allows to document the lua-api in-source. For example:

<code><pre>
/*-
Prints a message
@param msg
*/
static int Echo(lua_State* L);

</pre></code>

this should create the function in the lua-api

Spring.Echo

[[Category:GSoC]]
[[Category:Development]]

File:Springlobby 64.png

2012-01-03T00:45:24Z

Koshi: SpringLobby icon 64x64, background transparent

SpringLobby icon 64x64, background transparent

Lobby Development

2011-09-10T15:52:32Z

Koshi: update /* Spring-PythonBotFramework */

[[Engine_Development|Development]] < {{FULLPAGENAME}}

=Documentation=

==Protocol==
* [http://springrts.com/dl/tasclient/ProtocolDescription.xml HTML] (may be out of date)
* [https://github.com/spring/LobbyProtocol/blob/master/ProtocolDescription.xml XML] (raw, always latest)

==Download Systems==
* [http://springrts.com/wiki/Dev:LobbyDownloadSystems Lobby Download Systems]

=Lobby client development=
There are currently four working public lobby clients available.

==SpringLobby==
cross-platform,
C++,
by BrainDamage &
koshi

SpringLobby is the official lobby client of spring and is bundled with the Spring engine in the installer. It uses the ''wxWidgets'' library. You can browse the sources and submit issues on its [http://springlobby.info/ website].

==Zero-K==
Windows,
C#,
by Licho & quantum

[https://code.google.com/p/zero-k/ Zero-K project page]

==Alphalobby==
Windows,
C,
unmaintained

Alphalobby is still very much work in progress. If you still wish to use it, source available from the [http://code.google.com/p/alphalobby/source/checkout mercurial repository], binary available on the [http://springfiles.com/spring/lobby-clients/alphalobby springfiles page].

==TASClient==
Windows,
Delphi,
by Satirik

You can download the sources from the [http://springrts.com/svn/spring/Lobby/TASClient/ subversion repository] (svn://springrts.com/svn/spring/Lobby/TASClient/) and browse them on the [http://springrts.com/websvn/listing.php?repname=Spring&path=%2FLobby%2FTASClient%2F#_Lobby_TASClient_ websvn]. Latest binary version is always available here:
http://springrts.com/dl/tasclient/TASClientLatest.7z

[http://springrts.com/phpbb/viewtopic.php?f=12&t=18999 How to compile TASClient]

[http://springrts.com/phpbb/viewtopic.php?f=14&t=19014 How to customize TASClient]

==QtLobby==
cross-platform,
C++,
unmaintained

[http://code.google.com/p/qtlobby/ project page]

=Libraries and frameworks=

==Spring-PythonBotFramework==
cross-platform,
Python, by
BrainDamage & koshi

A bot framework written in python. [https://github.com/renemilk/tasbot/wiki GitHub wiki]

==Go SpringLobbyClient==
cross-platform,
Go

A simple client implementation of the lobby protocol in Go.
[https://github.com/Agon/go-slc/ project page]

=Lobby server development=

==TASServer==
cross-platform,
Java,
hoijui

The longest-running lobby server, created by Betalord, using PHP for the admin interface. You can fetch the sources through ''git''. Details can be found on the [http://github.com/spring/TASServer development site].

==UberServer==
cross-platform,
Python,
by aegis

The primary lobby server currently running on springrts.com. All protocol commands in the primary documentation should be fully-functional and compatible between both uberserver and TASServer. You can get more information and download uberserver at the [https://github.com/lunixbochs/uberserver github page]

[[Category: Lobbies]]

Ubuntu install

2011-07-07T17:11:02Z

Koshi: removed Emmanuel's nonsense

[[Linux|Linux Setup Guide]] < {{FULLPAGENAME}}

__TOC__
[[Image:Ubuntulogo.png]]

packages are available for: 11.04, 10.10, 10.04, 9.10, 9.04, 8.10

For packaging requests or complaints, please contact [[Linux:Packaging#Ubuntu | the packagers]].

= Ubuntu 9.10 and newer =

== Installation Instructions ==
Go to ''Applications - Ubuntu Software Center'', search for ''springlobby'' and click go.
If you want to be able to play online, see [[#Updating to newer releases|the next section]].

== Updating to newer releases ==
Go to ''System - Administration - Software Sources'', click the Other tab, click ''Add''. Type '''ppa:spring/ppa''' and close the window. Allow it to reload the packages, and you will find the new version of Spring and Spring Lobby in update manager.

If you're running Ubuntu 10.10, see "Missing repositories in Ubuntu 10.10 on this help page for software sources: https://help.ubuntu.com/community/Repositories/Ubuntu.

= Ubuntu 9.04 and 8.10 =
We now have a maintained and up to date APT repository for Ubuntu 9.04 (Jaunty) and 8.10 (Intrepid). If you have some older version of Ubuntu, you can easily upgrade with these instructions: http://www.ubuntu.com/getubuntu/upgrading.

You will need to add the Spring PPA below and install the ''springlobby'' package. Or you can upgrade to Ubuntu 9.10 and just install the ''springlobby'' package from the new Software Center.

== Installing the repository key ==
First, we need to add the Launchpad PPA package-signing key; this allows Ubuntu to know the packages have been provided by the right people can can be trusted to be installed. If you skip this step then Ubuntu will complain about an unverifiable package every time there's an update for Spring.

Go to:
[http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0xFC66403D8670A035]

Cut and paste the page contents to a file called ''ppa-spring.pgp'' or something recognizable like that. Do not use ''Save As'' in your browser, as this will likely not work because of added HTML formatting. You can use ''Applications - Accessories - Text Editor'' to copy&paste into and save to disk.

Security-conscious people can go to the Spring Developers PPA page at [https://launchpad.net/~spring/+archive/ppa launchpad.net] to verify that the key mentioned above is indeed the right one to trust.

Now go to ''System - Administration - Software Sources'' and click on the ''Authentication'' tab to add the saved ''ppa-spring.pgp'' with the ''Import Key File'' button. The new key should now pop up in the list.

== Installing the repository ==
In ''System - Administration - Software Sources'', click on the ''Third-Party Software'' tab. Then, click the ''Add'' button, and paste one of the two lines corresponding to your Ubuntu release (9.04 or 8.10).

'''Ubuntu 9.04 "Jaunty Jackalope"''':
<code><pre>
deb http://ppa.launchpad.net/spring/ubuntu jaunty main
</pre></code>

'''Ubuntu 8.10 "Intrepid Ibex"''':
Note: Please note if out of date. (It i easy enough to try.)
<code><pre>
deb http://ppa.launchpad.net/spring/ubuntu intrepid main
</pre></code>

Close the dialog, and click on ''Reload'' when it asks.

After that is done, you can just [http://springoo.mooo.com CLICK HERE TO INSTALL EVERYTHING]. Alternatively, you can head to ''System - Administration - Synaptic Package Manager'', and search for ''spring''. For the bare essentials, you will need to install the ''spring-engine'' and ''springlobby'' packages.

SpringLobby can be found in ''Applications - Games'' after install. (Please note that you also need mods and maps to play. The easiest way to get them is to download them from within SpringLobby itself.

= Alternative installation using the terminal =
Press ''Alt-F2'' to run a command. Enter:

<code><pre>
gksudo -- wget -O - "http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0xFC66403D8670A035" | \
apt-key add -
</pre></code>

This will add the Spring-Developers PPA package-signing key to the list of keys that Ubuntu should trust for software packages. (See above for more info).

Then do:
<code><pre>
gksudo gedit /etc/apt/sources.list.d/springproject.list
</pre></code>

Copy and paste the following into the file:

'''Ubuntu 9.04:'''
<code><pre>
deb http://ppa.launchpad.net/spring/ubuntu jaunty main
deb-src http://ppa.launchpad.net/spring/ubuntu jaunty main
</pre></code>

'''Ubuntu 8.10:'''
<code><pre>
deb http://ppa.launchpad.net/spring/ubuntu intrepid main
deb-src http://ppa.launchpad.net/spring/ubuntu intrepid main
</pre></code>

Save the file. You can then either use the graphical package manager Synaptic (''System - Administration - Synaptic Package Manager'') and search for ''spring'' related packages, or just install spring from a terminal using:
<code><pre>
sudo apt-get update
sudo apt-get install spring spring-maps-default
</pre></code>

== Other information ==
You can view the web page for the repository [https://edge.launchpad.net/~spring/+archive here]. Additional packages (such as one for Kernel Panic) are there as well.

The package installs the Spring executable at <code>/usr/games/spring</code> and read-only data in <code>/usr/share/games/spring</code>.

= See Also: =
* [[Template: Finalizing_linux_install]]
* [[Template: Troubleshooting_linux]]

[[Category: Linux]]

Ubuntu install

2011-07-07T17:07:29Z

Koshi: adds mention of 11.04

[[Linux|Linux Setup Guide]] < {{FULLPAGENAME}}

__TOC__
[[Image:Ubuntulogo.png]]

packages are available for: 11.04, 10.10, 10.04, 9.10, 9.04, 8.10

For packaging requests or complaints, please contact [[Linux:Packaging#Ubuntu | the packagers]].

= Ubuntu 9.10 and newer =

10.04 & 10.10 have propretary drivers for ATI & Nvidia GPU's in the menu aplication / system / additionnal drivers (they are not free but mandatory if spring is very slow and the ground of the map ingame is full white );
ATI catalyst config panel ask password for be edited but always get a bad password error for open it it need to open console and write :" sudo amdcccle "then that will ask the password and accept it

== Installation Instructions ==
Go to ''Applications - Ubuntu Software Center'', search for ''springlobby'' and click go.
If you want to be able to play online, see [[#Updating to newer releases|the next section]].

== Updating to newer releases ==
Go to ''System - Administration - Software Sources'', click the Other tab, click ''Add''. Type '''ppa:spring/ppa''' and close the window. Allow it to reload the packages, and you will find the new version of Spring and Spring Lobby in update manager.

If you're running Ubuntu 10.10, see "Missing repositories in Ubuntu 10.10 on this help page for software sources: https://help.ubuntu.com/community/Repositories/Ubuntu.

= Ubuntu 9.04 and 8.10 =
We now have a maintained and up to date APT repository for Ubuntu 9.04 (Jaunty) and 8.10 (Intrepid). If you have some older version of Ubuntu, you can easily upgrade with these instructions: http://www.ubuntu.com/getubuntu/upgrading.

You will need to add the Spring PPA below and install the ''springlobby'' package. Or you can upgrade to Ubuntu 9.10 and just install the ''springlobby'' package from the new Software Center.

== Installing the repository key ==
First, we need to add the Launchpad PPA package-signing key; this allows Ubuntu to know the packages have been provided by the right people can can be trusted to be installed. If you skip this step then Ubuntu will complain about an unverifiable package every time there's an update for Spring.

Go to:
[http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0xFC66403D8670A035]

Cut and paste the page contents to a file called ''ppa-spring.pgp'' or something recognizable like that. Do not use ''Save As'' in your browser, as this will likely not work because of added HTML formatting. You can use ''Applications - Accessories - Text Editor'' to copy&paste into and save to disk.

Security-conscious people can go to the Spring Developers PPA page at [https://launchpad.net/~spring/+archive/ppa launchpad.net] to verify that the key mentioned above is indeed the right one to trust.

Now go to ''System - Administration - Software Sources'' and click on the ''Authentication'' tab to add the saved ''ppa-spring.pgp'' with the ''Import Key File'' button. The new key should now pop up in the list.

== Installing the repository ==
In ''System - Administration - Software Sources'', click on the ''Third-Party Software'' tab. Then, click the ''Add'' button, and paste one of the two lines corresponding to your Ubuntu release (9.04 or 8.10).

'''Ubuntu 9.04 "Jaunty Jackalope"''':
<code><pre>
deb http://ppa.launchpad.net/spring/ubuntu jaunty main
</pre></code>

'''Ubuntu 8.10 "Intrepid Ibex"''':
Note: Please note if out of date. (It i easy enough to try.)
<code><pre>
deb http://ppa.launchpad.net/spring/ubuntu intrepid main
</pre></code>

Close the dialog, and click on ''Reload'' when it asks.

After that is done, you can just [http://springoo.mooo.com CLICK HERE TO INSTALL EVERYTHING]. Alternatively, you can head to ''System - Administration - Synaptic Package Manager'', and search for ''spring''. For the bare essentials, you will need to install the ''spring-engine'' and ''springlobby'' packages.

SpringLobby can be found in ''Applications - Games'' after install. (Please note that you also need mods and maps to play. The easiest way to get them is to download them from within SpringLobby itself.

= Alternative installation using the terminal =
Press ''Alt-F2'' to run a command. Enter:

<code><pre>
gksudo -- wget -O - "http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0xFC66403D8670A035" | \
apt-key add -
</pre></code>

This will add the Spring-Developers PPA package-signing key to the list of keys that Ubuntu should trust for software packages. (See above for more info).

Then do:
<code><pre>
gksudo gedit /etc/apt/sources.list.d/springproject.list
</pre></code>

Copy and paste the following into the file:

'''Ubuntu 9.04:'''
<code><pre>
deb http://ppa.launchpad.net/spring/ubuntu jaunty main
deb-src http://ppa.launchpad.net/spring/ubuntu jaunty main
</pre></code>

'''Ubuntu 8.10:'''
<code><pre>
deb http://ppa.launchpad.net/spring/ubuntu intrepid main
deb-src http://ppa.launchpad.net/spring/ubuntu intrepid main
</pre></code>

Save the file. You can then either use the graphical package manager Synaptic (''System - Administration - Synaptic Package Manager'') and search for ''spring'' related packages, or just install spring from a terminal using:
<code><pre>
sudo apt-get update
sudo apt-get install spring spring-maps-default
</pre></code>

== Other information ==
You can view the web page for the repository [https://edge.launchpad.net/~spring/+archive here]. Additional packages (such as one for Kernel Panic) are there as well.

The package installs the Spring executable at <code>/usr/games/spring</code> and read-only data in <code>/usr/share/games/spring</code>.

= See Also: =
* [[Template: Finalizing_linux_install]]
* [[Template: Troubleshooting_linux]]

[[Category: Linux]]

Project proposals

2011-03-03T09:55:25Z

Koshi:

[[Image:GSOC.png]]

= Project proposals =

This is the list of project ideas for students willing to work on the Spring engine during the Google Summer of Code 2011. If you wish, you may read our [[Google_Summer_of_Code_2011_student_application|student application]].

== Limited play area ==

Estimated difficulty: '''medium'''

Spring uses a finite-world model, where the scene has distinct bounds that all actors must obey.
Current Spring map formats have a hardcoded rectangle boundary geometry; they also provide very limited support for defining aesthetics of the surrounding environment outside the play area.

The new system should allow the map's developer to restrict the playable area to a subset of the global area, possibly adding support for multiple shapes and/or non rectangular shape restrictions.

The restriction shapes should be readable and changeable mid-game through the engine's Lua API. Proper handling of units which are suddenly off-map needs to be implemented.

'''Details:''' [[GSoC_Limited_play_area]]

== Sensor handling redesign / simplification ==

Estimated difficulty: '''hard'''

Currently there are a number of different "sensor" systems in the engine: LineOfSight, Radar, Sonar, and Seismic.
Some sensors can be jammed, some cannot. Some respect terrain, and some are always circular in coverage.

A new sensor system should integrate the current LOS, Radar, Sonar, Seismic systems into a streamlined codebase, to reduce amount of code in each implementation, and it should add additional features which would then be available for all types, while improving efficiency where possible.

Preferably all this should also be faster than the current system or a compelling argument/experiment should be made that shows there cannot be a faster system with the same features.

'''Details:''' [[GSoC_Sensor_handling_redesign]]

== Engine level abstraction of resources ==

Estimated difficulty: '''medium to hard'''

The Spring engine has its roots in an older Real-Time Strategy title, where only two resources were incorporated into the game design.
The current resource system is largely present in the codebase being hardcoded in a lot of critical places.

The old system needs to be replaced, the new one should be flexible enough to reproduce everything that the old system did and be able to imitate the behaviour of most common RTS game titles.

The engine's Lua API to fetch resources will have to be adapted to the new system, and new calls will have to be added to it.

'''Details:''' [[GSoC_Engine_resource_abstraction]]

== Basic ingame lobby ==

Estimated difficulty: '''hard'''

All existing Spring interfaces (lobbies) are either difficult to customize for game developers or have a different look and feel from the game itself and require focus switch from the game itself to operate.

A new lobby should be implemented with customization and control in mind, using Lua scripting and reusing Spring codebase where possible.
It should be running as a separate process overlaying the game's UI.

Optionally, the engine's start screen should be replaced and integrated with it.

'''Details:''' [[GSoC_Ingame_lobby]]

== Smarter pathfinder ==

Estimated difficulty: '''hard'''

Spring's pathfinder uses a 2d grid and is somewhat limited in functionality.
A partial/full rewrite should be introduced to add support for navigating using more than 8 primary directions and selectively ignore certain unit types for performance reasons.

Spring's Lua API should be extended to allow game developers to push new nodes/links and be able to alter or delete existing ones (for pathfinder-aware tunnels/teleporting/etc.).

Preferably this should all be faster than the current system, or a compelling argument/experiment should be made that shows there cannot be a faster system with the same features.

'''Details:''' [[GSoC_Smarter_pathfinder]]

== More AI interfaces ==

Estimated difficulty: '''medium'''

The Spring engine's AI interface supports bindings for multiple languages, currently C++, C and java are supported.

Bindings for more languages and/or virtual machines should be added to allow broader AI developing audience (for example: Ruby, Perl, JavaScript, Python, D, Go, Mono, LLVM, Parrot).

'''Details:''' [[GSoC_More_AI_interfaces]]

== New Rendering System ==

Estimated difficulty: '''medium'''

The Spring rendering engine uses a lot of FFP (fixed function pipeline) OpenGL functions. This model is becoming deprecated and is generally slower and less flexible than more modern approaches.

Under this proposal, the rendering code should get a complete overhaul using modern graphic programming techniques such as shaders, implement load support for more standardised model formats (backwards compatibility with current available formats is mandatory either through direct load or automatic conversion to the new types) and eventually introduce some graphic enhancing features (bump mapping, normal mapping, multitexturing, etc.).

'''Details:''' [[GSoC_New_rendering_system]]

== Reconnect / Host change during a match ==

Estimated difficulty: '''medium to hard'''

Spring's network model implies the existence of a server to host a battle. For various reasons the network link between host and clients can be interrupted.
A system should be designed to allow manual and/or automatic switching of the game's host (possibly using an existing player after testing load handling capabilities) and manual and/or automatic reconnection from client side if host remains the same.

'''Details:''' [[GSoC_Reconnect_Host_change]]

[[Category:GSoC_2011]]

Google Summer of Code 2010 student application

2011-03-03T09:54:33Z

Koshi: moved Google Summer of Code 2010 student application to Google Summer of Code 2011 student application: new year

#REDIRECT [[Google Summer of Code 2011 student application]]

GSoC:student application

2011-03-03T09:54:33Z

Koshi: moved Google Summer of Code 2010 student application to Google Summer of Code 2011 student application: new year

= Google Summer of Code student application =

# Basics
## Write a small introduction to yourself.
## State your preferred email address.
## If you have chosen a nick for IRC, the Spring forums and the Spring game lobby, what is it?
## Why do you want to participate in summer of code?
## What are you studying, subject, level and school?
## What country are you from, at what time are you most likely to be able to join IRC?
## Do you have other commitments for the summer period ? Do you plan to take any vacations ? If yes, when.
# Experience
## What programs/software have you worked on before?
## Have you developed software in a team environment before? (As opposed to hacking on something on your own)
## Have you participated to the Google Summer of Code before? As a mentor or a student? In what project? Were you successful? If not, why?
## Are you already involved with any open source development projects? If yes, please describe the project and the scope of your involvement.
## Gaming experience - Are you a gamer?
## If you have contributed any patches to Spring, please list them below. You can also list patches that have been submitted but not committed yet and patches that have not been specifically written for GSoC.
# Communication skills
## Though most of our developers are not native English speakers, English is the project's working language. Describe your fluency level in written English.
## What spoken languages are you fluent in?
## Are you good at interacting with other players? Our developer community is friendly, but the player community can be a bit rough.
## Do you give constructive advice?
## Do you receive advice well?
## Are you good at sorting useful criticisms from useless ones?
## How autonomous are you when developing ? Would you rather discuss intensively changes and not start coding until you know what you want to do or would you rather code a proof of concept to "see how it turn out", taking the risk of having it thrown away if it doesn't match what the project want
# Project
## Did you select a project from our list? If that is the case, what project did you select? What do you want to especially concentrate on?
## If you have invented your own project, please describe the project and the scope.
## Why did you choose this project?
## Include an estimated timeline for your work on the project. Don't forget to mention special things like "I booked holidays between A and B" and "I got an exam at ABC and won't be doing much then".
## Include as much technical detail about your implementation as you can
## What do you expect to gain from this project?
## What would make you stay in the Spring community after the conclusion of SOC?
# Practical considerations
## Are you familiar with any of the following tools or languages?
##* Git (used for all commits)
##* C++ (language used for all the normal source code)
##* STL, Boost, Sdl, Lua (C/C++ libraries used by Spring)
##* build environments (eg. cmake, scons)
## Which tools do you normally use for development? Why do you use them?
## What programming languages are you fluent in?
## Would you mind talking with your mentor on telephone / internet phone? We would like to have a backup way for communications for the case that somehow emails and IRC do fail. If you are willing to do so, please do list a phone number (including international code) so that we are able to contact you. You should probably *only* add this number in the application for you submit to google since the info in the wiki is available in public. We will *not* make any use of your number unless some case of "there is no way to contact you" does arise!

Source: [http://wiki.wesnoth.org/SoC_Information_for_Google#Does_your_organization_have_an_application_template_you_would_like_to_see_students_use.3F_If_so.2C_please_provide_it_now. Wesnoth/SoC_Information_for_Google] Thanks Wesnoth!

{{GSoC2010_bottom}}

Project proposals

2011-03-03T09:52:54Z

Koshi: gsoc: inital copy of last years mainpage

[[Image:GSOC.png]]

= Project proposals =

This is the list of project ideas for students willing to work on the Spring engine during the Google Summer of Code 2010. If you wish, you may read our [[Google_Summer_of_Code_2010_student_application|student application]].

== Limited play area ==

Estimated difficulty: '''medium'''

Spring uses a finite-world model, where the scene has distinct bounds that all actors must obey.
Current Spring map formats have a hardcoded rectangle boundary geometry; they also provide very limited support for defining aesthetics of the surrounding environment outside the play area.

The new system should allow the map's developer to restrict the playable area to a subset of the global area, possibly adding support for multiple shapes and/or non rectangular shape restrictions.

The restriction shapes should be readable and changeable mid-game through the engine's Lua API. Proper handling of units which are suddenly off-map needs to be implemented.

'''Details:''' [[GSoC_Limited_play_area]]

== Sensor handling redesign / simplification ==

Estimated difficulty: '''hard'''

Currently there are a number of different "sensor" systems in the engine: LineOfSight, Radar, Sonar, and Seismic.
Some sensors can be jammed, some cannot. Some respect terrain, and some are always circular in coverage.

A new sensor system should integrate the current LOS, Radar, Sonar, Seismic systems into a streamlined codebase, to reduce amount of code in each implementation, and it should add additional features which would then be available for all types, while improving efficiency where possible.

Preferably all this should also be faster than the current system or a compelling argument/experiment should be made that shows there cannot be a faster system with the same features.

'''Details:''' [[GSoC_Sensor_handling_redesign]]

== Engine level abstraction of resources ==

Estimated difficulty: '''medium to hard'''

The Spring engine has its roots in an older Real-Time Strategy title, where only two resources were incorporated into the game design.
The current resource system is largely present in the codebase being hardcoded in a lot of critical places.

The old system needs to be replaced, the new one should be flexible enough to reproduce everything that the old system did and be able to imitate the behaviour of most common RTS game titles.

The engine's Lua API to fetch resources will have to be adapted to the new system, and new calls will have to be added to it.

'''Details:''' [[GSoC_Engine_resource_abstraction]]

== Basic ingame lobby ==

Estimated difficulty: '''hard'''

All existing Spring interfaces (lobbies) are either difficult to customize for game developers or have a different look and feel from the game itself and require focus switch from the game itself to operate.

A new lobby should be implemented with customization and control in mind, using Lua scripting and reusing Spring codebase where possible.
It should be running as a separate process overlaying the game's UI.

Optionally, the engine's start screen should be replaced and integrated with it.

'''Details:''' [[GSoC_Ingame_lobby]]

== Smarter pathfinder ==

Estimated difficulty: '''hard'''

Spring's pathfinder uses a 2d grid and is somewhat limited in functionality.
A partial/full rewrite should be introduced to add support for navigating using more than 8 primary directions and selectively ignore certain unit types for performance reasons.

Spring's Lua API should be extended to allow game developers to push new nodes/links and be able to alter or delete existing ones (for pathfinder-aware tunnels/teleporting/etc.).

Preferably this should all be faster than the current system, or a compelling argument/experiment should be made that shows there cannot be a faster system with the same features.

'''Details:''' [[GSoC_Smarter_pathfinder]]

== More AI interfaces ==

Estimated difficulty: '''medium'''

The Spring engine's AI interface supports bindings for multiple languages, currently C++, C and java are supported.

Bindings for more languages and/or virtual machines should be added to allow broader AI developing audience (for example: Ruby, Perl, JavaScript, Python, D, Go, Mono, LLVM, Parrot).

'''Details:''' [[GSoC_More_AI_interfaces]]

== New Rendering System ==

Estimated difficulty: '''medium'''

The Spring rendering engine uses a lot of FFP (fixed function pipeline) OpenGL functions. This model is becoming deprecated and is generally slower and less flexible than more modern approaches.

Under this proposal, the rendering code should get a complete overhaul using modern graphic programming techniques such as shaders, implement load support for more standardised model formats (backwards compatibility with current available formats is mandatory either through direct load or automatic conversion to the new types) and eventually introduce some graphic enhancing features (bump mapping, normal mapping, multitexturing, etc.).

'''Details:''' [[GSoC_New_rendering_system]]

== Reconnect / Host change during a match ==

Estimated difficulty: '''medium to hard'''

Spring's network model implies the existence of a server to host a battle. For various reasons the network link between host and clients can be interrupted.
A system should be designed to allow manual and/or automatic switching of the game's host (possibly using an existing player after testing load handling capabilities) and manual and/or automatic reconnection from client side if host remains the same.

'''Details:''' [[GSoC_Reconnect_Host_change]]

[[Category:GSoC_2011]]

Finalizing linux install

2010-10-17T11:37:52Z

Koshi: section isn't needed anymore

= Finalizing installation =
You should have Spring installed by now; if not, please see the [[SetupGuide]].

Depending on your distribution/package, you still need a Multiplayer Lobby.
For Linux, the most common one is SpringLobby, which you can get [http://springlobby.info/wiki/springlobby/Install here].

== Maps & Mods ==

Since Spring is only an engine, you need to download games/mods for it, and the maps that go with those games.

SpringLobby will automatically do this for you when you attempt to join a game with a map or mod that you do not currently have, using an integrated downloader.

If you want to download it manually or browse existing maps, there are several easy to use websites:
*[http://spring.jobjol.nl/subcategory.php?id=1 SpringFiles]
*[http://spring-portal.com/ Spring-Portal]
*[http://www.darkstars.co.uk/downloads/index.php?dir=spring Darkstars]

Pick any of those sites, download a map or mod, and then double click it. This will move it to your Spring folder, using the spring map/mod installer program. If you wish to move maps/mods by hand, they are located under <code>~/.spring/maps/</code> or <code>~/.spring/mods/</code> (if the folder does not exist - create it). Do not unpack the file in any way though, just download and save it. Reload your maps/mods in SpringLobby, (''Tools - Reload maps/mods'') and they will be ready to use.

These sites also may provide other neat things like Lua widgets, epic replays, AI bots (for playing offline or to team up on with a friend). Generally the installation requires you to download the file and place it in the appropriate folder in your ''~/.spring'' directory. (you may have to create the folder)

''Hint:'' If you know the name of the map you want, there is a Search function provided in those websites. Just write a part of the name, like one word, and you will easily find the map you were looking for.

Linux:Packaging

2010-08-19T08:06:47Z

Koshi: /* Gentoo */

[[Linux_Page|Linux]] < {{FULLPAGENAME}}

= Linux Packaging =

== Packagers ==

Nicknames and how to best contact them.

=== Ubuntu ===
'''Tobi''' - [http://springrts.com/phpbb/memberlist.php?mode=viewprofile&u=596 Forum:''Tobi''], Lobby:''[RoX]Tobi''

'''det''' - [http://springrts.com/phpbb/memberlist.php?mode=viewprofile&u=1213 Forum:''det''], Lobby:''*det*??''

'''YokoZar''' - [http://springrts.com/phpbb/memberlist.php?mode=viewprofile&u=5670 Forum:''YokoZar''], Lobby:''*YokoZar*??''

=== Debian ===
'''mammadori''' - [http://springrts.com/phpbb/memberlist.php?mode=viewprofile&u=9045 Forum:''mammadori''], Lobby:''*mammadori*??''

'''jandd''' - [http://springrts.com/phpbb/memberlist.php?mode=viewprofile&u=9301 Forum:''jandd''], Lobby:''*jandd*??''

=== Slackware ===
(no one)

=== Mandrive ===
(no one?)

=== OpenSuSe ===
'''Agon''' (retired) - [http://springrts.com/phpbb/memberlist.php?mode=viewprofile&u=5514 Forum:''Agon''], Lobby:''*Agon|*Marcel''

=== Fedora ===
(unknown)

=== Gentoo ===
'''Auswaschbar''' (retired?) - [http://springrts.com/phpbb/memberlist.php?mode=viewprofile&u=5613 Forum:''Auswaschbar''], Lobby:''*Auswaschbar''

'''iElectric''', #sy@quakenet:''iElectric''

== Guidelines ==

''Note:'' This section is only of interest for Linux package maintainers.

Here we outline the packaging scheme currently recommended by the engine development team.

=== Binary Distros ===

We recommend using <code>CMAKE_BUILD_TYPE=RELWITHDEBINFO</code>, and later splitting the debug symbols off into separate files with a command line this:

<code>##STUB##</code>

'''main packages (''package'' ~ ''deps''):'''
<pre>
springrts-gamedata
springrts-engine-default ~ springrts-gamedata
springrts-engine-default-dbg ~ springrts-engine
springrts-engine-dedicated
springrts-engine-dedicated-dbg ~ springrts-engine-dedicated
springrts-engine-multithreaded ~ springrts-gamedata
springrts-engine-multithreaded-dbg ~ springrts-engine-multithreaded
springrts-engine-headless ~ springrts-gamedata
springrts-engine-headless-dbg ~ springrts-engine-headless
springrts-unitsync ~ springrts-gamedata
springrts-unitsync-dbg ~ springrts-unitsync
</pre>

'''meta packages:'''
<pre>springrts-engine ~ springrts-engine-default springrts-engine-multithreaded
springrts-engine-dbg ~ springrts-engine springrts-engine-default-dbg springrts-engine-multithreaded-dbg
springrts ~ springrts-engine unitsync
springrts-dbg ~ springrts springrts-engine-dbg unitsync-dbg
</pre>

=== Source Distros ===

<pre>
springrts [default -dedicated -headless multithreaded unitsync]
</pre>

SmuG Works

2010-03-13T22:11:33Z

Koshi: fix category

[http://spring.clan-sy.com/phpbb/viewtopic.php?t=8428&highlight=smug Smug Guide to Running Your Boy]
[[Category: Strategy]]

XTA Clans

2010-03-13T21:40:32Z

Koshi: fix category

List of active clans and their members:

'''[CoX]''' Commanders of XTA:

Babbles "My Commander is the army" 
Tribulex "I have the perfect strat for ONE MAP!" 
FrozenLegacy "Sorry, Frozen has self destructed, come again later" 
Jools "Do you want some mines with that?" 
Ansiktsburk "Allies losing, need to tech faster!" 
Malric "My gf won't let me play :(" 
Scifi "I'm modding, go away" 
Jimjoe "Stop talking about my mum, Shift" 
V1ntage "I'm really bad!" 
Shift "UKRAINE IS JOKE TO YOU?!" 
Punarbhava "I'm too out of it to care" 
Snel "I'm the only good Swedish player really"

'''[CoW]''' Core of War:

Manolo "Less playing, more speccing!" 
Seba "1v1?" 
TheMightyOne "It hasn't failed me the first 9000 times, so it won't now!" 
FlorisXIV "I have more smurfs than ingame minutes" 
Error232 "I'm rusty, I swear!" 
Kloot "HLT here, HLT there" 
HermuldXV "cow says mooh" 
Jim Hatama "No-one knows who I am" 
Ray "I hate people who are better than me; I love CoW"

'''[RoX]''' Rogues of XTA:

Janid "I love my crashers like my children" 
Tobi "I got bored of doing everything" 
John "My AK beats your AK" 
Pintle "Hey, didn't my clan used to be good?" 
1v0ry_k1ng "I haven't actually played, but I know the balance better than you" 
PhreakY "I'm riding on knowing Pintle"

'''[SIN]'''

Basic "Everything is OP unless I say otherwise" 
el_barto "Barto timed out before he could be quoted" 
Creed "I'm not Admin!!" 
DearLordAnimal "I am but one of many" 
DojeH "Every low ranking German player is me"

[[Category:Xta]]
[[Category:Clans]]

Category:NOTA

2010-03-13T21:33:31Z

Koshi: fix category

[[Category:Mods]]

Expand & Exterminate

2010-03-13T21:32:54Z

Koshi: fix category

<center>[[Image:E&E-wikiheadline.png]]</center>

<center>'''Expand & Exterminate'''</center>
<h3><center>'''The struggle for the blue planet '''</center></h3>
 
<h3><center>'''.152 RELEASED! CHECK THE LINK SECTION '''</center></h3>

Overview
 
[[Image:E&E-screenshot2.jpg|thumb|200px|right|URC units outside a GD stronghold.]]

[[Image:E&E-screenshot.jpg|thumb|200px|right|A well defended GD stronghold.]]

The new and exciting mod Expand and Exterminate offers three very unique and dynamic factions fighting for global domination. Each faction has its own design and fighting style that requires players to employ thier own style of combat to defeat opponents. All three teams also have thier own unique super weapons that offer great strategic difference. Expand and Exterminate is set in the near future that includes many futuristic and even alien-like vehicles for combat.

<dl>Faction Overview </dl>
 
[[IMAGE:E&E-GD.png]]
<dt>Global Dynasty </dt> <dd>A tank force that uses brute force to push through enemies. GD has the strongest units and nuclear weapons but have higher costs and build times. Thier airforce consists of helicopters.</dd>

[[Image:E&E-URC.png]]
<dt>United Robot Confederation</dt> <dd>Enforces control through walking mechanized units that use stealth and versatility to attack. URC units are the best at climbing hills and can navigate high terrain better than any other faction. Thier airforce consists of Vtols.</dd>

[[Image:E&E-NI.png]]
<dt>New Initiative </dt> <dd>Utilizies heavy amounts of hovercraft and aircraft to swiftly move and attack enemies, great for raiding. Includes best airforce of all three factions. </dd>

===Strategy===
 

GD

In this guide you will learn how to utilize the GD's greatest attribute: staying power, and minimize their weakness: lack of mobility.

# STAYING POWER - GD units generally have more armor, better range, and greater firepower than the combat units of the other factions. This allows GD tanks to form a line and focus fire on incoming enemies. GD also has better artillery than the other factions.

# LACK OF MOBILITY - GD basic mexes give energy, so you won't need to build a reactor immediately. GD also may construct armed mexes, allowing them to more easily hold territory and making raiding difficult. Armed mexes combined with the rapid deployment of units via air transports helps minimise GD's lack of mobility. GD light tanks can climb fairly well, lvl2 tanks have more difficulty, lvl3 tanks have horrid climbing ability.

GD is all about brute force; avoid your enemies' emplacements if you can, but you can likely roll right over them.

URC

In this guide you will learn how to properly combine the URC's best attributes, agility and stealth.

# AGILITY - To begin, when using the URC faction its best to take advantage of thier ability to climb steep slopes and mountains. There are a number of ways to utilize this advantage as you have the ability to attack from angles no other faction can. Its advised that when possible that you should attack from the steepest ground possible as GD and NI units will usually not be able to follow you and your units will gain greater firing range. But most important to URC strategy is the potential for invading bases by avoiding defenses. While GD shoves through defenses and NI runs through it, the URC can completly ignore it by going through high terrian to suprise attack an opponent's base. If the high terrian is steep enough, youre assured that neither GD or NI can build defenses on thier hills or mountains around thier base.

# STEALTH - The URC are the only faction to have units that cloak. During early game after you have put up your small economy and unit factory use spiders (cheap, cloakable spy unit that can build cameras and mines. LV1) very early in game to put cameras around key positions and to observe enemy bases. A good objective to keep in mind is to use this unit as your eyes and ears to basically monitor your enemies base for an undefended route that you can use late game to invade. Be sure to build a few battle mechs and a couple construction mechs afterwards to properly expand in early game. During middle to late game, you can use your level two factory to produce a variety of medium strength attack mechs that can both cloak and jam radars. At the cost of this ability however these mechs are more expensive and less strong than its non-stealth counterparts. Therfor its advised to use these units in small raiding parties to disrupt and destroy the oponnents economy. Do not mainly focus them on aiding your main armies in combat as its not cost effective, they are best used for suprising un-protected bases.

As URC you have many options open to you in conquest. Even though I have written guidelines for a suggested play style, you can still win without using stealth and agility, its entirely up to your gameplay style. You may find that using URC as brute force works better for you, as they can operate a highly strong head on function in proper numbers. Whatever your style is, URC can probably fit into it.

 
 
[[Image:E&E-screenshot3wide.jpg|702px|center|]]

=== Links ===
 
*'''[http://www.fileuniverse.com/?p=showitem&ID=3065 Download Link ]'''
 
*'''[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=4381&postdays=0&postorder=asc&start=0 Expand & Exterminate Thread ]'''
 
*'''[http://taspring.clan-sy.com/wiki/EEclan Expand & Exterminate Clan ]'''
 
===Credits===
 
<h3>Mod Creation</h3>

Fang - Tirelessly created all of E&E, scripted, textured modeled and sounds.

<h3>TA: WD</h3>

Ground Zero - Provided models and sounds

Maestro - Provided models and sounds

<h3>Gundam Annihilation</h3>

Smoth - Scripting and modeling advice

<h3>Final Frontier Team</h3>

Dopefishhh - Predator Concept

Longbow - Exploding turrets, duplicating scripting effects

M. Kenyon - Battlestation script

Savant - Models

<h3>The Lost Legacy Team</h3>

M3G - Provided textures, sounds and models

<h3>Additional Help</h3>

Flintlock - Promotional/Biography/Wiki/Graphic Designs

Decimator - Wrote GD Strategy

<h3>Testing </h3>

<dt>Alpha </dt> <dd>(Big Steve, Cabbage, Das Bruce, Dave the Brave, Decimator, Drexion, Guilty Spark, Over Damage, Forboding Angel, Flintlock, J5mello, Smoth, Tenebrous, Wasp, )</dd>

 

<dt>Beta </dt> <dd>(WarhammerC, Cronyx, Aun, WarC, Emmanuel, Drone_Fragger, Azu(Azn))</dd>

[[Category:Expand_and_Exterminate]]
[[Category:Games]]

Category:Expand and Exterminate

2010-03-13T21:32:14Z

Koshi: fix category

[[Category:Games]]

FirsttimeEE

2010-03-13T21:31:36Z

Koshi: fix category

When you joined the battleroom you were like ''"yea iam so pro right"'' but now you are no longer so sure? 
The game is about to begin and there is too little time to read the whole wiki-page about E&E? 

So here comes the ultra-easy guide: 

==Which side do I want to play?==
 
For the beginner GD is probally better. 
Their units are tanks and everybody knows what tanks are good for. 

==What buildings should I construct first?== 
1) Start next to a group of metalspots. Press F4 if you can not see them.
 
2) Use your Commander to build at least '''3 metal extractors'''. 
You can que the buildorders up by holding shift if you want to. 
Note how the GD metalextractors also produce some energy.
 
3) Now comes the tricky part: In E&E, factories are built by '''constructions-hubs'''. 
So use your Commander to build one of those.
 
4) Use the construction hub to build a '''light factory'''. 
The Commander can speed this up if you rightclick him on the factory while it is built.
 
5) Your Commander can now leave the startarea to build some '''more metalextractors.''' Pay attention that you do not drive too far away because he has no weapons!
 
6) When the factory is done, order the hub to build a '''Nuclear Power Plant''', because you when you start producing tanks your factory will drain more energy.
 
7) Also build a '''Radar''' using the hub, it will tell you about enemy activity in its area. 
 

After the first minutes your base should look like this: 
[[Image:EE_startbuildorder_GD.JPG]]

 

Now you are ready to produce some tanks for attack or defense! 
But... 
==What units should I build with my first factory?== 
1) Build one or two '''Scouttanks'''. 
They are only armed with a small machinegun but you can use them to search for the enemy and maybe kill some of his metalextractors. 
Also, try using them to build a fieldradar (or a hidden camera) in the enemy territory. This can prove very usefull. 
2) Build some '''Battletanks''' to guard your commander while he wanders around and builds metalextractors. 
3) Use construction units to expand across the map and start raids against the enemy! 
4) Building a Energystorage and a Metalstorage can be life-saving when your Commander gets killed. 

'''Advanced Notes:''' 
-Don't be a victim of the airrush! 
Construct a flakturret at your factory and some more all around the map. 
Almost all units can shoot at planes, but they usually miss. 
-When your metalincome is bigger than ~20, '''construct a second factory!''' 
Building more Hubs and using them as Nanotowers alÃƒÂ¡ BA will not speed up production. 
-The constructions vehicles can also build waterstructures 
-There are '''no metalmakers.''' So the more land you controll, the more metalextractors you can build. Easy. 
 

This is not suppossed to be a page where you can read about supersecret supertactics. 
It is for all these people who do not know what a hub is and who spend their money by building random stuff in front of their allies factories or are asking why the dgun is broken.
[[Category:Expand_and_Exterminate]]

OpenSUSE install

2010-03-13T21:27:47Z

Koshi: fix category

A list of various packages for openSUSE and other distributions related to spring are located here:[http://download.opensuse.org/repositories/home:/accAgon/]

openSUSE wiki for spring: [http://en.opensuse.org/Spring]
[[Category: Linux]]

URC Unit Guide

2010-03-13T21:26:48Z

Koshi: fix category

==Level One: Land==

'''Grasshopper: Light ECM Mech'''

Capable of projecting a small scanner interference field, the Grasshopper is capable of protecting a small squadron of bots against enemy radar.

'''Spider: Light Plasma Mech'''
[[Image:Spider.jpg|left|100px]]
Sporting a four legged chassis and two light plasma weapons, the Spider is a deadly tool. Weaker, armor wise, than GD tanks, the Spider is faster and more maneuverable, capable of mounting hills and other forms of difficult terrain.

'''Fire Ant: Flame thrower Mech'''
[[Image:FireAnt.jpg|left|100px]]
Fast, deadly, and short ranged, the Fire Ant is a quick raider that is capable of burning down enemy bases with unprecedented speed. They're armor is weak, so getting them into the fight can be a problem, but at close ranges, the Fire Ant is a deadly mech.

'''Cricket: Light rocket mech'''
[[Image:Crickit.jpg|left|100px]]
Using the Spider chassis, the Cricket has switched the plasma pods for a rocket pod capable of firing arching missiles that have a high area of effect. Use these to back up the direct fire of your Spiders.

'''Fly Trap: SAM mech'''
[[Image:FlyTrap.jpg|left|100px]]
Using the Spider chassis, the Fly Trap has switched the plasma pods for a Surface to Air Missile pod. The Fly Trap is able to take down enemy helos with disturbing efficiency, though heavier helicopters can withstand its fire for longer, tough repeated shots can even bring down a level 3 GD heli after a while.

'''Stink Bug: Light Mortar Mech'''
[[Image:StinkBug.jpg|left|100px]]
The Stink Bug is not as powerful as the GD's artillery. The Spider frame is simply not big enough to handle the kick back from anything stronger than a light mortar. That, coupled with the GD's heavier armor, makes the Stink Bug seem ineffective. But they, like all URC mechs, are cheap enough to be built en mass, and their long range support is still very useful.

'''Lice: Stealth Plasma Mech'''
[[Image:Lice.jpg|left|100px]]
The Lice is nothing more than a Spider mech with a single add on. But when that add on is the Optical Camoflague Jamming System or OCJS, its an add on that can tilt the balance of battle. Completely invisible, for all intents and purposes, a few Lice can sneak through the enemy's lines and devastate and unsuspecting base.

'''LFC Mech: Light Field Construction'''
[[Image:LFCM.jpg|left|100px]]
The LFC is equipped with a Field Construction Set (FCS) capable of cranking out Level 1 structures and turrets. The LFC is also capable of building the next generation of HUB, allowing the URC to move up to the next level of technology.

'''Tick: Scout Mech'''
[[Image:Tick.jpg|left|100px]]
Equipped with a specialized FCS and a OJCS, the Tick is capable of building Recon Poles, very small land mines and perimeter cameras. Use these to shore up your defenses, keep an eye on your enemy and generally be a nuisance.

==Tales from the Front==

September, 24, 3129. Alaskan Defense Campaign. 22 Km East of the Siberian Land Bridge.

XZ-229. The name was printed under the Spider in probably the most inconvenient place imaginable. Which made it a freaken pain for someone (like me) to find the one that wasn't working. So who had thought that up? Maybe some stupid Compy that thought that names would help the enemy identify the spiders that had improved their programming using battlefield experience.

Yeah, it had blown my mind when they had let that out. Now not only were our armies bloodless, but they also learned from every engagement. Becoming better.

I slid out from under this Spider (XZ-331) and moved to the next one in line. The report had said, Ã¢â‚¬Å“Erratic Algorithmic BehaviorÃ¢â‚¬Â but it hadn't said what or where. Maybe using too much ink for a human was a 'inefficient'

Ã¢â‚¬Å“Damn it, where are you?Ã¢â‚¬Â I muttered. One of the Spiders stepped out of line, it's footsteps echoing loudly in the factory. I looked at it and glimpsed, under one of it's legs, the lettering Ã¢â‚¬Å“XZ-229Ã¢â‚¬Â.

Ã¢â‚¬Å“There you are-Ã¢â‚¬Â I started. 229 opened fire. Bolts of plasma slammed into the wall of the factory and I staggered as a wave of cold air hit me. The Alaskan night filled the room as 229 walked out of the factory wall.

It got as far as the defense perimeter of our base. I saw a plasma turret turn it's barrels on the 229 and fire. The faulty unit exploded violently and a LFC walked up. It started to spray a protective polymer over the side of the wall.

Ã¢â‚¬Å“Well...my work here is done,Ã¢â‚¬Â I muttered, picking up my tool kit and walking out of the factory.

==Level One: Air==

'''Gnat: Sonar/Radar VTOL'''
[[Image:Gnat.jpg|left|100px]]
Though completely unarmed and unarmored, the Gnat is still a useful asset to your aerial forces. Capable of extending your radar and sonar ranges, the Gnat is able to spot enemy forces at longer ranges than simple scouts.

'''Fly: Interceptor VTOL'''
[[Image:Fly.jpg|left|100px]]
A deadly little fighter, the Fly is capable of taking down enemy aircraft with deadly missile barrages.

'''Bumble Bee: Ground Attack VTOL'''
[[Image:BumbleBee.jpg|left|100px]]
A small VTOL armed with two small plasma cannons, the Bumble Bee is a swift attack vehicle, capable of harassing the enemy's forces.

==Tales from the Front==

October 14th, 3157 AD. Indonesian Retreat. 15 Km East of the Coral Sea

I looked at the map...and wondered if this war could get any worse. If only I knew. This was what the 'book' called a 'Tri-engagement'.

Its what I called a Level A Crash Up. The computers had computed a 78% chance that our bots could drive the GD into the sea and destroy them, giving us Australia. And, for half a year, it had worked. We had pushed the GD out of Sydney, the Abo-zones and the bitox villages. Then the strangers had shown up.

Calling themselves the New Initiative, they hit both of us and the tankers...hard. I had been airlifted out of our forward base in a hurry. Now that had been frightening. When I lose a battle, normally the worst thing that happens is some of our robos get destroyed and we lose territory. Not like the barbarians...if they lost, they lose men and women. Ugh. Made me shake when I think about it.

But this time it had been scary. The VTOL had lifted into the air, fifteen or so Flies covering it. The NI's weird hover craft started to breach the outwards defenses. Plasma shots were smashing into them and I was heartened to see that yes, they did die.

Then lighting struck. The front three NI tanks opened fire and lighting arced from their weird guns. The plasma turrets exploded and the base's entire left flank was left wide open. More NI hover tanks began to fill the base and I turned away. No sense getting worked up over destroyed parts and pieces.

Ã¢â‚¬Å“Sir,Ã¢â‚¬Â A computerized voice said. Ã¢â‚¬Å“Expect incoming turbulence.Ã¢â‚¬Â

I looked up from the map. The VTOL shook and I wondered who was shooting at us, the GD or the NI. Did it really matter? I glanced back at the map. The radar said 'unknown aerial targets'. NI.

The craft shook some more and I glanced out the window. I caught a glimpse of something smooth, silvery and very fast. Maybe being airlifted wasn't enough. Then I saw a missile impact in the side of the silvery thing and it exploded, falling out of the air.

Ã¢â‚¬Å“Nice shot boys,Ã¢â‚¬Â I murmured. Then a Helicopter flew past, marked with red and green.

I glanced back at the map. GD dots were falling on NI dots. I grabbed my command stylus and tapped the map a few times. URC dots started to move in as well, a few bots I had kept in reserve. The VTOL shook again and I heard a missile streak past.

A glance out the window showed a Fly blowing apart a GD helo. I grinned. The Gnat was then struck by a strange blue sphere, fired from a NI fighter.

Ã¢â‚¬Å“Now it gets interesting,Ã¢â‚¬Â I mutter, tapping my stylus some more.
[[Category: Mods]]

Hosting Spring/Springie

2010-03-13T21:25:37Z

Koshi: fix category

{{Tutorial}}
[[Springie]] is an Autohost for Spring, it creates a battleroom and starts automatically when enough people have joined. It also reacts to a number of chat commands.

==Requirements==
*Spring
*Open UDP Port
*Springie

==Using==
Springie is easy to use but you will need an open UDP port to be able to host a game. You can download it using the link at the end of the page, no install is required.

===Creating===
After opening an UDP port, you need to create a new account for the bot and ask a GO (Game Operator) to put a bot flag on it. Now you only need to log in with Springie and configure the map and other settings!

'''''Note:''' Spring changes Spring settings to 40 x 40 pixels and windowed mode, so if you want to play you will need to reconfigure it.''

===Commands===
'''HELP''''

*!help - lists the commands that are available to you
*!helpall - lists all commands (sorted by their level) - you may not be able to use all of them

'''COMMUNICATION'''
*!ring [<filters>..]- rings either all unready or specified users
*!say - allows you to talk between lobby and game (not needed if chat is enabled)
*!notify - Springie will notify you when game ends

'''TEAM AND ALLY MANAGEMENT'''
*!fix - fixes teamnumbers
*!fixcolors - fixes team colors (similar colors are changed)
*!random [<allycount>] - assigns people to <allycount> alliances (default: 2 alliances)
*!balance [<allycount>] - scans all ally combinations and randomly chose one which is balanced (eg regarding ranks) (warning: not tested for large teams, might take a long time)
*!cbalance [<allycount>] - assigns people to allycount random balanced alliances, attempting to put clanmates on the same alliance
*!ally <allynum> [<player>..] - forces ally number
*!team <teamnum> [<player>..] - forces team number
*!spec <username> - forces a player to become spectator
*!specafk - forces all AFK players to become spectators

'''GAME CONTROL'''
*!start - starts game (checks for duplicate team numbers and ally fairness)
*!forcestart - overrides ordinary !start checks (duplicate team numbers and ally fairness)
*!force - makes spring force start (ctrl+enter in-game)
*!exit - exits the game
*!manage <minplayer> [<maxplayers>] - automanage game for min to max players. If minplayers is 0, it won't manage. In this mode, Springie keeps alliances even, colors fixed, autorings and spec afk or even kicks them.

'''VOTING'''
*!voteforcestart - starts vote to execute !forcestart
*!voteforce - starts vote to force (in-game)
*!voteexit - starts vote to exit game
*!votekick [<filters>] - starts vote to kick player
*!votemap [<filters>] - starts vote for given map
*!voterehost [<filter>] - starts vote to rehost the game
*!votepreset [<presetname>..] - starts a vote to apply the given preset
*!voteboss <name> - sets <name> as a new boss, use without parameter to remove any current boss. If there is a boss on server, other non-admin people have their rights reduced
*!votekickspec - starts a vote to enables or disable automatic spectator kicking
*!votesetoptions <name>=<value>[,<name>=<value>] - starts a vote to apply the given option(s)
*!vote <number> - casts your vote (you must say it in battle window)
*!endvote - ends current poll

'''BATTLE LOCKING'''
*!lock - locks battle
*!unlock - unlocks battle
*!autolock [<players>] - sets desired number of players in game. If this number is reached, Springie will lock the server, and if someone leaves, it will unlock it again. !autolock without parameter disables auto locking.

'''PRESETS'''
*!listpresets [<presetname>..] - lists all the known presets (with name filtering)
*!presetdetails [<presetname>..] - shows the details of the given preset
*!preset [<presetname>..] - applies the given preset to current battle

'''BOXES'''
*!addbox <left> <top> <width> <height> [<number>] - adds a new box rectangle
*!clearbox [<number>] - removes a box (or removes all boxes if no number is specified)
*!split <"h"/"v"> <percent> - makes 2 boxes in h or v direction
*!corners <"a"/"b"> <percent> - makes 4 corners, a/b determines ordering

'''MAPS'''
*!listmaps [<filters>] - lists maps (can apply filtering)
*!map <filters> - changes map, and prints the new maplink in the battle
*!maplink - looks for map links on unknown files
*!dlmap <mapname/dllid/url> - downloads map to server. You can either specify map name or map id (from unknown files) or map URL

'''MODS'''
*!listmods [<filters>] - lists mods (can apply filtering)
*!modlink - looks for mod links on unknown files
*!dlmod <modname/dllid/url> - downloads mod to server. You can either specify mod name or mod id (from unknown files) or mod URL
*!rehost [<filter>] - rehosts game (optionally with new mod)
*!listoptions - lists all mod options
*!setoptions <name>=<value>[,<name>=<value>] - applies mod/map options

'''ADMINISTERING'''
*!admins - list privileged users
*!boss <name> - sets <name> as a new boss, use without parameter to remove any current boss. If there is a boss on server, other non-admin people have their rights reduced.
*!kick <filters> - kicks specified players from server (both game and lobby)
*!setlevel <username> <level> - sets rights level for given player
*!ban <username> [<duration>] [<reason>...] - bans user username for duration (in minutes) with given reason. Duration 0 = ban for 1000 years
*!unban <username> - unbans user
*!listbans - lists currently banned users
*!reload - reloads mod and map list
*!kickspec [0|1] - enables or disables automatic spectator kicking
*!mincpuspeed <GHz> - sets minimum CPU for this host - players with CPU speed below this value are auto-kicked, 0 = no limit
*!setpassword <newpassword> - sets server password (needs !rehost to apply)
*!setminrank <minrank> - sets server minimum rank (needs !rehost to apply)
*!setmaxplayers <maxplayers> - sets server size (needs !rehost to apply)
*!setgametitle <new title> - sets server game title (needs !rehost to apply)
*!springie - displays basic springie information
*!cheats - enables/disables .cheats in game

'''STATISTICS'''
*!stats - lists various stats
*!smurfs - lists smurfs

==Links==
*[http://spring.clan-sy.com/phpbb/viewtopic.php?t=7921 Springie Topic]
[[Category: Using_Spring]]

Hosting Spring

2010-03-13T21:25:23Z

Koshi: fix category

==Hosting==

==Autohosting==
There are some autohosts, programs which can be run on a secondary computer to provide a bot-controlled automated hosting enviroment, available for Spring.

=== Springie ===
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=7921 Licho's Springie Autohost]
*[[LINUX:SetupSpringie|How to setup Springie]]
*[[Hosting Spring/Autohost|How to use Springie]]

=== SPADS ===

*[http://springrts.com/phpbb/viewtopic.php?f=1&t=17130 SPADS AutoHost]
*[http://planetspads.free.fr/spads/doc/spadsDoc.html Commands and settings reference guide]
*[http://planetspads.free.fr/spads/conf/templates/ Configuration templates]
*[http://planetspads.free.fr/spads/conf/samples/ Advanced configuration samples]
*[http://planetspads.free.fr/spads/repository/CHANGELOG Detailed changelog]
*[http://planetspads.free.fr/spads/repository/UPDATE Manual update guide]
[[Category: Using_Spring]]

General Resources

2010-03-13T21:25:11Z

Koshi: fix category

[[Engine_Development|Development]] < General Resources

=Textures=
[http://springrts.com/phpbb/viewtopic.php?t=7093&start=0 Texture Competition 0001 - Metal] 
[http://springrts.com/phpbb/viewtopic.php?t=7188&start=0 Texture Competition 0002 - Camo] 
[http://springrts.com/phpbb/viewtopic.php?t=7731 Texture Competition 0003 - Stone/Concrete] 
[http://www.cgtextures.com/ CG Textures]

=Code=
[http://springrts.com/phpbb/viewtopic.php?t=7457 GPL Code Repository] 
[http://springrts.com/phpbb/viewtopic.php?t=6569&postdays=0&postorder=asc&start=0 The Millionth Monkey Gets Its Typewriter - Movement Optimization]

=Sounds=
[http://freesound.iua.upf.edu/ Freesound] free sounds and samples, distributed under the [http://creativecommons.org/licenses/sampling+/1.0/ Creative Commons License]

=Features=
[http://springrts.com/phpbb/viewtopic.php?t=4047 Compilation List of Features for Maps]

=Models=
[http://planet-wars.eu/ModelBase/Units.aspx Model Base]

[[Category: Art_assets]]
[[Category: Development]]

Tech Levels

2010-03-13T21:23:00Z

Koshi: fix category

{{ModSpecific}}
A Tech Level is a group of units that can be built by a certain construction unit.

-There are 3 Tech Levels.-

* Tech Level 1, also sometimes mistaken as Tech Level 0 (May be my fault for this mixup -[[Eaglebird]]), is any unit the [[Commander]] can build. This includes the first resource facilities/collectors, the basic unit plants, the LLT, and the first radar facility available.

* Tech Level 2 is any unit built by the first available unit plants, and any structure built by the first construction units excluding the commander.

* Tech Level 3 is any unit built by a Tech Level 2 unit plant, and any structure built by the advanced construction units.

Tech Level 0: This Tech Level is often disputed, sometimes forgotten altogether, and some call it Tech Level 1, and just move each level down a notch, so the levels go up to 4. Tech Level 0 is assumed to be the [[Commander]] itself, as he is not built by any unit plant, and cannot be ressurrected.

UI commands

2010-03-13T21:22:40Z

Koshi: fix category

[[Engine_Development|Development]] < [[Lua_Scripting|Lua Scripting]] < {{FULLPAGENAME}}

select 
selectunits 
deselect 
shadows 
water 
advshading 
say 
w 
echo 
setf 
seti 
sets 
drawinmap 
drawlabel 
mouse[1-5] 
viewselection 
move[forward, back, left, right, up, down, fast, slow] 
team 
spectator 
specteam 
specfullview 
ally 
group[0-9] 
lastmsgpos 
char[, all, ally, spec] 
track 
trackoff 
trackmode 
showhealthbars 
pause 
debug 
nosound 
volume 
unitreplyvolume 
savegame 
createvideo 
updatefov 
drawtrees 
dynamicsky 
gameinfo 
hideinterface 
hardwarecursor 
[increase, decrease]viewradius 
[more, less]trees 
[more, less]clouds 
speedup 
slowdown 
controlunit 
showshadowmap 
showstandard 
showelevation 
toggleradarandjammer 
showmetalmap 
showpathmap 
yardmap4 (does nothing) 
togglelos 
sharedialog 
quitwarn 
quit 
[inc, dec]guiopacity 
screenshot 
grabinput 
clock 
cross 
fps 
info 
techlevels 
cmdcolors 
ctrlpanel 
font 
aiselect 
vsync 
safegl 
resbar 
tooltip 
console 
endgraph 
fpshud 
mapmarks 
allmapmarks 
luaui 
minimap 
grounddecals 
maxparticles 
gathermode 
pastetext 
buffertext 
inputtextgeo 
lodscale 
wiremap 
setgamma 
crash 
exception 
divbyzero 
give 
send 
save 
atm 
desync (debug only) 
resync 
take 
luarules 
[[Category: Using_Spring]]
[[Category: Lua]]

Mapdev:Howto skybox

2010-03-13T21:21:48Z

Koshi: fix category

[[Engine_Development|Development]] < [[Map_development|Map Development]] < {{FULLPAGENAME}}

==Skybox Information==
This is going to contain notes about the creation of skyboxes aka cubemaps.

Skyboxes are created with a series of 6 separate images which form what we call a cube map. Below is an example of the skybox images that I created for a map.

[[Image:Skyboxsimple.gif|center|this is what we call a cube cross]]

Despite what you will see on many sites you do not need a cube cross for the creation of your skybox. You will be using six individual images. Each image represents a different face on an imaginary cube. Each face is applied to the cube that surrounds the map.

[[Image:Sky1.gif|center|see how each side of the cube is it's own image]]

Here an image is being applied to the cubemap. See how each side of the cube is an image?

== Skybox creation ==

=== Creating your 6 textures ===
You will need six images representing each side of your skybox. I will not go into any specific method of construction. There are tutorials out there for that. Just remember you will need 6 textures, front, back, left side, right side, top and bottom.

=== Creating your dds using the nvidia dds utilities ===
You will need these utilities from Nvidia's website: [http://developer.nvidia.com/object/dds_utilities_legacy.html NVIDIA Texture Tools]

Once you have downloaded and installed the tools you will need to created 2 files:
* '''Compiledds.bat''', and
* '''cubemapfile.lst'''

Inside of '''compiledds.bat''' type in:

nvdxt -cubeMap -list cubemapfile.lst -output cubemap.dds
pause

This will compile your skybox to the name '''cubemap.dds''', feel free to change the name. Also, the pause command will stop the the batch file and force it to wait before it closes, this will allow you to see any errors that may or may not occur.

Inside of '''cubemapfile.lst''' type in:

left.jpg
right.jpg
top.jpg
bottom.jpg
front.jpg
back.jpg

The .dds file created should be put in the '''maps/''' directory with your maps .smd, .smf and .smt files.

== Skybox notes ==

Do not do these:

Sizes that are not to the power of two. ATI cards have problems with sizes that are not a power of two. Recommended sizes are: '''256X256''', '''512X512''' or '''1024x1024'''.

Note: the batch will export a DXT5 or something like that and spring has an issue with the newest dds stuff. I will update the command for you gents soon. I thought I already had... my bad.

--[[User:Smoth|Smoth]] 09:24, 25 Apr 2007 (CEST)

If you have problems with nvdxt:

You can also create dds textures using the Texture Tool found in the Microsoft DirectX SDK.

Although it is quite a large download it is worth while if you are serioues about making decent maps.

These instruction may not be the best however they have been proven to work with some success.

To create your cube map first open the DirectX Texture Tool. Go to File and select New Texture. Select Cubemap texture. Set the Width and Height as a power of two and leave the MipMap Levels at 1.

The Surface format should be 32bit X8R8G8B8. It may be possible to use other formats for example 24Bit and use less space. If you want to try that you will have to experiment. You can now press OK.

Go to file and select Open Onto This Cubemap Face. Select the image file you want to use for that face. You can select most common image formats such as jpg, bmp, png, etc. The image that you open should be the same width and height as you entered when creating the cubemap.

Now you have done one face and can do the next. To change face go to the View menu, the Cube Map View submenu and select the next face in the list. Open the image you want onto this face as you did before.

Keep doing this until you have opened an image onto every face, then save the file.

You now have a sky-box.

-Orakio
[[Category: Map_making]]

SmuG Works

2010-03-13T21:21:25Z

Koshi: fix category

[http://spring.clan-sy.com/phpbb/viewtopic.php?t=8428&highlight=smug Smug Guide to Running Your Boy]
[[Category: Stratetgy]]

Programming Forum Resources

2010-03-13T21:20:47Z

Koshi: fix category

There are several programming forums that can be used as resources and provide a second insight to a programming problem. The purpose of this page is to list those so that the developers of spring may use them if necissary.

*[http://www.comprog.co.nr/ Computer Programmer's Forum]
*[http://www.gamedev.net/ Game Development forum]
*[http://www.dreamincode.net/ Programming and Web Development Help forum]
[[category: Development]]

Flak Cannon

2010-03-13T21:19:10Z

Koshi: fix category

{{ModSpecific}}
Flak cannon are the main defense against air, other than fighters. It only takes a couple of these to wipe out a group of air units. They can fire at ground units, but are very ineffective and need to be backed up with traditional defense and units.

 

Arm: Flakker
[[Image:armflak.jpg|Flakker]]

Core: Cobra
[[Image:corflak.jpg|Cobra]]
[[category:Units]]

Missile Tower

2010-03-13T21:18:57Z

Koshi: fix category

{{ModSpecific}}
Missile Towers are light defense structures made for destroying aircraft. Their advantages over an [[LLT]] are that they have a longer range and do not consume energy, and are homing. However, they have much less health and do not shoot as quickly, so they should not be used as your main defensive structure.

[[Image:armrl.jpg|Arm Missile Tower]][[Image:corrl.jpg|Core Missile Tower]]

[[category:Units]]

LLT

2010-03-13T21:18:26Z

Koshi: fix category

{{ModSpecific}}
These laser towers are the earliest you can build in game without advancing to Tech Level 1. They can briefly hold off an attacking enemy, and can be built by the [[Commander]], making them the only structural defense available early in the game. They are best used two or three at a time where they can concentrate their fire on bottlenecks, or points where the enemy can only move one or two units through at a time. Their range, however, is easily negated by a [[Missile KBot|missile KBot]] or [[Missile Vehicle|missile truck]]. These units can destroy LLT's without much damage to themselves. This makes it rather important to back them up with something heavier or with a larger range than itself, such as a [[Missile Tower|missile turret]], if you plan on keeping it as a permanent base defense.

[[Image:llt_pics.JPG|you need broadband]]
[[category:Units]]

Defense buildings

2010-03-13T21:17:57Z

Koshi: fix category

== Defensive Buildings ==
This details the various defensive buildings in [[XTA]].

=== Land-Based ===
The larger group (as opposed to sea-based, and (maybe;)) eventually air-based). This group includes everything, from lasers to missiles and plasma cannon.
 

* Ground Defense
** Lasers
*** [[LLT]] (Light Laser Tower)
*** [[HLT]] (Heavy Laser Tower)
*** [[Energy Weapon]]
** Plasma
*** [[Pop-Up Cannon]]
*** [[Plasma Battery]]
*** [[LRPC]] (Long Range Plasma Cannon - aka VLRPC)
*** [[RFLRPC]] (Rapid-fire Long Range Plasma Cannon)
** Wall
*** [[Dragon's Teeth]]
*** [[Fortification Wall]]
* Air Defense
** Missiles
*** [[Missile Tower]]
** Flak
*** [[Flak Cannon]]
* Intelligence
** [[Radar]]
** [[Advanced Radar]]
** [[Jammer]]


=== Sea-Based ===
This category include every definsive structure built on or under the sea.
 

* Sea Defense
** Lasers
*** [[Floating HLT]]
** Torpedo
[[Category: Xta]]

Construction units

2010-03-13T21:17:28Z

Koshi: fix category

== Construction Units ==


Note: This details construction units for [[XTA]]. If you were looking for the [[AA]] unit list, I suggest you head [[Absolute_Annihilation/Units|here]].


== Overview ==


Construction units in XTA do the obvious: they construct things. They can also reclaim things (mostly features) for resources, and repair things. There are 2 levels of construction unit, a well as two special ones (One each for Arm and Core). There are vehicular, kbot, airplane, seaplane, hovercraft, and naval construction units. Also, to make production faster, multiple units can construct a single thing at a time. Constructions unnits can help eachother make buildings, or factories to make other units.
 As a general rule:
 Mobility: Aircraft>Kbot>Vehicle
 Nanolathing (build) Speed: Vehicle>Kbot>Aircraft
 As naval is special (water, not land), it wasn't included above. However, it actually has a faster build speed than every other standard hovercraft. Also, you can build a construction seaplane and construction hovercraft. They are basically level 2 units that build level 1 structures.


==Build Trees==

=== Level 0 - The [[Commander]] ===

Nanolathe Speed: 300.
 Although this isn't an actual tech level, I am putting this here for sake of clarity.
 Can Build:
* Construction Structures
** Land
*** Kbot Lab
*** Advanced Kbot Lab
*** Tank Factory
*** Advanced Tank Factory
*** Airbase
*** Advanced Airbase
** Special
*** Seaport
*** Advanced Seaport
*** Hovercraft Platform
*** Seaplane Factory
* Economy Structures
** Energy
*** Land
**** Solar Panel
**** Windmill
**** Energy Storage
*** Sea
**** Tidal Generator
**** Underwater Energy Storage
** Metal
*** Land
**** Metal Extractor
**** Metal Maker
**** Metal Storage
*** Sea
**** Underwater Metal Extractor
**** Floating Metal Maker
**** Underwater Metal Storage
* Defense Structures
** Land
*** [[LLT]] (Light Laser Tower)
*** Shortrange [[Radar]]
*** Dragon's Teeth (Wall Segment)
** Sea
*** [[Torpedo Launcher]]
*** Shortrange [[Sonar]]
*** Floating Dragon's Teeth (Floating Wall Segment)

=== Land Level 1 ===

Nanolathe Speed:
* Air: 50
* Kbot: 80
* Vehicle: 100
* Seaplane: 100
* Hovercraft: 200
 (As all units of the same level, other than the naval, appear to have the same capabilities, this list applies to the air, kbot, and vehicle styles of construction unit.
 Can Build:
* Everything commanders can EXCEPT most naval (exceptions below)
* Construction Structures
** Seaport
** Advanced Seaport
** Seaplane Platform
* Economy Structures
** Energy
*** Geothermal Powerplant
* Defense Structures
** [[HLT]] (Heavy Laser Tower)
** [[Missile Tower|Missile Turret]]
** [[Pop-Up Cannon|Pop-up Heavy Cannon]]


=== Land Level 2 ===

Nanolathe Speed:
* Air: 100
* Kbot: 160
* Vehicle: 200
Can Build:
* Everything Land level 1 can, except ALL naval
* Production Structures
** Land
*** Krogoth Gantry (Core Only)
* Economy Structures
** Energy
*** Fusion Powerplant
*** Cloakable Fusion Powerplant
** Metal
*** Moho Metal Extractor
*** Moho Metal Maker
* Defense
** [[Energy Weapon]]
** [[Plasma Battery]]
** Shortrange Radar Jammer
** Longrange Radar
** Flak Cannon
** Nuclear Missile Defence System
** Fortification Wall
* Special
** EMP Missile Launcher
** Nuclear Missile Launcher
** [[LRPC]] (Long-Range Plasma Cannon)
** [[RFLRPC]] (Rapid-Fire Long-Range Plasma Cannon)
** Radar Targetting Facility
** [[Airpad]] (Repairs Aircraft)


=== Sea Level 1 ===

The only level 1 sea unit is the construction boat, with a nanolathe speed of 125. It, being a boat, is restricted to water.
 Can Build:
* Construction Structures
** Land
*** Kbot Lab
*** Advanced Kbot Lab
*** Tank Factory
*** Advanced Tank Factory
*** Airbase
*** Advanced Airbase
** Special
*** Seaport
*** Advanced Seaport
*** Hovercraft Platform
*** Seaplane Factory
* Economy
** Energy
*** Tidal Generator
*** Underwater Energy Storage
** Metal
*** Underwater Metal Extractor
*** Floating Metal Maker
*** Underwater Metal Storage
* Defence
** Torpedo Launcher
** [[Floating HLT]] (Heavy Laser Tower)
** Floating Missile Launcher
** Shortrange Sonar
** Dragon's Teeth
** Floating Dragon's Teeth


=== Sea Level 2 ===

Nanolathe Speed: 250
 Can Build:
* All NAVAL that sea level 1 can
* Construction Structures
** Airbase
** Advanced Airbase
** Hovercraft Platform
* Economy
** Energy
*** Underwater Fusion Powerplant
* Defence
** Heavy Torpedo Launcher
** Longrange Sonar
** Dragon's Teeth
** Fortification Post
** Longrange Radar
** Shortrange Jammer


== Special Construction Units ==


There are two special construction KBots in [[XTA]]. Arm has the [[FARK]] (Fast Assist-Repair KBot), while Core has the Necro Rez KBot. The FARK has the fastest nanolathe speed in the mod, at 860. Although it can build little on its own, it is the fastest moving construction unit, and it also gets built quickly. The Necro still has a very fast nanolathe speed (720), but takes longer to build and moves less quickly. However, this is offset by 2 advantages: It is both cheaper, and it can revive destroyed units and structures. This is much cheaper than building another, and is also quicker.


=== [[FARK]] (Fast Assist-Repair KBot) Buildtree ===
* Production Facilities
** Land
*** KBot Lab
*** Advanced KBot Lab
* Economy
** Energy
*** Geothermal Powerplant
** Metal
*** Moho Metal Extractor
* Defence
** [[LLT]]
** Sentinel [[HLT]]
** Flakker [[Flak Cannon]]
** Dragon's Teeth
** Fortification Wall
** [[Advanced Radar]]

=== [[Necro Rez KBot]] Buildtree ===
* Production Facilities
** Land
*** KBot Lab
*** Advanced KBot Lab
* Economy
** Energy
*** Geothermal Powerplant
** Metal
*** Moho Metal Extractor
* Defence
** [[LLT]]
** Gaat Gun [[HLT]]
** Viper Pop-Up [[Heavy Laser]]
** Cobra [[Flak Cannon]]
** Dragon's Teeth
** Fortification Wall
** [[Advanced Radar]]
** [[Immolator Plasma Tower]]

== A note on build time ==

You may notice that build times are extremely high. That is because that is not the build time, but build power necessary to construct that unit/structure. To find the actual time (in seconds), do the simple equation:
 time(seconds)=Buildpower necessary/Nanolathe Speed of all units constructing
 
This means that if you were to build a structure with a buildtime of 1000 with a level 1 vehicle (Nanolathe:100), it will take 10 seconds to build. (10=1000/100)

[[Category: Xta]]

Printable Reference

2010-03-13T21:16:31Z

Koshi: fix category

'''[[Using_Spring|<--Back to Using Spring]]'''

==Printable Control Reference page==

You can print out [http://sparcman.net/Documents/Spring_Control_Reference.pdf this two page quick reference sheet] which covers all basic keyboard and mouse controls and many advanced controls. Not all controls are included as this is meant to be a quick reference for basic gameplay use.
[[Category: Using_Spring]]
[[Category: Key_Bindings]]

SOP

2010-03-13T21:15:37Z

Koshi: fix category

== Strategic, Operational & Tactical Warfare ==

===Introduction===
Understanding the distinctions among strategic, operational, and tactical warfare is important in devising a successful battle plan. However, the distinctions can be a bit fuzzy; there is overlap at each level.

===Strategy===
Strategic planning deals with the overall objective of the war - in this case, to destroy every enemy unit before being destroyed yourself. Strategy is at the national scale in the real world, which would be analogous to the scale of the whole of the player's units and buildings at the TAS scale. Strategy integrates economic, political, and military forces to achieve the final goal. Strategic goals are those that lead to the ultimate strategic objective: destruction of the enemy. They tend to be general rather than specific: for example, "destroy the enemy's energy generation capacity".

===Operational Planning===
Operational planning provides a specific means for reaching a strategic goal. Operational planning deals with where, when, and how forces should be employed in order to reach a strategic goal. For example, if the objective is to "destroy the enemy's energy generation capacity," the operational components of this would be to locate the enemy's energy generation buildings, assess the enemy forces available to defend the respective buildings, determine the best route to take to destroy the enemy building with the least enemy resistance, and deploy forces in such a way as to achieve the strategic goal. Operational goals tend to be on a more specific level than strategic ones; strategic goals can be broken down into one or several operational goals. An example of an operational goal may be "destroy the fusion plant at the north of the enemy's base".

===Tactics===
Tactical planning involves the use of force to best achieve the intermediate steps to the operational goal. Tactics involves where and how to best employ each unit so that its destructive potential is maximized, and the enemy's destructive potential against it and the whole force is minimized. Tactical planning will destroy single enemy defense structures, groups of defense structures, units, and so on. A good example of tactical planning might be "this group of Goliaths will advance and destroy the enemy's Annihilator defending his fusion plant".

===Conclusion===
Why is it important to understand this? In order to win the game, you must set strategic goals that provide the best way to win. How is the game won? The game is not won on the battlefield; it is won on an economic level. You must set strategic goals in such a way as to maximize your own economic production over the length of the game, and minimize your enemy's. Operational goals allow you to break strategic goals down so that you can act with a sense of purpose; they give a concrete way of determining where, when, and how to use your forces. Tactics allows you to use your units to their maximum potential, thereby increasing the number of units that you can have because the need to replace losses will be less.

-Felix the Cat

''' [[Strategy_and_Tactics|<- Back to Strategy and Tactics page]]'''
[[Category: Strategy]]

Readme

2010-03-13T21:14:58Z

Koshi: deprecated

{{deprecated}}
__NOTOC__
For up-to-date information about this project, visit the project home page at http://taspring.clan-sy.com.

==About==
TA Spring is a project aiming to create a new RTS.

==System requirements==
About 1ghz cpu and a GeForce3 or better graphics card. For larger battles the requirements increases. Some graphics effects require a graphics card which supports ARB_vertex_program/ARB_fragment_program. This is the same as having a graphics card that supports DX9.

==Quick start==
===Multiplayer===
Run the TA Spring battleroom and create an account

Login to the master server and find a game to join

===Singleplayer===
Spring supports AI plugins, which allow for external AI programs to be used. There is currently one AI included in the download, but you can find more singleplayer AIs on the AI forum.
If you start the spring.exe application directly, you will get to choose between these Global AI's. You can also use the lobby client to create a battle with AI (Bots) in it.

==Multiplayer lobby==
===Name registration===
Before you can log into the master server, you must register a handle. Click File->Register to open up the registration dialog. Names must be no more than 16 alphanumeric characters, and is not case sensitive. However, you may format your name with capitalization.

===Options===
If you are behind a proxy server, or you are having trouble hosting, you might want to consider overriding the IP the server sees you as having so that people joining your battle room know where to find you

===Chat===
The lobby supports basic chat functions. There is a permanent chatroom called Main, which you can join by double clicking it from the list, as well as any others that may have been created. You can create a chatroom from the menu, but this room is deleted when it becomes empty.

===Battle room===
You can host a battle by selecting it from the menu. To choose a map, simply click the minimap and pick one from the popup window. Once in the battle room, the host may boot anyone by right clicking and selecting boot. The alliance system is a little complicated and needs a little explaining... Any number of players can join a Team, which is the equivalent of one player in OTA. Everyone on a Team shares resources, units, and LOS. The first player to join a team is the team leader, and can pick an Ally Team to join. An Ally Team is a permanent alliance. You'll notice a strange shape with two triangles to the right of the Ally Team combo box. This functions the same way as it did in OTA. If you click it, you create a one-way alliance with another ally team moving the triangle on the left to the middle. If the other Ally Team reciprocates, the triangle on the right will move to the middle. The host can then start Spring once all non-spectators have clicked ready.

===Features to come===
* Clan support
* Map sharing
* Unit sharing
* Private messaging
* Private chatrooms
* New, slicker looking battle room

==Game controls==
===Camera controls===
Move the camera with the arrow keys or by placing the mouse curser at the screen borders. Holding shift makes the camera move faster, and holding ctrl makes it slower. Turn on mouselook with mouse button 3 (or backspace). Use ctrl mouse3 to toggle between the camera modes available.

===Key assignments===
You can configure the assignment of keys by editing the file uikeys.txt, and by running the Selectionkeys editor. These are the default key bindings:

{|
|Camera controls || Function
|-
| colspan="2" | <hr>
|-
| valign="top" | Mouse 1|| Selects units. Drag to select a group, double click to select units of the same type. Gives order if a specific order has been selected.
|-
|Mouse 2 || Gives the default order for the unit
|-
|Mouse 3 || Toggles mouse look
|-
| Ctrl Mouse 3|| Toggles camera mode
|-
|Arrow keys || Moves the camera
|-
|Ctrl/shift|| Increases/decreases camera movement speed
|-
|Mousewheel|| Moves the camera up/down
|-
|T || Track a selected unit
|-
|C|| Take direct control of a selected unit
|-
|F3|| Jump to last message location
|-
|

Floating Metal Maker

2010-03-13T21:12:28Z

Koshi: fix category

{{ModSpecific}}
This is simply a floating variant of the normal [[Metal Maker]]. This should not be used as a source of metal, unless you have expanded across as much of the map and cannot get to any more metal patches. It should be used to funnel excess energy to metal, and should be used with the Metal Maker GroupAI for the greatest effect.

[[Image:armfmakr.jpg|Arm Floating Metal Maker]][[Image:corfmakr.jpg|Core Floating Metal Maker]]

[[category:Units]]

Production buildings

2010-03-13T21:09:43Z

Koshi: fix category

{{ModSpecific}}
== Unit Production ==

Production buildings build mobile units for your army.

=== Arm ===

* Land Buildings
** Level 1
*** [[Vehicles#Arm Vehicle Plant|Vehicle Plant]]
*** [[Airplanes#Arm Air Plant|Air Base]]
*** [[KBots#Arm KBot Plant|KBot Lab]]
*** [[Hovercraft#Arm Hovercraft Plant|Hover Plant]]
** Level 2
*** [[Vehicles#Arm Advanced Vehicle Plant|Advanced Vehicle Plant]]
*** [[Airplanes#Arm Advanced Air Plant|Advanced Air Base]]
*** [[KBots#Arm Advanced KBot Plant|Advanced KBot Lab]]
* Sea Buildings
** Level 1
*** [[Ships#Arm Naval Base|Navy Base]]
*** [[Seaplanes#Arm Seaplane Factory|Seaplane Factory]]
** Level 2
*** [[Ships#Arm Advanced Naval Base|Advanced Navy Base]]

=== Core ===

* Land Buildings
** Level 1
*** [[Vehicles#Core Vehicle Plant|Vehicle Plant]]
*** [[Airplanes#Core Air Plant|Air Base]]
*** [[KBots#Core KBot Plant|KBot Lab]]
*** [[Hovercraft#Core Hovercraft Plant|Hover Plant]]
** Level 2
*** [[Vehicles#Core Advanced Vehicle Plant|Advanced Vehicle Plant]]
*** [[Airplanes#Core Advanced Air Plant|Advanced Air Base]]
*** [[KBots#Core Advanced KBot Plant|Advanced KBot Lab]]
* Sea Buildings
** Level 1
*** [[Ships#Core Naval Base|Navy Base]]
*** [[Seaplanes#Core Seaplane Factory|Seaplane Factory]]
** Level 2
*** [[Ships#Core Advanced Naval Base|Advanced Navy Base]]

== Resource Production ==

As a sidenote, units with nanolathes (building units) can reclaim wrecks, features (such as trees and rocks) and units for resources also. Also, mobile units typically provide a small amount of energy.

As Arm and Core use the same types of structures, the followwing applies to both.

* Energy
** Level 1
*** [[Solar Panel]]
*** [[Geothermal Powerplant]]
*** [[Tidal Generator]]
** Level 2
*** [[Fusion Reactor]]
*** [[Cloakable Fusion Reactor]]
* Metal
** Level 1
*** [[Metal Extractor]]
*** [[Metal Maker]]
*** [[Underwater Metal Extractor]]
*** [[Floating Metal Maker]]
** Level 2
*** [[Moho Metal Extractor]]
*** [[Moho Metal Maker]]

Printable Reference

2010-03-13T21:09:10Z

Koshi: fix category

MTR

2010-03-13T21:06:42Z

Koshi: fix category

=The New Monthly Topic Rotation=

[[Monthly_Topic_Rotation|Old Monthly Topic Rotation]]

===Class I and II Etiquette/Rules===
When someone asks a question that has been answered before post a link to this page to the specific sub-section. Sub-sections will be formatted similar to any other FAQ with the title being the actual question and the answer being the body of the section with links at the end to further reading. In addition, there should be a "Should have looked in" section with a description on how the information should have been found.

===Class III Etiquette/Rules===

When someone posts in the forum about something that has been posted before, they will be linked to the relevant section and their post will be added to the body, the sections name will be a witty description of the question, the body of the section will be a list of topics on the subject in question.

==Class I: Really Frequently Asked Questions(Living FAQ)==
(Questions that have been asked and answered a lot)

==Class II: How I X==
(Questions about how to do specific things like model, make maps, make mods and games)

==Class III: Monthly Topic Rotation==
(Regularly posted topics, requests for features, discussions that are repeated)

==Class IV: Graduates==
(Things that went from Monthly Topic Rotation to actual game features or repeated issues that were resolved by improvements to the engine. Basically move stuff here from other sections when they are no longer MTRs... continue linking people here when they ask for a feature that has already been implemented.)
[[Category: FAQ]]

Game and Unit development

2010-03-13T21:01:31Z

Koshi: fix category

[[Engine_Development|Development]] < {{FULLPAGENAME}}

=Game development=
This information is meant to help newcomers learn how to develop their own games for the Spring Engine.
==General==
*[[Mod specification|Game specification]] 
*[http://springrts.com/phpbb/viewtopic.php?t=6015 What do I need to create a game?]
*[[Simple Mod Tutorial|Simple Game Tutorial]]
*[[Freely available and reusable content|Freely available and reusable content for maps and games]]

==Unit Development==
===Units - Models===
*[http://user.supradigital.org/jcnossen/UpspringInstaller-1.54-EulerAngles.exe Click here to download UpSpring, our content support tool.]
* [[Basic s3o unit making guide]]
* [http://springrts.com/phpbb/viewtopic.php?f=9&t=15106 Argh's UpSpring Easy Workflow Guide]
* [[Trouble-shooting s3o units]]
* [http://lassie.student.utwente.nl/vliet/springtut.pdf Maestro's tutorial of Upspring and textures- very outdated].

====Models - Modeling, UV Mapping====
* [http://springrts.com/phpbb/viewtopic.php?t=10612 Wings UV Mapping Tutorial]
* [http://springrts.com/phpbb/viewtopic.php?f=9&t=12354 Saving polygons in Wings3d Tutorial]
* [http://springrts.com/phpbb/viewtopic.php?t=10503 Runecrafter's 3DS Max UV Mapping Tutorial]

====Models - Textures====
* [http://springrts.com/phpbb/viewtopic.php?f=57&t=22392 DDS Textures: How To]
* [http://springrts.com/phpbb/viewtopic.php?t=10947 Greeble Tutorial 1]
* [http://springrts.com/phpbb/viewtopic.php?f=9&t=12356 Greeble Tutorial 2]

====Models - 3do Files====
-NOTE- this is an outdated model format used by OTA models (Balanced Annihilation, NOTA, etc.). 
(Note: UpSpring has some problems with empty objects and groundplates)
*use [http://springrts.com/phpbb/viewtopic.php?f=12&t=7208&p=126129&hilit=upspring#p126129 UpSpring] and [http://springfiles.com/1755 3doBuilder] to edit those files

===[http://springrts.com/wiki/Category:Animation Scripting and Animation - COB/BOS Files]===
To edit .bos files you need a program/compiler. The most famous one is [http://jobjol.nl/1384 Scriptor]
*[[Animation-LuaScripting]]
**[[Animation-LuaCallins]]
**[[Animation-LuaCallouts]]
**[[Animation-CobLuaDifferences]]
*[[Animation-CobOverview]]
**[[Animation-CobExamples]]
**[[Animation-CobAnimation]]
**[[Animation-CobCallins]]
**[[Animation-CobConstants]]
**[[Animation-CobThreads]]
**[[Animation-CobHitByWeaponID]]
*[http://www.planetannihilation.com/tadc/tut_unit_01_1.asp PlanetAnnihilation] has a nice tutorial
*[[Units:LuaCOB]] - how to interface COB with LUA
*[[CEG_For_Units|Game Development:Calling basic CEGs from COB]]
* [http://springrts.com/phpbb/viewtopic.php?p=132943#132943 GPL-compliant sourcecode, scripting code examples, and other things.]

===Units - FBI Files===
*[[Units:FBI]]
*[[All_FBI-variable_values:_min,_max,_default,_type|Units:FBI (variable datatype list)]]
*[[Unit_Categories]]

===Units - MoveTypes===
*[[Units:MoveTypes]]

===Weapons - TDF Files===
*[[Weapon Variables]] : This is the most up to date
*[[Units:WeaponMainDir]]
*[[Units:Weapons]] : Various informations about the weapontypes (uncompleted)
*[[All_Weapons_variable_values:_min%2C_max%2C_default%2C_type|Weapon datatype list]] : All weapon variables min/max/default values and datatypes listed.
*[[Weapons:Antinukes]]: All about antinukes.

===Explosions===
*[[CEG]]
**[[CEG-Calls]]
**[[CEG-Format]]
**[[CEG-Classes]]
**[[CEG-Operators]]
**[[CEG-Miscellaneous]]
**[[CEG-OldInfo]]

===Misc===
*[[Units:Design]]
*[[Units:Textures]]
*[[Units:Buildpics]]
*[[Units:SideData TDF]]
*[[Units:Download TDF]]
*[[Units:FlankingBonus]]
*[[Mod Development:Armor|Game Development:Armor]]
*[[Mod Development:Cursors|Game Development:Cursors]]
*[[Mod Development:Archives|Game Development:Archives]]
*[[Mod Development:Sidepics|Game Development:Sidepics]]
*[[CustomUnitIcons|Game Development:Custom unit icons]]

===Legacy Porting Tools===
====Automated Game Creation====
* [[TA2Spring]] - Automatically adds and converts Total Annihilation unit packs (.ufo files, etc..) into Spring games (requires a base game for the game rules, XTA is recommended, it is probably not properly supported by current Spring)

[[Category: Unit_development]]
[[Category: Mod_development]]

Energy Weapon

2010-03-13T20:58:56Z

Koshi: fix category

{{ModSpecific}}
The Annihilator and Doomsday Machine are one of the most powerful structures you can build. They are Tech Level 3 structures, built by the most advanced construction units available.

===The Arm Annihilator===

[[Image:Annihilator.JPG|Arm Annihilator]]

''The Annihilator is an offensive and defensive weapon that fires energy shells, and is effective against the stronger units, but can easily be taken down by many weak units. It does massive damage, but shoots slowly and takes a lot of energy (4000) to fire. Although expensive to build, and time consuming, it is one of Arm's most powerful structures.''

===The Core Doomsday Machine===

[[Image:Doomsday.JPG|Core Doomsday Device]]

''The Doomsday Machine is equipped with a cannon that fires explosive energy shells. However, its range is slightly less than that of an annihilator. This is compensated for by an [[HLT]] below the main cannon, and another HLT below that. Like the Annihilator, it is time consuming and expensive to build, but it is extremely powerful and very effective. It can become a linchpin of your base defense the moment you build it.''

Buildqueuewars

2010-03-13T20:58:35Z

Koshi: fix category

The struggle/joy some people seem to have towards "basebuilding" over strategy and tactics, degenrating into porking or porcing.

It can be thought that people suffering of buildqueuewarache, has fallen into a "lack" strategies/tactics, and uses, all the times, the same tactic/strategy: Building.

You can fall into this desease, at any time in a game, but happens usually after some "panic" situation, like spotting a base full of lvl1 gunships early game, or when under siege of a well orchestrated attack that seems overwhelming. Or if you have been under attack pressure constantly.

Buildqueue wars happens more often in large maps.

Well, large for the number of people playing it.

For example, a game of 1v1 in delta siege, is VERY possible ending into a buildqueuewar.

A game of builqueuewarheads, usually ends in spam, nukewar, or eternal MLRPC struggle.

When its spam its usually made of a single unit type, (brawlers in tradittional mods), or maybe 2 unit types, that overload countering defense.

Other units may include, warriors, spiders, panthers, lvl1 Gunships.

Builqueing can be fun, but lacks the nerve of attacking/organizing attacks, planning strategies.
[[Category: Strategy]]

Spring on MacOSX

2010-03-13T20:55:57Z

Koshi: fix category

Because all needed libraries are available for OSX as well, you can compile a working version of Spring for Mac. But Unitsync will only work between Intel Macs and PCs, but not between those and PPC, and due to Apple's switch from PPC to Intel and due to the astronomical amount of effort it would take to to make them sync, there is no PPC port under development.

There's also a working lobby client for Mac OSX, follow the instruction below to compile it.

=Install Spring from source on an Intel Mac=
The following guide was created and tested in a 2,53 Ghz 13" MacBook Pro, 4 GB RAM Nvidia GeForce 9400M and a MacPro Xenon Quadcore ATI Radeon HD 4870, both with Snow Leopard (10.6).

==Dependencies:==
You will need the following dependencies to compile:
Programs necessary to build
* Xcode Tools
* cmake (included in Xcode tools)
* zip
* p7zip

Libraries
* SDL
* boost (version 1.35 or later recommended)
* DeviL (IL, ILU)
* OpenAL (comes with Xcode tools)
* OpenGL headers (mesa, glew, etc.) (comes with Xcode tools)
* zlib
* freetype
* ogg,vorbis and vorbisfile
* Python (2.5)
* glew

==Installing the Dependencies==

Firstly, download the Xcode Development Tools from Apple or install them from your OsX DVD: http://developer.apple.com/technology/xcode.html (u will need to register, but its free of charge)

Then download and install Macports (http://www.macports.org)
You need to be administrator to complete the following.
Open the Terminal and copy and paste the first command and wait until it is completed, continue one-by-one with the others (you will be asked for the admin password each time).

sudo port install cmake
sudo port install libsdl
sudo port install libsdl-framework
sudo port install boost
sudo port install glew
sudo port install boost-jam
sudo port install libpng
sudo port install jpeg
sudo port install tiff
sudo port install libogg
sudo port install libvorbis
sudo port install python25
sudo port install libdevil
sudo port install p7zip

This will take some time and disk space, but should complete without problems. If you experience any errors, download the dependencies' source and compile it.

==Fixes==
Download the latest spring source from the download page.
If you try to compile now, you will experience some errors, and therefore you will have to apply theseÂ patchÂ files:

https://trac.macports.org/attachment/ticket/23556/patch-file-extension.diff
https://trac.macports.org/attachment/ticket/23556/platform-misc-cpp.diff

cdÂ intoÂ theÂ sourceÂ directoryÂ andÂ execute

<code>patchÂ -pÂ 0Â <Â patch-file-extension.diff

patchÂ -pÂ 0Â <Â platform-misc-cpp.diff</code>

==Compiling:==
Open the Terminal, change into the Spring source folder (e.g.: "cd Desktop/spring_0_80_5_2/") and follow the instructions below:
(You will be asked for the admin password)

type "cmake ." (the dot and the gap is important)
type "make" (this will take some time)
type "sudo make install"

After the above commands have finished, check "/usr/local/share/games/spring/AI/Interfaces/C/0.1/" to see if the files there end with '.so' or '.dylib'. If they are named .so you will get an error message when using AI bots. Run this command to rename all .so files to .dylib:

for X in `find /usr/local/share/games/spring/ -name "*.so"`; do sudo mv $X ${X/.so/.dylib}; done;

==Result==
Now, you have a a Unix Executable File called "spring" in your source directory and a "spring" directory in "usr/local/share/games/" (you need to make hidden folders visible to see it).
Create a folder called "maps" and a folder called "mods" there. (This is where Spring will check for maps/mods).
You can double click on the spring file (mod+map needed) and test if everything is alright.

=Compiling the Lobby=
You will need to get a lobby client (e.g.: SpringLobby: http://springlobby.info) and the dependencies to compile it from source following this guide: http://springlobby.info/projects/springlobby/wiki/InstallFromSource
This Chapter will be extended soon.

--[[User:Grapefruit|Grapefruit]] 11:08, 4 December 2009 (UTC)
[[Category: Mac]]

OTA

2010-03-13T20:55:27Z

Koshi: made historical

{{historical}}
OTA, or the original Total Annihilation, is a game made by Cavedog in 1997. Spring was originally a remake of OTA in 3D, but has expanded beyond that. OTA still has a large community, and has many, many mods to play with. A few of these have been ported to Spring, such as [[Absolute Annihilation]], [[UberHack]], [[Final Fronteir]], [[TA-WD|World Domination]], and [[SWTA]].

For more information, go look at [[Wikipedia:Total Annihilation]].

D-gun

2010-03-13T20:55:03Z

Koshi: fix category

{{ModSpecific}}
The Disintegrator Gun, which only the Arm and Core Commanders can use. This weapon is capable of dissolving anything on a subatomic level, and requires a massive level of power (400 Energy) for each shot.

It is thought the 'backpacks' on the Commanders contain rare and exotic equipment needed to use this weapon, accounting for the megaton explosion on the destruction of these units.

[[Image:dgun.PNG|D-Gun Shot]]