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

//maps with same version and different revisions are backward compatible (todo: forward compatibility)
"versionMinor": 0,


//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, //or enum EASY, NORMAL, HARD, EXPERT, IMPOSSIBLE

// 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>} 
  //...
 },

"teams":[<team settings 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>},

"allowedArtifacts" : {<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> },

"rumors":[
{
"name": "rumor name",
"text": "rumor text",
}
//...
]

"surface" :
{

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

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

	//mandatory, unique; coordinate of this level
	"index": 0, //0=surface, 1 underground.
}

"red" :
{
	//
	"allowedFactions":{<Logical id condition>},

	//if true, faction is not selectable (?)
	"randomFaction": false,

	"canComputerPlay": true,

	"canHumanPlay": true,

	"plasedHeroes":{//todo

	},

	"mainTown":{<object link>}, 

	"generateHeroAtMainTown": false,

	"randomHero": false,//if true main hero is random and not selectable 

	"mainHero": "rissa",//if empty main hero is selectable from all available 

	"mainHeroPortrait": "tyris",

	"mainHeroName": "My Hero",

	//0-based, if empty - no allies
	//DEPRACTED, TODO new format for teams
	"team": 3
}

// 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" } ]
    ]
]

 { "position" : [ 32,135,0], "type" : "object.town" , "subType": "castle" }

[
  [ "dt37_pc14|", "sn50_pc9|", "dt12_" ],
  [ "wt26_", "wt03_pc3_", "dt12_" ],
  [ "wt64_", "wt34_pc3_", "dt12_rw4+" ]
]

[
{
	//optional unique object instance identifier
	"instance": 1579,

	//appearance selected by engine if not present

	"template":{<object template format>}
	"type":"objecttype",
	"subtype":"someMod:objectSubtype",

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

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