//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)
"heroLevelLimit" : 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",
}
//...
],

"predefinedHeroes":{
"hero_id":{<Hero definition format>}
//...
}

"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>},

	"canPlay": "PlayerOnly", //PlayerOrAI(default), PlayerOnly, AIOnly

	//all heroes owned by player
	"heroes":{//todo
		"hero_1":{
			"type":"knight", 
			"name":"King Arthur"
		},
		"hero_7":{
			"type":"" //empty type(default) means random town
		}
		//...
	},
	"mainHero": "hero_1",

	//all towns owned by player
	"towns":{//todo

		"town_42":{
			"type":"castle"		
		},
		"town_43":{
			"type":"" //empty type(default) means random town
		}
	},

	"mainTown":"town_42", 

	"generateHeroAtMainTown": false
}

[
["red", "tan"],
["blue", "purple", "green"]
]

// 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
    [ "have", { "type" : "resource", "subType" : "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"
      //by map position and (optional) object type/suptype
      [ "control", { "position" : [ 1, 4, 0], "type" : "object", "subtype": "town" } ],
      //by instance id
      [ "control", { "object": "town_9" } ]
    ],

    [ "control", { "object" : "hero_42"}]
]

{

	"artifacts" : {
		"backpack" : [
		],
		"feet" : "",
		"head" : "",
		"leftHand" : "",
		"leftRing" : "",
		"mach1" : "",
		"mach2" : "",
		"mach3" : "",
		"mach4" : "",
		"misc1" : "",
		"misc2" : "",
		"misc3" : "",
		"misc4" : "",
		"misc5" : "",
		"neck" : "",
		"rightHand" : "",
		"rightRing" : "",
		"shoulders" : "",
		"spellbook" : "",
		"torso" : ""
	},
	"biography" : "",
	"experience" : 0,
	
	"name" : "My hero",

		
	//optional hero id
	"portrait" : "",
			
	//optional default inherited from configuration
	"primarySkills" : {
		"attack" : 0,
		"defence" : 2,
		"knowledge" : 0,
		"spellpower" : 3
	},
			
	"secondarySkills" : {
		"leadership" : "basic"//"advanced", "expert"
		//...
	},

	//optional, default if not set
	"female" : true,//false
	"spellBook" : [
		"fortune"
		//...
	],
	//default all players
	"availableFor":["red","tan"]
}

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

{
"town_375":{

	//appearance selected by engine if not present

	"template":{<object template format>}
	"type":"town",
	"subtype":"hota.cove:cove",

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

	"pos_x" : [x,y,l], //TODO: alternate coordinates
	"x" : 10,"y" : 6, "l": 0 //coordinates

	//future extension for scripts
	"mod_myMod_x":
	{
		//<myMod specific options>
	},
	"mod_anotherMod_x":
	{
		//<myMod specific options>
	},
	//future extension for object mixins
	"mix_identifier1_x":
	{
	//mixin type specific
	},
	"mix_identifier2_x":
	{
	//mixin type specific
	}
},
//...
}