//version of format itself. This field will be always present.
"formatVersion" : 1,

// vcmi version that was used to create the map.
"engineVersion" : "0.95",

//list of mods required to run this map
//todo: use mod versions
//all "required" mods must be loaded to play this map (f.e. mod with faction used in map)
//if any of "banned" mods are enabled map cant be loaded (f.e. known conflict with map`s scrpited mechanics)
//"allowed" mods are not required, just information that these mods are tested with this map

//map objects can only include/use objects from "required" mods.
//map scripts may also use "allowed" mods (assumed that they check presence of particular mod)

"mods" : {<Logical id condition>},

// Lists map levels and their size and depth
"mapLevels" : {
    "surface" : {<Level header format>},
    "underground" : {<Level header format>}
},

// Human-readable name of the map
"name" : "Test map",

// Human-readable description of the map
"description" : "Long description of completely useless testing map",

// Map difficulty. Represented as percentage?
"difficulty" : 100,

// Maximum level that hero can reach on this map. Optional, default is 199 (internal engine limitation)
"levelLimit" : 20,

// Information on players placed on map, see below
"players" : { 
  "color":{<player information format>} 
  //...
 },

// list of allowed/banned heroes, abilities, spells.  "allOf" aka "required" part of condition as treated as "allowed" and not recommended to use
"allowedHeroes" : {<Logical id condition>},


"allowedAbilities" : {<Logical id condition>},


"allowedSpells" : {<Logical id condition>},


// Text for victory conditions on map selection screen.
"victoryString" : "Defeat all enemies or find artifact",
// Icon, indicates index of frame in SCNRVICT.DEF file
"victoryIconIndex" : 12,

// Text for defeat conditions on map selection screen.
"defeatString" : "Lose your capital Steadwick or your hero Roland",
// Icon, indicates index of frame in SCNRLOSS.DEF file
"defeatIconIndex" : 1,

// list of triggered events that denote computer-readable victory/defeat conditions
"triggeredEvents" : { <list of triggered events, see below> }

"surface" :
{

	//mandatory; level height in tiles
	"height": 72,

	//mandatory; level width in tiles
	"width": 72,

	//mandatory, unique; level depth
	"depth": 0, //0=surface, 1 underground.


	//mandatory; file with level terrain
	"terrain": "surface_terrain.json"

	//mandatory; file(s) with level objects
	"objects": ["surface_objects.json", ...]

}

"red" :
{
	//TODO
}

// Unique identifier of an event
"findTheBlade" :
{
	// Logical condition for this event to trigger, see below
	"condition" : [ "logical expression code" ],

	// TODO: Long description of this event/quest, will be displayed in quest window
	"description" : "Find ancient artifact, Armageddon's Blade to claim victory!",

	// Message that will be displayed to player that have triggered this event
	"message" : "You have found Armageddon's Blade. You won!",

	// Effect caused by this event, right now only win/loss effects are supported
	"effect" :
	{
		// Type of effect, can be either "victory" or "defeat"
		"type" : "victory",

		// Message that will be send to the rest of players to explain what happened
		"messageToSend" : "Enemy found AB. All is lost!"
	}
}

"condition"
{
    //these ids are allowed, default defined by handler
    "anyOf":
    [ "id1", "id2" ],

    //these ids are required, default none. automatically added to allowed
    "allOf":
    [ "id3", "id4" ],

    //these ids are banned, default none, has priority over allowed and required.
    "noneOf":
    [ "id4", "id5" ],
}

"condition"
[
    // To fulfill, all of below must be true
    "allOf",
    // 1) Have 100'000 gold
    [ "haveResources", { "type" : "resource.gold", "value" : 100000 }],
    // 2) 60 days have not passed since game start (aka time expires loss condition)
    [
      "noneOf",
      [ "daysPassed", { "value" : 60 } ]
    ],
    // 3) Player must control at least one of towns at positions specified below
    [
      "anyOf"
      [ "control", { "position" : [ 1, 4,0], "type" : "object.town" } ],
      [ "control", { "position" : [10,25,0], "type" : "object.town" } ]
    ]
]

[
  [ "dt10", "dt13pc3", "dt12" ],
  [ "wt26", "wt03pc3", "dt12" ],
  [ "wt64", "wt34pc3", "dt12rw4" ]
]

[
{
   <mostly identical to Object Format>
  //but only one "base" type in group , unnamed, no RMG or editor specific fields.
  //build-in object types are used for random objects and ignored for all other objects.
  //build-in object types are default values for map editor

  "instances":
  [
	{
		"l" : 0, //map level index
		"options" : {
			//object type specific
		},
		"templateID" : 2, //index of template in "templates"
		"x" : 10,"y" : 6 //coordinates
	}, 
	[...]
  ]
}
]

[
{
	//appearance selected by engine
	"type":"core:objecttype",
	"subtype":"someMod:objectSubtype",

	"options" : {
		//object type specific
	},

	"x" : 10,"y" : 6 //coordinates
},
[...]
],