Heroes 5 Wiki

The AdvMapHeroShared object is a container for faction hero objects on the adventure map.

Map editor Game Database location[]

  • Launch editor in Game Editor mode and load all database tables.
  • Go to "View" -> "Game Database" -> "Game Database Window"
  • Select AdvMapHeroShared from the database drop down.

Files location[]

AdvMapHeroShared objects files are usually found within data.pak/MapObjects/<Faction name> folder and its sub directories.

Object parameters[]

AdvMapDwellingShared object parameters are configurable within the editor or directly in the object file.

Model[]

Points to a Model type file. Section refers to the model of the hero (its appearance, materials and textures)

AnimSet[]

Points to a AnimSet type file. Section refers to animation set of this hero on adventure map.

blockedTiles[]

Not used for hero objects.

holeTiles[]

Not used for hero objects.

activeTiles[]

Entries define which object tiles will activate combat when another hero touches this hero. X,Y coordinates define the tile position in relation to the center of the object (X,Y - 0,0)

passableTiles[]

Not used for hero objects.

PossessionMarkerTile[]

Possession marker of the hero object. Not known what it is used for. X,Y coordinates define the tile position in relation to the center of the object (X,Y - 0,0). Should be always 0,0.

Effect[]

(Optional) Points to Effect type file which holds auxiliary animations and models that further enrich primary hero model.

EffectWhenOwned[]

Not used for hero objects.

messagesFileRef[]

Not used for hero objects.

WaterBased[]

Boolean entry which defines if the object can be placed in water. Always set to FALSE.

ApplyHeroTrace[]

Should hero leave a gas/colour trace on the tiles he has stepped over. This trace activates after hero army total power value is bigger than certain unknown value. By default set to FALSE. The visuals used for the trace are defined by Trace field.

SoundEffect[]

(Optional) Points to Music type file. Used as soundtrack of the hero when interacting with him.

flybyMessageFileRef[]

Not used for hero objects.

ObjectTypeFileRef[]

Points to text file defining the object type - Building, Creature, Artifacts etc.. It is needed for filters in the editor and sometimes in the game . Default hero object value:

 <ObjectTypeFileRef href="/Text/Visibility_Types/Units.txt"/>

TerrainAligned[]

Not used for hero objects. Set to FALSE.

FlyPassable[]

Defines if flying objects can pass above hero. Default is TRUE.

AdventureSoundEffect[]

(Optional) Points to a Music type file. Defines the adventure map ambient sound when player camera is around the hero. If any music files accompany hero animations in AnimSet list then they will override this music file when animations are executed.

RazedStatic[]

Not used for hero objects.

Icon128[]

Points to Texture type file that provides 2D icon of size 128x128 used as hero portrait.

InternalName[]

Internal ID of the hero. Used for LUA scripts. Can be any string of modder's choice that is not used for other heroes.

Class[]

Value should point to the internal ID from classes available in the game. These will be the class attributes and skills inherited by the hero when leveling up.

Specialization[]

Value should point to internal ID of specializations available in the game. This is the hero specialization ability.

PrimarySkill[]

Defines hero starting skill and mastery level.

SpecializationNameFileRef[]

Point to text file containing the in-game name of the hero specialization

SpecializationDescFileRef[]

Point to text file containing the in-game description of the hero specialization

SpecializationIcon[]

Point to Texture type file containing the in-game 2D icon of the hero specialization

FaceTexture[]

Point to Texture type containing the in-game 2D icon image of size 128x128. This is hero face texture. Can use same image as Icon128.

FaceTextureSmall[]

(Optional) Same as FaceTexture but image size is 64x64.

HeroCharacterArena[]

Points to Character type file that includes model and "cast", "defeat", "happy" animations responsible for hero presentation on the Combat map.

HeroCharacterArenaMelee[]

Points to Character type file that includes hero model, texture and "strike" animation used when hero attacks the enemy by with melee primary attack, like the Knight, the Demon Lord and the Rune Mage. Required only if hero default attack is melee.

HeroCharacterAdventure[]

Point to Character type file that includes model and "move" animation responsible for hero movement on the Adventure map. Preferred to be a low polygon model. Can be the same as HeroCharacterArena entry.

HeroIndividualCamera[]

(Optional) Points to hero Camera type file. Allows a setup of individual camera position, zoom, rotation and angle for this hero. Used in hero screen.

CombatVisual[]

Points to CreatureVisual type file that includes animation related to hero model attack animation on the combat map. If hero attack is melee it should be a melee animation for the specified model, otherwise you can choose range attack animation from Academy Mages or Sylvan Druids that can fit to any model.

TownType[]

Defines the faction the hero is affiliated to.

Editable[]

Defines starting hero game parameters

NameFileRef[]

Points to a text file containing name of the hero

BiographyFileRef[]

Points to a text file containing hero biography text

Offence/Defence/Spellpower/Knowledge[]

Define starting hero attributes

skills[]

Defines additional starting skills. The following format for each skill should be used.

<skills>
  <Item>
    <Mastery>MASTERY_BASIC</Mastery>
    <SkillID>HERO_SKILL_TRAINING</SkillID>
  </Item>
</skills>

perkIDs[]

Defines additional starting perks using the following format for each perk.

<perkIDs>  
  <Item>HERO_SKILL_TOUGHNESS</Item>
</perkIDs>

spellIDs[]

Defines any spells the hero knows.

<spellIDs>
  <Item>SPELL_FORGETFULNESS</Item>
  <Item>SPELL_SLOW</Item>
</spellIDs>

Ballista\FirstAidTent\AmmoCart[]

Defines if hero starts with Ballista\FirstAidTent\AmmoCart war machines.

FavoriteEnemies[]

Defines any starting favorite enemies.

<FavoriteEnemies>
  <Item>CREATURE_BROWLER</Item>
  <Item>CREATURE_RUNE_MAGE</Item>
</FavoriteEnemies>

TalismanLevel[]

For Barbarians only - defines the level of Adventure Talisman. Values between 1 and 4.

ArrowButtonState[]

Defines cursor visual typ when attacking with hero:

  • 0 - broken arrow
  • 1 - straight arrow

Decal[]

Not used for hero objects.

Selection[]

Defines source of circle texture that rotates around the hero when selected by the player

<Selection href="/_(Model)/Heroes/Knight_Path/Symbol.(Model).xdb#xpointer(/Model)"/>

Trace[]

Points to AdvMapHeroTraceSet file which defines trail of the hero with a large army. This field is used only if ApplyHeroTrace is set to TRUE

<Trace href="/MapObjects/_(AdvMapHeroTraceSet)/Haven.xdb#xpointer(/AdvMapHeroTraceSet)"/>

RaceTraitIcon[]

Not used for hero objects.

RaceTraitDescFileRef[]

Not used for hero objects.

ScenarioHero[]

Defines if hero is part only in campaign maps. If set to true, the hero wont be available in custom games.

AdventureMusic[]

(Optional) Points to a Music type file. Define adventure map ambient sound when player camera is around the hero.

HideInEditor[]

If set to true, the hero will not be available in Map Editor hero placement.

PresetMinimalAttributes[]

Allows modder to define minimum characteristics of the hero for duel presets (Duel game mode).