Skip to content

Hero Type Format

Required data

In order to make functional hero you also need:

  • Portraits, small and big versions (2 images)
  • Specialty icons, small and big versions (2 images)

Format

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
"myHeroName" :
{
    // Identifier of class this hero belongs to. Such as knight or battleMage
    "class" : "wizard",

    // List of starting spells, if available. This entry (even empty) will also grant spellbook
    "spellbook" :
    [
        "magicArrow"
    ],

    // Set to true if the hero is female by default (can be changed in map editor)
    "female" : true,

    // If set to true hero will be unavailable on start and won't appear in taverns (campaign heroes)
    "special" : true,

    // If set to true, hero won't show up on a map with water
    "onlyOnWaterMap" : false,

    // If set to true, hero will show up only if the map contains no water
    "onlyOnMapWithoutWater" : false,

    // All translatable texts related to hero
    "texts" :
    {
        "name" : "My Hero",
        "biography" : "This is a long story...",

        "specialty" :
        {
            // Description visible when hovering over specialty icon
            "description" : "Spell mastery: Magic Arrow",

            // Tooltip visible on clicking icon. Can use {} symbols to change title to yellow
            // as well as escape sequences "\n" to add line breaks
            "tooltip" : "{Magic Arrow}\n\nCasts powerful magic arrows",

            // Name of your specialty
            "name" : "Magic Arrow"
        }
    },

    // Graphics used by hero
    "images" :
    {
        // Small 32px speciality icon
        "specialtySmall" : "myMod/myHero/specSmall.png",

        // Large 44px speciality icon
        "specialtyLarge" : "myMod/myHero/specLarge.png",

        // Large 58x64px portrait
        "large" : "myMod/myHero/large.png",

        // Small 48x32px portrait
        "small" : "myMod/myHero/small.png"
    },

    // Custom animation to be used on battle, overrides hero class property
    "battleImage" : "heroInBattle.def"

    // Initial hero army when recruited in tavern
    // Must have 1-3 elements
    "army" :
    [
        // First always available stack
        {
            // Identifier of creature in this stack
            "creature" : "mage",

            // Minimal and maximum size of stack. Size will be
            // determined randomly at the start of the game
            "max" : 2,
            "min" : 1
        },
        // Second stack has 90 % chance to appear
        {
            "creature" : "archmage",
            "max" : 1,
            "min" : 1
        },
        // Third stack with just 20 % chance to appear
        {
            "creature" : "mage",
            "max" : 2,
            "min" : 1
        }
    ],

    // List of skills initially known by hero
    // Not limited by size - you can add as many skills as you wish
    "skills" :
    [
        {
            // Skill level, basic, advanced or expert
            "level" : "basic",

            // Skill identifier, camelCase version of name
            "skill" : "wisdom"
        },
        {
            "level" : "basic",
            "skill" : "waterMagic"
        }
    ],

    // Description of specialty mechanics using bonuses (with updaters)
    "specialty" : {

        // Optional. Section that will be added into every bonus instance, for use in specialties with multiple similar bonuses
        "base" : {common bonus properties},

        // List of bonuses added by this specialty. See bonus format for more details
        "bonuses" : {
            // use updaters for bonuses that grow with level
            "someBonus" : {Bonus Format},
            "anotherOne" : {Bonus Format}
        },
        // Optional. Shortcut for defining creature specialty, using standard H3 rules
        "creature" : "griffin"
    }
}