Qrow: 1 revision imported

2025-11-14T05:22:18Z

1 revision imported

← Older revision	Revision as of 22:22, 13 November 2025
(No difference)

Interwiki>Paulomorfeo at 23:45, 22 October 2014

2014-10-22T23:45:09Z

New page

[[Engine_Development|Development]] < AI Development

=How to write a Skirmish AI for Spring=
This section gives help on how to create Artificial Intelligence agents that control teams (as if a player) - "Skirmish AI".

The SpringRTS engine interacts with the Skirmish AIs through an "Interface". There are stable (10-2014, Spring v98) interfaces for the languages C/C++ and Java (not currently sure about the others but I think Lua too).

==Quick Start==
See these pages for tutorials on how to setup a development environment, connect to the appropriate "Interface" and how to build your first example Skirmish AI:

* '''[[AI:Development:Lang:Cpp|C++]]''' 
* '''[[AI:Development:Lang:C|C]]''' 
* '''[[AI:Development:Lang:Java|Java]]''' ''(up-to-date as of 10-2014, SpringRTS v98)'' 
* '''[[AI:Development:Lang:Lua|Lua]]''' 
* '''[[AI:Development:Lang:Python|Python]]''' 
* '''[[AI:Development:Lang:CSharp|C#]]''' 
* '''[[AI:Development:Lang:Groovy|Groovy]]''' 

==I have setup my development environment. What now?==

* '''[[AI:Development:System|SpringRTS <-> AIs architecture]]''' - architecture of SpringRTS and how it interacts with the AIs.
* '''[[AI:Development:TheMaps|The mappings provided by the AI Interface]]''' - how the engine maps the game area and how the interface exposes those maps.
* '''[[AI:Development:MonitorAndDebug|How to monitor and debug your Skirmish AI]]''' - How to monitor and debug your Skirmish AI.
* '''[[AI:Skirmish:List|AIs for Spring]]''' - list of some of the Skirmish AIs that have already been developed for SpringRTS.

==Overall AI ideas, practical examples, useful resources==

* '''[[AI:Links|AI related links]]''' - ranging from how to conceptualize AI agents all the way down to how to tackle very specific problems like pathfinding.
* '''[[AI:GameInferences|Useful inferences]]''' - how to infer where the opponents might have started, where on the maps can your units go, etc..
* '''[http://springrts.com/phpbb/viewforum.php?f=15 Springs AI dev forum]''' - comunity's forum dedicated to AI development.
* '''[[AI:Development:Interface|AI Interfaces & Wrappers]]''' - semi-technical description of the Interfaces that expose the SpringRTS engine to the AI agents.

== Other hints, tips and interesting infos ==

*''' AI "frame skipping"'''
http://springrts.com/phpbb/viewtopic.php?p=463953#p463953 
As in: if a Java/C/C++ SkirmishAI gets delayed responding back to the Interface, the SpringRTS engine will wait on the AI. Thus delaying the game, thus not having the AI "skip" frames.

*''' Engine commands to control the AIs'''
In spring you have some control over AIs with these commands:
<code><pre>
/aireload
/ailist
/aikill
/aicontrol
</pre></code>

*''' Lua<-->AI communications [in Spring 0.83+]'''
http://springrts.com/phpbb/viewtopic.php?f=15&t=26298
He shall say that only it once!

*''' Link to source code of the Interface, engine-side'''
Chances are you'll have doubts about what exactly the commands abc(), qwe() or xyz() do. Asking in the AI forum is a good way to clarify. The most reliable is probably to look at the source code (if you're able to navigate the maze of C++ code in all its glory, that is): 
https://github.com/spring/spring/blob/develop/rts/ExternalAI/AICallback.h 
https://github.com/spring/spring/blob/develop/rts/ExternalAI/AICallback.cpp 

[[Category: AI Dev]]

AI:Development - Revision history

Qrow: 1 revision imported

Interwiki>Paulomorfeo at 23:45, 22 October 2014