Levels

This part of the code has not yet been merged, but is fully supported by the AIMMO Unity project. The relevant pull requests are(in order) #220 and #224.

Extensible Level Generation Architecture

The intention of the level generation is to be as separate as possible from the rest of the AI:MMO implementation. The reason behind is that level requirements might change a lot on the way, so we want a as loosely as possible coupled module as part of the game logic.

Base Generator

The main class that gets exposed to the Django application is the JSONLevelGenerator, which implements the interface exposed by the BaseGenerator.

The BaseGenerator has the following template:

• contructor(setting)
  • a set of basic settings that the map uses at generation
  • see DEFAULT_LEVEL_SETTINGS in simulation.world_map
• get_game_state(avatar_manager)
  • exposes a game state used by the turn manager daemon
  • for details see Game State
• check_complete(game_state)
  • returns false by default, should be overrided when inheriting
  • function to check if a map is "complete"
  • the turn manager runs the action for each avatar, then runs check_complete afterwards
• get_map (@abstract)
  • returns the generated map

EmptyMapGenerator

Generates a centered empty map by the width and height. Can also generate an empty map by given corners.

JSONLevelGenerator

The JSON level generators generates a map in stages, receiving a JSON input map and a list of decoders that can modify the exposed map to the internal game classes. A complete reference of how the internals work can be found in World Map and Game Objects wikis.

Workflow:

• setup the metadata: map dimensions, etc.
• register the JSON that represents the map
• register the decoders that transform the JSONs into WorldMap objects
• decode the map applying the decoder to each of the JSONs

To register a level extend this class, this class is extended. All the levels described in the .txt and .json formats found in the levels folder are automatically imported.

Level Formats

Back-end levels (in folders maps and models)

The back-end levels are an easy way to convert a map described by one map and one(multiple) model(s) to a JSON level. The JSON format is the one fed to the Map Generator.

An example map.txt look like this:

1 1 1 1 2 2 
0 1 1 1 2 2
0 0 1 1 2 2
0 0 0 1 2 2
0 0 0 0 2 2
0 0 0 0 0 2

The .txt files is a one-to-one representation of a map that is transformed in a JSON by applying a model to it. A model is a list of JSONS that are used to transform a .txt map into a JSON. A model supports transforms, which are classes method calls. An example model looks like:

[
  {
    "code": "2",
    "id" : "class:CellTransform.compute_id",
    "x" : "class:CellTransform.get_x",
    "y" : "class:CellTransform.get_y",
    "sprite" : {
      "width" : "400",
      "height" : "400",
      "path" : "Grass-400x400-isometric-top"
    }
  },
  {
    "code": "1",
    "id" : "class:CellTransform.compute_id",
    "x" : "class:CellTransform.get_x",
    "y" : "class:CellTransform.get_y",
    "sprite" : {
      "width" : "512",
      "height" : "1024",
      "path" : "Obstacle-512x1024-isometric-top"
    }
  },
  [...]
]

Unity levels (in folder json)

Level Exposure to the Map Generator