Project Description

Grid-Soccer Simulator is a multi-agent soccer simulator in a grid-world environment. The environment provides a test-bed for machine-learning, and control algorithms, especially multi-agent reinforcement learning.


You need Mono (available for all platforms) or .NET Framework (available for Microsoft Windows only) to run the simulator and the sample clients.


At the current development stage of the Grid-Soccer Simulator; it is more recommended that you directly download the latest source codes from the Source Codes page. There's also a stable possibly outdated source release available at the Downloads page.

User's Manual

Please read the user's manual to get started with the contents of the source package, and basic functionalities of the simulator and the agents. The manual also contains information about the communication protocol between the simulator and the clients, and formalizes the model of the dynamics of the environment. Download the manual from:

Cite Grid-Soccer Simulator

If you are using this environment in your research, please cite the Grid-Soccer User's Manual in your related publications using the following BibTeX entry:

  title = {Grid Soccer Simulator 1.0: User's Manual},
  author = {Sina Iravanian and Sahar Araghi},
  month = {April},
  year = {2011},
  note = "",
  url = ""

  • The communication between players and the simulator is performed using a human-readable, plain text, network protocol; hence one can create a player in virtually any programming language that supports networking
  • Several C# agents, and C++, Java, and Matlab sample agents
  • Change almost every aspect of the simulator using the simulator's settings file (located in /Bin/GridSoccerSimulator.exe.config; the settings file is an XML file which can be easily edited using an ordinary text-editor)
  • Connect any desired number of players for each team as specified in the simulator settings file
  • Change the dimension of the field and the goal-width as desired (as specified in the simulator settings file)
  • Change the passable distance of each player
  • Change the view distance of each player
  • and more...


A Game in the Grid-Soccer Simulator in a grid of 10 x 6 cells.

Gird-Soccer 10 x 6

A Game in the Grid-Soccer Simulator in a grid of 20 x 30 cells, and goals of width 6 cells.

Gird-Soccer 20 x 30

Last edited Jul 21, 2012 at 8:24 AM by sina_iravanian, version 12