Creature Format
From VCMI Project Wiki
See thread http://forum.vcmi.eu/viewtopic.php?t=533 for discussion.
todo:
- remove deprecated attributes once implemented in town config
Creature abilities use Bonus Format.
long version (83 lines):
{
"creatureName" : // should be camel case version of interface name. Examples: Pikeman, RoyalGriffin. Do not change after its released
{
// mandatory
"name" :
{
"singular" : "",
"plural" : ""
},
"level" : 0,
"faction" : "", // config name of faction. Examples: Castle, Rampart
"cost" : // cost, zero values can be omitted. Keys are the ids of the resources
{
"Wood" : 0,
"Mercury" : 0,
"Ore" : 0,
"Sulfur" : 0,
"Crystal" : 0,
"Gems" : 0,
"Gold" : 0
},
"fightValue" : 0,
"aiValue" : 0,
"growth" : 0,
"hitPoints" : 0,
"speed" : 0,
"attack" : 0,
"defence" : 0,
"damage" :
{
"min" : 0,
"max" : 0
},
"advMapAmount" :
{
"min" : 0,
"max" : 0
},
"graphics" :
{
"animation" : "" // name of def file
},
// optional
"upgrades" : [], // keys are names of creatures that this can be upgraded to
"doubleWide" : false,
"shots" : 0,
"spellPoints" : 0,
"abilities" :
{
},
"graphics" :
{
"timeBetweenFidgets" : 1.00,
"troopCountLocationOffset" : 0,
"attackClimaxFrame" : 0,
"animationTime" :
{
"walk" : 1.00,
"attack" : 1.00,
"flight" : 1.00
},
"background" :
{
"120" : "", // if empty, uses faction background
"130" : "" // if empty, uses faction background
},
"missile" :
{
"animation" : "", // name of def file for missile
"spinning" : false,
"offset" :
{
"upperX" : 0,
"upperY" : 0,
"middleX" : 0,
"middleY" : 0,
"lowerX" : 0,
"lowerY" : 0
},
"frameAngles" : []
}
},
"sound" : // names of sound files
{
"attack": "",
"defend": "",
"killed": "",
"move": "",
"shoot" : "",
"wince": "",
"moveStart" : "",
"moveEnd" : ""
},
// deprecated, move to town config
"hordeGrowth" : 0, // growth bonus from horde building
"turretShooter" : false // if used in turret
},
// more creatures
}
pikeman long (39 lines):
{
"Pikeman" :
{
"name" :
{
"singular" : "Pikeman",
"plural" : "Pikemen"
},
"level" : 1,
"faction" : "Castle",
"upgrades" :
{
"Halberdier" : true
},
"cost" :
{
"Gold" : 60
},
"fightValue" : 100,
"aiValue" : 80,
"growth" : 14,
"hitPoints" : 10,
"speed" : 4,
"attack" : 4,
"defence" : 5,
"damage" :
{
"min" : 1,
"max" : 3
},
"advMapAmount" :
{
"min" : 20,
"max" : 50
},
"abilities" : // this is subject to change
{
"CHARGE_IMMUNITY" : {}
},
"graphics" :
{
"animation" : "CPKMAN.DEF",
"animationTime" :
{
"walk" : 1.15
}
},
"sound" :
{
"attack": "PIKEATTK.wav",
"defend": "PIKEDFND.wav",
"killed": "PIKEKILL.wav",
"move": "PIKEMOVE.wav",
"wince": "PIKEWNCE.wav"
}
}
}