SimArena Documentation

SimArena is a powerful toolkit for creating, configuring, and running simulations with multiple agents in various scenarios. It provides a robust foundation for AI research and development, with support for custom objectives, brains, weapons, and maps.


Project maintained by arbyun Hosted on GitHub Pages — Theme by mattgraham

Maps

SimArena’s map system is powered by the RogueSharp library. It provides a flexible map system that supports different types of map configurations and templates for creating diverse combat environments.

Index

Map Types

Simple Maps

Simple maps are basic rectangular areas with all cells walkable and transparent. They’re perfect for open combat scenarios and only need their width and height specified for them to immediately work out of the box.

Procedurally Generated Maps

Procedural maps use algorithms to generate complex layouts with rooms, corridors, and obstacles.

Random Rooms

Creates a map with randomly placed rooms connected by corridors. See RandomRoomsMapCreationStrategy for more information on how these are generated.

Border Only

Creates a map with walls only around the border, creating a fortress-like environment. See BorderOnlyMapCreationStrategy for more information on how these are generated.

Cave Map

Creates a map using cellular automata. See CaveMapCreationStrategy for more information on how these are generated.

String

Creates a map from a string representation.

The following symbols represent cells on the map:

See StringMapCreationStrategy for more information on how these are generated.

File-Based Maps

Maps loaded from text files with custom layouts. The format is described in detail in File Based Maps.

Map Templates

Map templates allow you to create reusable map configurations that can be shared across different game scenarios. See Custom Maps for more information and examples on how to implement your own.

Built-in Map Templates

SimArena comes with several pre-built map templates:

Small Arena (small_arena)

Medium Battlefield (medium_battlefield)

Large Warzone (large_warzone)

Urban Complex (urban_complex)

Fortress Siege (fortress_siege)

Training Ground (training_ground)