Difference between revisions of "User:Viader"

From VCMI Project Wiki
Jump to: navigation, search
(→‎Map formats)
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
Najpierw pozbierajmy informacje znalezione w internecie :)
 
Najpierw pozbierajmy informacje znalezione w internecie :)
 +
  
 
== Text formats ==
 
== Text formats ==
Line 5: Line 6:
 
<b>Format TXT</b>
 
<b>Format TXT</b>
  
−
http://en.wikipedia.org/wiki/Text_file //NOTE: check encoding - probably ASCII
+
http://en.wikipedia.org/wiki/Text_file
 +
 
 +
TXT's use language-specific encoding: - Win-1250/Win-1251/Win-1252/...
  
 
<b>Format JSON</b>
 
<b>Format JSON</b>
−
Describe soon...
+
 
 +
http://en.wikipedia.org/wiki/Json
 +
 
  
 
== Image formats ==
 
== Image formats ==
  
 
<b>Format BMP</b>
 
<b>Format BMP</b>
 +
 
http://en.wikipedia.org/wiki/BMP_file_format
 
http://en.wikipedia.org/wiki/BMP_file_format
  
 
<b>Format JPG</b>
 
<b>Format JPG</b>
 +
 
https://en.wikipedia.org/wiki/JPEG
 
https://en.wikipedia.org/wiki/JPEG
  
 
<b>Format PNG</b>
 
<b>Format PNG</b>
 +
 
http://en.wikipedia.org/wiki/Portable_Network_Graphics
 
http://en.wikipedia.org/wiki/Portable_Network_Graphics
  
 
<b>Format TGA</b>
 
<b>Format TGA</b>
 +
 
https://en.wikipedia.org/wiki/Truevision_TGA
 
https://en.wikipedia.org/wiki/Truevision_TGA
  
 
<b> Format PCX </b>
 
<b> Format PCX </b>
  
−
 
+
<pre>
 
struct h3pcx_color_indexed {
 
struct h3pcx_color_indexed {
 
uint8_t r;
 
uint8_t r;
Line 53: Line 62:
 
h3pcx_color_bgr bitmap[width*height];
 
h3pcx_color_bgr bitmap[width*height];
 
};
 
};
−
 
+
</pre>
  
 
Source:
 
Source:
 
http://wiki.enleth.com/homm:homm3-pcx-graphics
 
http://wiki.enleth.com/homm:homm3-pcx-graphics
 +
 +
 +
== Animation formats ==
  
 
<b>Format DEF</b>
 
<b>Format DEF</b>
Line 96: Line 108:
 
Source:
 
Source:
 
http://wiki.enleth.com/homm:homm3-def-animations
 
http://wiki.enleth.com/homm:homm3-def-animations
 +
  
 
== Music formats ==
 
== Music formats ==
  
 
<b>Format MP3</b>
 
<b>Format MP3</b>
 +
 
http://en.wikipedia.org/wiki/MP3
 
http://en.wikipedia.org/wiki/MP3
  
 
<b>Format OGG</b>
 
<b>Format OGG</b>
 +
 
https://en.wikipedia.org/wiki/Ogg
 
https://en.wikipedia.org/wiki/Ogg
  
 
<b>Format 82M</b>
 
<b>Format 82M</b>
 +
 
Renamed WAVE format
 
Renamed WAVE format
 
https://ccrma.stanford.edu/courses/422/projects/WaveFormat/
 
https://ccrma.stanford.edu/courses/422/projects/WaveFormat/
Line 113: Line 129:
  
 
<b>Format AVI</b>
 
<b>Format AVI</b>
 +
 
http://en.wikipedia.org/wiki/Audio_Video_Interleave
 
http://en.wikipedia.org/wiki/Audio_Video_Interleave
  
 
<b>Format SMK</b>
 
<b>Format SMK</b>
 +
 
http://en.wikipedia.org/wiki/Smacker_video
 
http://en.wikipedia.org/wiki/Smacker_video
  
 
<b>Format BIK</b>
 
<b>Format BIK</b>
 +
 
http://en.wikipedia.org/wiki/Bink_Video
 
http://en.wikipedia.org/wiki/Bink_Video
  
 
<b>Format MJPG</b> //better link needed
 
<b>Format MJPG</b> //better link needed
 +
 
http://www.digitalpreservation.gov/formats/fdd/fdd000063.shtml#notes
 
http://www.digitalpreservation.gov/formats/fdd/fdd000063.shtml#notes
  
−
<b>Format MPQ</b> rather not Blizzard format...
+
<b>Format MPG</b>
 +
 
 +
http://pl.wikipedia.org/wiki/Moving_Picture_Experts_Group
  
  
Line 130: Line 152:
  
 
<b>FORMAT PAL</b>
 
<b>FORMAT PAL</b>
 +
 
http://worms2d.info/Palette_file
 
http://worms2d.info/Palette_file
 +
  
 
== Archive formats ==
 
== Archive formats ==
  
−
<b> Format LOD </b>
+
<b>Format LOD and PAC</b>
 
<pre>
 
<pre>
 
struct h3lod {
 
struct h3lod {
Line 155: Line 179:
 
Source:
 
Source:
 
http://wiki.enleth.com/homm:homm3-lod-archives
 
http://wiki.enleth.com/homm:homm3-lod-archives
 +
 +
<b>Format VID</b>
 +
 +
<pre>
 +
struct h3vid {
 +
uint32_t files_count;
 +
struct h3vid_file[files_count]
 +
}
 +
 +
struct h3vid_file {
 +
char name[40];
 +
uint32_t offset;
 +
}
 +
</pre>
 +
Note: Archive VID doesn't contain information about file's size. For h3vid_file[x]:
 +
 +
Size = h3vid_file[x+1].offset - h3vid_file[x].offset.
 +
 +
If we read last file in archive:
 +
 +
Size = archive_size - h3vid_file[x].offset.
 +
 +
 +
<b>Format SND</b>
 +
 +
<pre>
 +
struct h3snd {
 +
uint32 files_count;
 +
struct h3vid_file[files_count]
 +
}
 +
 +
struct h3snd_file {
 +
char name[40];
 +
uint32 offset;
 +
uint32 size;
 +
}
 +
</pre>
 +
Note: For some reason entries in snd have format NAME(null)WAVRUBBISH....
 +
 +
 +
== Font formats ==
 +
 +
<b>Format TTF</b>
 +
 +
http://en.wikipedia.org/wiki/TrueType
 +
 +
<b>Format FNT</b>
 +
 +
Bitmap font, specific for Heroes3. Describe soon...
 +
 +
 +
== Mask formats ==
 +
 +
<b>Format MSK</b>
 +
 +
Describe soon...
 +
 +
<b>Format MSG</b>
 +
 +
Describe soon...
 +
  
 
== Map formats ==
 
== Map formats ==
Line 161: Line 246:
  
 
Source:
 
Source:
−
http://corexii.com/h3m_description.english.txt
+
 
 +
<pre>
 +
struct h3map{
 +
    h3map_header;
 +
    h3map_disposedHeroes;
 +
    h3map_allowedArtifacts;
 +
    h3map_allowedSpells;
 +
    h3map_allowedAbilities;
 +
    h3map_rumors;
 +
    h3map_predefinedHeroes;
 +
    h3map_terrain;
 +
    h3map_defs;
 +
    h3map_objects;
 +
    h3map_events;
 +
}
 +
 
 +
struct string{
 +
uint32 count;
 +
char data[count];
 +
}
 +
 
 +
struct h3map_header{
 +
uint32 version;
 +
uint8 areAnyPlayers;
 +
uint32 width/height;
 +
uint8 twoLevel;
 +
string name;
 +
string describe;
 +
char difficulty;
 +
 +
if(version != ROE)
 +
{
 +
uint8 levelLimit;
 +
}
 +
 +
playerInfo playerInfo[8];
 +
uint8 victoryConditions;
 +
uint8 lossConditions;
 +
uint8 teamCount;
 +
 +
uint8 player[0].team;
 +
uint8 player[1].team;
 +
uint8 player[2].team;
 +
uint8 player[3].team;
 +
uint8 player[4].team;
 +
uint8 player[5].team;
 +
uint8 player[6].team;
 +
uint8 player[7].team;
 +
 +
if(version = ROE)
 +
{
 +
uint8 allowedHeroes[16]
 +
}
 +
else
 +
{
 +
uint8 allowedHeroes[20]
 +
}
 +
 +
if(version > ROE)
 +
{
 +
uint32 placeholdersQty //unknown_1
 +
}
 +
}
 +
 
 +
struct h3map_disposedHeroes{
 +
 
 +
if(version >= SOD)
 +
{
 +
uint8         disposedHeroesCount;
 +
disposedHeroes disposedHeroes[disposedHeroesCount]
 +
}
 +
 +
char nulls[31];
 +
}
 +
 
 +
struct h3map_allowedArtifacts{
 +
 
 +
if(version != ROE)
 +
{
 +
if(version = AB)
 +
{
 +
bool artifactsBits[17];
 +
}
 +
else
 +
{
 +
bool artifactsBits[18];
 +
}
 +
}
 +
}
 +
 
 +
struct h3map_allowedSpells{
 +
 
 +
if(version >= SOD)
 +
{
 +
bool spellBits[9];
 +
}
 +
}
 +
 
 +
 
 +
struct h3map_allowedAbilities{
 +
 
 +
if(version >= SOD)
 +
{
 +
bool abilitiesBits[4];
 +
}
 +
}
 +
 
 +
struct h3map_rumors{
 +
 
 +
uint32 rumorsCount;
 +
rumor rumors[rumorsCount];
 +
}
 +
 
 +
struct h3map_predefinedHeroes{
 +
if(version = SOD || version = WOG)
 +
{
 +
predefinedHeroes predefinedHeroes[156];
 +
}
 +
}
 +
 
 +
 
 +
struct playerInfo{
 +
uint8 canHumanPlay;
 +
uint8 canComputerPlay;
 +
uint8 computer_tactic;
 +
uint8 aiTactic;
 +
 +
if(version == SOD || version == WOG)
 +
{
 +
uint8 p7; //unknown_2
 +
}
 +
 +
bool allowedFactions[32];
 +
uint8 isFactionRandom;
 +
uint8 hasMainTown;
 +
 +
if(hasMainTown == 1)
 +
{
 +
if(version != ROE)
 +
{
 +
uint8 generateHeroAtMainTown;
 +
uint8 generateHeroAtMainTown;
 +
}
 +
 +
uint8 posOfMainTown_x;
 +
uint8 posOfMainTown_y;
 +
uint8 posOfMainTown_z;
 +
}
 +
 +
uint8 hasHero;
 +
uint8 customHeroID;
 +
 +
if(customHeroID != 0xff)
 +
{
 +
uint8 mainHeroPortrait;
 +
string mainHeroName;
 +
}
 +
 +
if(version != ROE)
 +
{
 +
uint8 powerPlaceholders //unknown_3
 +
uint8 heroCount;
 +
uint8 unknow_4; //unknown_4
 +
uint8 unknow_5; //unknown_5
 +
uint8 unknow_6; //unknown_6
 +
heroesNames heroesNames[heroCount];
 +
}
 +
}
 +
 
 +
struct heroesNames{
 +
uint8 heroId;
 +
string heroName;
 +
}
 +
 
 +
struct disposedHeroes{
 +
uint8 heroId;
 +
uint8 portrait;
 +
string name;
 +
bool player[8];
 +
}
 +
 
 +
struct rumor{
 +
string name;
 +
string text;
 +
}
 +
 
 +
struct PredefinedHeroes{
 +
 
 +
uint8 custom;
 +
if(custom != 0)
 +
{
 +
uint8 hasExp;
 +
 +
if(hasExp)
 +
{
 +
        uint32 Exp
 +
}
 +
uint8 hasSecSkills;
 +
 +
if(hasSecSkills)
 +
{
 +
uint32         SecSkillsCount;
 +
secondarySkill SecondarySkill[SecSkillsCount];
 +
}
 +
uint8 hasArt;
 +
 +
if(hasArt)
 +
{
 +
if(version == ROE)
 +
{
 +
uint8 ArtifactToSlot[19];
 +
}
 +
 +
if(version > ROE)
 +
{
 +
uint16 ArtifactToSlot[19];
 +
}
 +
 +
uint16 backpack_amount;
 +
 
 +
if(version == ROE)
 +
{
 +
uint8 ArtifactToBackpack[backpack_amount];
 +
}
 +
 +
if(version > ROE)
 +
{
 +
uint16 ArtifactToBackpack[backpack_amount];
 +
}
 +
}
 +
 +
uint8 hasCustomBio;
 +
if(hasCustomBio)
 +
{
 +
string biography;
 +
}
 +
uint8 sex;
 +
uint8 hasCustomSpells;
 +
if(hasCustomSpells)
 +
{
 +
uint8 spells[9];
 +
}
 +
uint8 hasCustomPrimSkills;
 +
if(hasCustomPrimSkills)
 +
uint8 PrimarySkill;
 +
}
 +
}
 +
 
 +
struct Hero{
 +
 
 +
if(version > ROE)
 +
{
 +
uint32 identifier;
 +
}
 +
uint8 PlayerColor;
 +
uint8 subID;
 +
 +
uint8 hasName;
 +
if(hasName)
 +
{
 +
string name;
 +
}
 +
 +
if(version > AB)
 +
{
 +
uint8 hasExp;
 +
if(hasExp)
 +
{
 +
uint32 Exp;
 +
}
 +
}
 +
else
 +
{
 +
uint32 Exp;
 +
}
 +
 +
uint8 hasPortrait;
 +
if(hasPortrait)
 +
{
 +
uint8 portrait;
 +
}
 +
 +
uint8 hasSecSkills;
 +
if(hasSecSkills)
 +
{
 +
uint32 SecSkillsCount;
 +
secondarySkill SecondarySkill[SecSkillsCount];
 +
}
 +
 +
uint8 hasGarison;
 +
if(hasGarison)
 +
{
 +
creature army[7];
 +
}
 +
 +
uint8 formation;
 +
 +
uint8 hasArt;
 +
if(hasArt)
 +
{
 +
if(version == ROE)
 +
{
 +
uint8 ArtifactToSlot[19];
 +
}
 +
 +
if(version > ROE)
 +
{
 +
uint16 ArtifactToSlot[19];
 +
}
 +
 +
uint16 backpack_amount;
 +
if(version == ROE)
 +
{
 +
uint8 ArtifactToBackpack[backpack_amount];
 +
}
 +
 +
if(version > ROE)
 +
{
 +
uint16 ArtifactToBackpack[backpack_amount];
 +
}
 +
}
 +
 
 +
uint8 patrolRadious; //if(patrolRadious == 0xff then patrolRadious = false, else patrolRadious = true)
 +
 +
 +
uint8 hasCustomBio;
 +
if(hasCustomBio)
 +
{
 +
string biography;
 +
}
 +
uint8 sex;
 +
 +
if(version > AB)
 +
{
 +
uint8 hasCustomSpells;
 +
if(hasCustomSpells)
 +
{
 +
uint8 spells[9];
 +
}
 +
}
 +
else if(version == AB)
 +
{
 +
uint8 spells[1];
 +
}
 +
 +
uint8 hasCustomPrimSkills;
 +
if(hasCustomPrimSkills)
 +
{
 +
uint8 PrimarySkill[GameConstants::PRIMARY_SKILLS];
 +
}
 +
uint8 unknown[16];
 +
}
 +
 
 +
struct secondarySkill{
 +
uint8 Skill;
 +
uint8 level;
 +
}
 +
 
 +
struct h3map_terrain{
 +
terrain world_tileset[width][height];
 +
if(TwoLevel)
 +
{
 +
terrain second_world_tileset[width][height];
 +
}
 +
}
 +
 
 +
struct creature{
 +
 
 +
if(version > ROE)
 +
{
 +
uint16 ID;
 +
}
 +
else
 +
{
 +
uint8 ID;
 +
}
 +
 +
uint16 count;
 +
}
 +
 
 +
struct terrain{
 +
uint8 Type;
 +
uint8 View;
 +
uint8 riverType;
 +
uint8 riverDir;
 +
uint8 roadType;
 +
uint8 roadDir;
 +
uint8 extTileFlags;
 +
}
 +
 
 +
struct h3map_def{
 +
uint32 defAmount;
 +
def def[defAmount]
 +
}
 +
 
 +
struct def{
 +
string name;
 +
uint8 bytes[12];
 +
uint16 terrainAllowed;
 +
uint16 terrainMenu;
 +
uint32 id;
 +
uint32 subid;
 +
uint8 type;
 +
uint8 printPriority;
 +
uint16 unknown;
 +
}
 +
 
 +
struct h3map_object{
 +
uint32 count;
 +
object object[count];
 +
}
 +
 
 +
struct object{
 +
uint8 x;
 +
uint8 y;
 +
uint8 z;
 +
uint32 defnum;
 +
uint8 unknown[5];
 +
 +
if(h3map_def.def[defnum].id == EVENT)
 +
{
 +
uint8 hasMessage;
 +
if(hasMessage)
 +
{
 +
string message;
 +
}
 +
uint8 hasGuards;
 +
if(hasGuards)
 +
{
 +
creature guards[7];
 +
}
 +
uint32 unknow;
 +
 +
uint32 gainedExp;
 +
uint32 manaDiff;
 +
uint8 moraleDiff;
 +
uint8 luckDiff;
 +
uint32 resources[7];
 +
uint8 primskills[4];
 +
uint8 countSkill;
 +
secondarySkill skill[ count_gained_abilities];
 +
uint8 countArtifact;
 +
if(version == ROE)
 +
{
 +
uint8 ArtifactID[countArtifact];
 +
}
 +
else
 +
{
 +
uint16 ArtifactID[countArtifact];
 +
}
 +
uint8 countSpell;
 +
uint8 SpellID[countSpell];
 +
uint8 countCreature;
 +
creature creature[countCreature];
 +
uint8 unknown_1[8];
 +
uint8 availableFor;
 +
uint8 computerActivate;
 +
uint8 removeAfterVisit;
 +
uint32 unknown_2;
 +
}
 +
 +
if(h3map_def.def[defnum].id == HERO)
 +
{
 +
hero hero;
 +
}
 +
 +
if(h3map_def.def[defnum].id == MONSTER)
 +
{
 +
if(version > ROE)
 +
{
 +
uint32 creID;
 +
}
 +
 +
uint16 creCount;
 +
uint8 creCharacter;
 +
uint8 hasMessage;
 +
 +
if(hasMessage)
 +
{
 +
string message;
 +
uint32 resources[7];
 +
 +
if(version == ROE)
 +
{
 +
uint8 artID;
 +
}
 +
 +
else
 +
{
 +
uint8 artID;
 +
}
 +
}
 +
uint8 creNeverFlees;
 +
uint8 creNotGrowingTeam;
 +
uint8 unknown_1[2];
 +
}
 +
 +
if(h3map_def.def[defnum].id == BOOTLE)
 +
{
 +
string message;
 +
uint32 unknown_1;
 +
}
 +
 
 +
if(h3map_def.def[defnum].id == SEER_HUT)
 +
{
 +
if(version > ROE)
 +
{
 +
quest quest;
 +
 +
if(quest.missionType > 0)
 +
{
 +
uint8 rewardType;
 +
 +
if(rewardType == EXPERIENCE || rewardType == MANA_POINTS)
 +
{
 +
uint32 value;
 +
}
 +
 +
if(rewardType == MORALE_BONUS || rewardType == LUCK_BONUS || rewardType == SPELL)
 +
{
 +
uint8 value;
 +
}
 +
 
 +
if(rewardType == RESOURCES)
 +
{
 +
uint8 ID;
 +
uint32 value;
 +
}
 +
 +
if(rewardType == PRIMARY_SKILL || rewardType == SECONDARY_SKILL)
 +
{
 +
uint8 ID;
 +
uint8 value;
 +
}
 +
 
 +
if(rewardType == ARTIFACT)
 +
{
 +
if(version == ROE)
 +
{
 +
uint8 ID;
 +
}
 +
else
 +
{
 +
uint16 ID;
 +
}
 +
}
 +
 +
if(rewardType == CREATURE)
 +
{
 +
if(version == ROE)
 +
{
 +
uint16 ID;
 +
uint16 value;
 +
}
 +
else
 +
{
 +
uint8 ID;
 +
uint16 value;
 +
}
 +
}
 +
}
 +
uint8 unknown_1[2];
 +
}
 +
else
 +
{
 +
uint8 unknown_1[3];
 +
}
 +
}
 +
 +
if(h3map_def.def[defnum].id == SCHOLAR)
 +
{
 +
uint8 bonusType;
 +
uint8 bonusID;
 +
uint8 unknown_1[6];
 +
}
 +
 
 +
if(h3map_def.def[defnum].id == GARRISON)
 +
{
 +
uint8 playerColor;
 +
uint8 unknown_1[3];
 +
creature army[7];
 +
if(version > ROE)
 +
{
 +
uint8 removableUnits;
 +
}
 +
uint8 unknown_2[8];
 +
}
 +
 
 +
if(h3map_def.def[defnum].id == ARTIFACT || h3map_def.def[defnum].id == SPELL_SCROLL)
 +
{
 +
if(hasMessage)
 +
{
 +
string message;
 +
}
 +
uint8 hasGuards;
 +
if(hasGuards)
 +
{
 +
creature guards[7];
 +
}
 +
uint32 unknow;
 +
 
 +
if(h3map_def.def[defnum].id == SPELL_SCROLL)
 +
{
 +
uint32 spellID;
 +
}
 +
}
 +
 +
if(h3map_def.def[defnum].id == RESOURCE)
 +
{
 +
if(hasMessage)
 +
{
 +
string message;
 +
}
 +
uint8 hasGuards;
 +
if(hasGuards)
 +
{
 +
creature guards[7];
 +
}
 +
uint32 unknow;
 +
uint32 amount;
 +
uint32 unknow_1;
 +
}
 +
 
 +
if(h3map_def.def[defnum].id == TOWN)
 +
{
 +
if(hasMessage)
 +
{
 +
string message;
 +
}
 +
uint8 hasGuards;
 +
if(hasGuards)
 +
{
 +
creature guards[7];
 +
}
 +
 +
uint32 unknow;
 +
uint32 amount;
 +
uint32 unknow_1;
 +
}
 +
 
 +
if(h3map_def.def[defnum].id == MINE || h3map_def.def[defnum].id == CREATURE_GENERATOR)
 +
{
 +
uint8 playerColor;
 +
uint8 unknown_1[3];
 +
}
 +
 
 +
if(h3map_def.def[defnum].id == SHRINE_OF_MAGIC_THOUGHT)
 +
{
 +
uint8 spellID;
 +
uint8 unknown_1[3];
 +
}
 +
 
 +
if(h3map_def.def[defnum].id == PANDORAS_BOX)
 +
{
 +
uint8 hasMessage;
 +
if(hasMessage)
 +
{
 +
string message;
 +
}
 +
uint8 hasGuards;
 +
if(hasGuards)
 +
{
 +
creature guards[7];
 +
}
 +
uint32 unknow;
 +
 +
uint32 gainedExp;
 +
uint32 manaDiff;
 +
uint8 moraleDiff;
 +
uint8 luckDiff;
 +
uint32 resources[7];
 +
uint8 primskills[4];
 +
uint8 countSkill;
 +
secondarySkill skill[ count_gained_abilities];
 +
uint8 countArtifact;
 +
if(version == ROE)
 +
{
 +
uint8 ArtifactID[countArtifact];
 +
}
 +
else
 +
{
 +
uint16 ArtifactID[countArtifact];
 +
}
 +
uint8 countSpell;
 +
uint8 SpellID[countSpell];
 +
uint8 countCreature;
 +
creature creature[countCreature];
 +
uint8 unknown_1[8];
 +
}
 +
 +
if(h3map_def.def[defnum].id == GRAIL)
 +
{
 +
uint32 grailRadious;
 +
}
 +
 +
if(h3map_def.def[defnum].id == QUEST_GUARD || h3map_def.def[defnum].id == BORDERGUARD || h3map_def.def[defnum].id == BORDER_GATE)
 +
{
 +
quest quest;
 +
}
 +
 +
if(h3map_def.def[defnum].id == SHIPYARD || h3map_def.def[defnum].id == LIGHTHOUSE)
 +
{
 +
uint32 playercolor;
 +
}
 +
 
 +
}
 +
 
 +
struct quest{
 +
uint8 missionType;
 +
if(missionType == 2)
 +
{
 +
uint8 m2stats[4];
 +
}
 +
 
 +
if(missionType == 1 || missionType == 3 || missionType == 4)
 +
{
 +
uint32 m13489val;
 +
}
 +
 
 +
if(missionType == 5)
 +
{
 +
uint8 artCount;
 +
uint16 artID[artCount];
 +
}
 +
 +
if(missionType == 6)
 +
{
 +
uint8 typeCount;
 +
quest_creature quest_creature[typeCount];
 +
}
 +
 +
if(missionType == 7)
 +
{
 +
uint32 m7resources[7]
 +
}
 +
 +
if(missionType == 8 || missionType == 9)
 +
{
 +
uint8 m13489val;
 +
}
 +
 +
uint32 limit;
 +
string firstVisitText;
 +
string nextVisitText;
 +
string completedText;
 +
}
 +
 
 +
struct quest_creature{
 +
uint16 type;
 +
uint16 count;
 +
}
 +
 
 +
struct town{
 +
 
 +
if(version > ROE)
 +
{
 +
uint32 ID;
 +
}
 +
uint8 playerColor;
 +
uint8 hasName;
 +
if(hasName)
 +
{
 +
string name;
 +
}
 +
uint8 hasGarrison;
 +
if(hasGarrison)
 +
{
 +
creature army[7];
 +
}
 +
uint8 formation;
 +
uint8 hasCustomBuildings;
 +
if(hasCustomBuildings)
 +
{
 +
uint8 builtBuildings[6];
 +
uint8 forbiddenBuildings[6];
 +
}
 +
else
 +
{
 +
uint8 hasFort;
 +
}
 +
 +
if(version > ROE)
 +
{
 +
uint8 obligatorySpells[9];
 +
}
 +
uint8 possibleSpells;
 +
uint8 eventCount;
 +
castleEvent castleEvent[eventCount];
 +
 +
if(version > AB)
 +
{
 +
uint8 alignment;
 +
}
 +
uint8 unknown[3];
 +
}
 +
 
 +
struct h3map_event{
 +
uint32 count;
 +
event event[count];
 +
}
 +
 
 +
struct event{
 +
string name;
 +
string message;
 +
uint32 resources[7];
 +
uint8 players;
 +
if(version > AB)
 +
{
 +
uint8 humanAffected;
 +
}
 +
uint8 computerAffected;
 +
uint16 firstOccurence;
 +
uint8 nextOccurence;
 +
uint8 unknow[17];
 +
}
 +
 
 +
struct castleEvent{
 +
event event;
 +
uint8 buildings[6];
 +
uint16 creaturesBonus[7];
 +
uint32 unknown;
 +
}
 
</pre>
 
</pre>
 +
 +
http://corexii.com/h3m_description.english.txt (uncomplete)
 +
 +
http://svn.code.sf.net/p/vcmi/code/tags/0.8/h3m.txt (complete - Polish)
 +
 +
== Campaigns formats ==
 +
 +
Describe soon...

Latest revision as of 15:17, 19 August 2013

Najpierw pozbierajmy informacje znalezione w internecie :)


Text formats

Format TXT

http://en.wikipedia.org/wiki/Text_file

TXT's use language-specific encoding: - Win-1250/Win-1251/Win-1252/...

Format JSON

http://en.wikipedia.org/wiki/Json


Image formats

Format BMP

http://en.wikipedia.org/wiki/BMP_file_format

Format JPG

https://en.wikipedia.org/wiki/JPEG

Format PNG

http://en.wikipedia.org/wiki/Portable_Network_Graphics

Format TGA

https://en.wikipedia.org/wiki/Truevision_TGA

Format PCX 

struct h3pcx_color_indexed {
	uint8_t r;
	uint8_t g;
	uint8_t b;
};
 
struct h3pcx_indexed {
	uint32_t bitmap_size; // equals to width*height - 1 byte per pixel
	uint32_t width;
	uint32_t height;
	uint8_t bitmap[width*height];
	h3pcx_color_indexed palette[256];
};
 
struct h3pcx_color_bgr {
	uint8_t b;
	uint8_t g;
	uint8_t r;
};
 
struct h3pcx_bgr {
	uint32_t bitmap_size; // equals to 3*width*height - 3 bytes per pixel
	uint32_t width;
	uint32_t height;
	h3pcx_color_bgr bitmap[width*height];
};

Source: http://wiki.enleth.com/homm:homm3-pcx-graphics


Animation formats

Format DEF 

struct h3def_color_indexed {
	uint8_t r;
	uint8_t g;
	uint8_t b;
};
 
struct h3def_header {
	uint32_t type;
	uint32_t width;
	uint32_t height;
	uint32_t sequences_count;
	h3def_color_indexed palette[256];
};

struct h3def_sequence {
        uint32_t type;
        uint32_t length;
        uint32_t unknown1;
        uint32_t unknown2;
        char *names[length];
        uint32_t offsets[length];
};

struct h3def_frame_header {
        uint32_t data_size;
        uint32_t type;
        uint32_t width;
        uint32_t height;
        uint32_t img_width;
        uint32_t img_height;
        uint32_t x;
        uint32_t y;
};

Source: http://wiki.enleth.com/homm:homm3-def-animations


Music formats

Format MP3

http://en.wikipedia.org/wiki/MP3

Format OGG

https://en.wikipedia.org/wiki/Ogg

Format 82M

Renamed WAVE format https://ccrma.stanford.edu/courses/422/projects/WaveFormat/


Video formats

Format AVI

http://en.wikipedia.org/wiki/Audio_Video_Interleave

Format SMK

http://en.wikipedia.org/wiki/Smacker_video

Format BIK

http://en.wikipedia.org/wiki/Bink_Video

Format MJPG //better link needed

http://www.digitalpreservation.gov/formats/fdd/fdd000063.shtml#notes

Format MPG

http://pl.wikipedia.org/wiki/Moving_Picture_Experts_Group


Palette formats

FORMAT PAL

http://worms2d.info/Palette_file


Archive formats

Format LOD and PAC 

struct h3lod {
	uint32_t magic; // always 0x00444f4c, that is, a null-terminated "LOD" string
	uint32_t type; // 200 for base archives, 500 for expansion pack archives, probably completely arbitrary numbers
	uint32_t files_count; // obvious
	uint8_t unknown[80]; // 80 bytes of hell knows what - in most cases that's all zeros, but in H3sprite.lod there's a bunch of seemingly irrelevant numbers here, any information is welcome
	struct h3lod_file[10000]; // file list
}
 
struct h3lod_file {
	char name[16]; // null-terminated, sometimes null-padded too, sometimes padded with, well, something after the null
	uint32_t offset; // includes the header size, no preprocessing required
	uint32_t size_original; // before compression, that is
	uint32_t type; // what's in the file - probably not used by the game directly, more on that below
	uint32_t size_compressed; // how many bytes to read, starting from offset - can be zero for stored files, use size_original in such case 
}

Source: http://wiki.enleth.com/homm:homm3-lod-archives

Format VID 

struct h3vid {
	uint32_t files_count;
	struct h3vid_file[files_count]
}
 
struct h3vid_file {
	char name[40];
	uint32_t offset;
}

Note: Archive VID doesn't contain information about file's size. For h3vid_file[x]:

Size = h3vid_file[x+1].offset - h3vid_file[x].offset.

If we read last file in archive:

Size = archive_size - h3vid_file[x].offset.


Format SND 

struct h3snd {
	uint32 files_count;
	struct h3vid_file[files_count]
}
 
struct h3snd_file {
	char name[40];
	uint32 offset;
	uint32 size;
}

Note: For some reason entries in snd have format NAME(null)WAVRUBBISH....


Font formats

Format TTF

http://en.wikipedia.org/wiki/TrueType

Format FNT

Bitmap font, specific for Heroes3. Describe soon...


Mask formats

Format MSK

Describe soon...

Format MSG

Describe soon...


Map formats

Format H3M

Source: 

struct h3map{
	    h3map_header;
	    h3map_disposedHeroes;
	    h3map_allowedArtifacts;
	    h3map_allowedSpells;
	    h3map_allowedAbilities;
	    h3map_rumors;
	    h3map_predefinedHeroes;
	    h3map_terrain;
	    h3map_defs;
	    h3map_objects;
	    h3map_events;
}

struct string{
	uint32 count;
	char data[count];
}

struct h3map_header{
	uint32			version;
	uint8			areAnyPlayers;
	uint32			width/height;
	uint8			twoLevel;
	string 			name;
	string			describe;
	char			difficulty;
	
	if(version != ROE)
	{
		uint8 		levelLimit;
	}
	
	playerInfo 		playerInfo[8];
	uint8			victoryConditions;
	uint8			lossConditions;
	uint8			teamCount;
	
	uint8 			player[0].team;
	uint8 			player[1].team;
	uint8 			player[2].team;
	uint8			player[3].team;
	uint8 			player[4].team;
	uint8 			player[5].team;
	uint8 			player[6].team;
	uint8 			player[7].team;
	
	if(version = ROE)
	{
		uint8 		allowedHeroes[16]
	}
	else
	{
		uint8 		allowedHeroes[20]
	}	
	
	if(version > ROE)
	{
		uint32 		placeholdersQty //unknown_1
	}
}

struct h3map_disposedHeroes{

	if(version >= SOD)
	{
		uint8 	        disposedHeroesCount;
		disposedHeroes 	disposedHeroes[disposedHeroesCount]
	}
	
	char nulls[31];
}

struct h3map_allowedArtifacts{

	if(version != ROE)
	{
		if(version = AB)
		{
			bool artifactsBits[17];
		}
		else
		{
			bool artifactsBits[18];
		}
	}
}

struct h3map_allowedSpells{

	if(version >= SOD)
	{
		bool spellBits[9];
	}
}


struct h3map_allowedAbilities{

	if(version >= SOD)
	{
		bool abilitiesBits[4];
	}
}

struct h3map_rumors{

	uint32 rumorsCount;
	rumor rumors[rumorsCount];
}

struct h3map_predefinedHeroes{
	if(version = SOD || version = WOG)
	{
		predefinedHeroes predefinedHeroes[156];
	}
}


struct playerInfo{
	uint8 			canHumanPlay;
	uint8			canComputerPlay;
	uint8			computer_tactic;
	uint8			aiTactic;
	
	if(version == SOD || version == WOG)
	{
		uint8		p7; //unknown_2
	}
	
	bool			allowedFactions[32];
	uint8			isFactionRandom;
	uint8			hasMainTown;
	
	if(hasMainTown == 1)
	{
		if(version != ROE)
		{
			uint8	generateHeroAtMainTown;
			uint8	generateHeroAtMainTown;
		}
		
		uint8		posOfMainTown_x;
		uint8		posOfMainTown_y;
		uint8		posOfMainTown_z;
	}
	
	uint8 			hasHero;
	uint8 			customHeroID;
	
	if(customHeroID != 0xff)
	{
		uint8		mainHeroPortrait;
		string		mainHeroName;
	}
	
	if(version != ROE)
	{
		uint8 		powerPlaceholders	//unknown_3
		uint8 		heroCount;
		uint8		unknow_4;			//unknown_4
		uint8 		unknow_5;			//unknown_5
		uint8 		unknow_6;			//unknown_6
		heroesNames	heroesNames[heroCount];
	}
}

struct heroesNames{
	uint8 			heroId;
	string 			heroName;
}

struct disposedHeroes{
	uint8			heroId;
	uint8			portrait;
	string			name;
	bool			player[8];
}

struct rumor{
	string name;
	string text;
}

struct PredefinedHeroes{

	uint8	custom;
	if(custom != 0)
	{
		uint8	hasExp;
		
		if(hasExp)
		{
		        uint32 	Exp
		}
		uint8	hasSecSkills;
		
		if(hasSecSkills)
		{
			uint32	        SecSkillsCount;
			secondarySkill	SecondarySkill[SecSkillsCount];
		}
		uint8	hasArt;
		
		if(hasArt)
		{
			if(version == ROE)
			{
				uint8	ArtifactToSlot[19];
			}
			
			if(version > ROE)
			{
				uint16	ArtifactToSlot[19];
			}			
			
			uint16 backpack_amount;

			if(version == ROE)
			{
				uint8	ArtifactToBackpack[backpack_amount];
			}
			
			if(version > ROE)
			{
				uint16	ArtifactToBackpack[backpack_amount];
			}
		}		
		
		uint8	hasCustomBio;
		if(hasCustomBio)
		{
			string	biography;
		}
		uint8	sex;
		uint8	hasCustomSpells;
		if(hasCustomSpells)
		{
			uint8 spells[9];
		}
		uint8 hasCustomPrimSkills;
		if(hasCustomPrimSkills)
		uint8 PrimarySkill;
	}
}

struct Hero{

	if(version > ROE)
	{
		uint32	identifier;
	}
	uint8	PlayerColor;
	uint8	subID;
	
	uint8	hasName;
	if(hasName)
	{
		string name;
	}
	
	if(version > AB)
	{
		uint8 hasExp;
		if(hasExp)
		{
			uint32 Exp;
		}
	}
	else
	{
		uint32 Exp;
	}
	
	uint8 hasPortrait;
	if(hasPortrait)
	{
		uint8 portrait;
	}
	
	uint8 hasSecSkills;
	if(hasSecSkills)
	{
		uint32			SecSkillsCount;
		secondarySkill	SecondarySkill[SecSkillsCount];
	}
	
	uint8 hasGarison;
	if(hasGarison)
	{
		creature army[7];
	}
	
	uint8 formation;
	
	uint8 hasArt;
	if(hasArt)
	{
		if(version == ROE)
		{
			uint8			ArtifactToSlot[19];
		}
		
		if(version > ROE)
		{
			uint16			ArtifactToSlot[19];
		}			
		
		uint16 backpack_amount;
		if(version == ROE)
		{
			uint8			ArtifactToBackpack[backpack_amount];
		}
		
		if(version > ROE)
		{
			uint16			ArtifactToBackpack[backpack_amount];
		}
	}

	uint8	patrolRadious; //if(patrolRadious == 0xff then patrolRadious = false, else patrolRadious = true)
	
		
	uint8	hasCustomBio;
	if(hasCustomBio)
	{
		string	biography;
	}
	uint8	sex;
	
	if(version > AB)
	{
		uint8	hasCustomSpells;
		if(hasCustomSpells)
		{
			uint8 spells[9];
		}
	}
	else if(version == AB)
	{
		uint8 spells[1];
	}
	
	uint8 hasCustomPrimSkills;
	if(hasCustomPrimSkills)
	{
		uint8 PrimarySkill[GameConstants::PRIMARY_SKILLS];
	}
	uint8 unknown[16];
}

struct secondarySkill{
	uint8 Skill;
	uint8 level;
}

struct h3map_terrain{
	terrain world_tileset[width][height];
	if(TwoLevel)
	{
		terrain second_world_tileset[width][height];
	}
}

struct creature{

	if(version > ROE)
	{
		uint16 ID;
	}
	else
	{
		uint8 ID;
	}
	
	uint16 count;
}

struct terrain{
	uint8 Type;
	uint8 View;
	uint8 riverType;
	uint8 riverDir;
	uint8 roadType;
	uint8 roadDir;
	uint8 extTileFlags;
}

struct h3map_def{
	uint32 defAmount;
	def def[defAmount]
}

struct def{
	string name;
	uint8 bytes[12];
	uint16 terrainAllowed;
	uint16 terrainMenu;
	uint32 id;
	uint32 subid;
	uint8 type;
	uint8 printPriority;
	uint16 unknown;
}

struct h3map_object{
	uint32 count;
	object object[count];
}

struct object{
	uint8 x;
	uint8 y;
	uint8 z;
	uint32 defnum;
	uint8 unknown[5];
		
	if(h3map_def.def[defnum].id == EVENT)
	{
		uint8 hasMessage;
		if(hasMessage)
		{
			string message;
		}
		uint8 hasGuards;
		if(hasGuards)
		{
			creature guards[7];
		}
		uint32 unknow;
		
		uint32 gainedExp;
		uint32 manaDiff;
		uint8 moraleDiff;
		uint8 luckDiff;
		uint32 resources[7];
		uint8 primskills[4];
		uint8 countSkill;
		secondarySkill skill[ count_gained_abilities];
		uint8 countArtifact;
		if(version == ROE)
		{
			uint8 ArtifactID[countArtifact];
		}
		else
		{
			uint16 ArtifactID[countArtifact];
		}
		uint8 countSpell;
		uint8 SpellID[countSpell];
		uint8 countCreature;
		creature creature[countCreature];
		uint8 unknown_1[8];
		uint8 availableFor;
		uint8 computerActivate;
		uint8 removeAfterVisit;
		uint32 unknown_2;
	}	
	
	if(h3map_def.def[defnum].id == HERO)
	{
		hero hero;
	}
	
	if(h3map_def.def[defnum].id == MONSTER)
	{
		if(version > ROE)
		{
			uint32 creID;
		}
		
		uint16 creCount;
		uint8 creCharacter;
		uint8 hasMessage;
		
		if(hasMessage)
		{
			string message;
			uint32 resources[7];
			
			if(version == ROE)
			{
				uint8 artID;
			}
			
			else
			{
				uint8 artID;
			}
		}
		uint8 creNeverFlees;
		uint8 creNotGrowingTeam;
		uint8 unknown_1[2];
	}
	
	if(h3map_def.def[defnum].id == BOOTLE)
	{
		string message;
		uint32 unknown_1;
	}

	if(h3map_def.def[defnum].id == SEER_HUT)
	{
		if(version > ROE)
		{
			quest quest;
			
			if(quest.missionType > 0)
			{
				uint8 rewardType;
				
				if(rewardType == EXPERIENCE || rewardType == MANA_POINTS)
				{
					uint32 value;
				}
				
				if(rewardType == MORALE_BONUS || rewardType == LUCK_BONUS || rewardType == SPELL)
				{
					uint8 value;
				}		

				if(rewardType == RESOURCES)
				{
					uint8 ID;
					uint32 value;
				}
				
				if(rewardType == PRIMARY_SKILL || rewardType == SECONDARY_SKILL)
				{
					uint8 ID;
					uint8 value;
				}

				if(rewardType == ARTIFACT)
				{
					if(version == ROE)
					{
						uint8 ID;
					}
					else
					{
						uint16 ID;
					}
				}
				
				if(rewardType == CREATURE)
				{
					if(version == ROE)
					{
						uint16 ID;
						uint16 value;
					}
					else
					{
						uint8 ID;
						uint16 value;
					}					
				}
			}
			uint8 unknown_1[2];
		}
		else
		{
			uint8 unknown_1[3];
		}
	}
	
	if(h3map_def.def[defnum].id == SCHOLAR)
	{
		uint8 bonusType;
		uint8 bonusID;
		uint8 unknown_1[6];
	}

	if(h3map_def.def[defnum].id == GARRISON)
	{
		uint8 playerColor;
		uint8 unknown_1[3];
		creature army[7];
		if(version > ROE)
		{
			uint8 removableUnits;
		}
		uint8 unknown_2[8];
	}

	if(h3map_def.def[defnum].id == ARTIFACT || h3map_def.def[defnum].id == SPELL_SCROLL)
	{		
		if(hasMessage)
		{
			string message;
		}
		uint8 hasGuards;
		if(hasGuards)
		{
			creature guards[7];
		}
		uint32 unknow;

		if(h3map_def.def[defnum].id == SPELL_SCROLL)
		{
			uint32 spellID;
		}		
	}
	
	if(h3map_def.def[defnum].id == RESOURCE)
	{		
		if(hasMessage)
		{
			string message;
		}
		uint8 hasGuards;
		if(hasGuards)
		{
			creature guards[7];
		}
		uint32 unknow;
		uint32 amount;
		uint32 unknow_1;
	}

	if(h3map_def.def[defnum].id == TOWN)
	{		
		if(hasMessage)
		{
			string message;
		}
		uint8 hasGuards;
		if(hasGuards)
		{
			creature guards[7];
		}
		
		uint32 unknow;
		uint32 amount;
		uint32 unknow_1;
	}

	if(h3map_def.def[defnum].id == MINE || h3map_def.def[defnum].id == CREATURE_GENERATOR)
	{		
		uint8 playerColor;
		uint8 unknown_1[3];
	}

	if(h3map_def.def[defnum].id == SHRINE_OF_MAGIC_THOUGHT)
	{		
		uint8 spellID;
		uint8 unknown_1[3];
	}

	if(h3map_def.def[defnum].id == PANDORAS_BOX)
	{		
		uint8 hasMessage;
		if(hasMessage)
		{
			string message;
		}
		uint8 hasGuards;
		if(hasGuards)
		{
			creature guards[7];
		}
		uint32 unknow;
		
		uint32 gainedExp;
		uint32 manaDiff;
		uint8 moraleDiff;
		uint8 luckDiff;
		uint32 resources[7];
		uint8 primskills[4];
		uint8 countSkill;
		secondarySkill skill[ count_gained_abilities];
		uint8 countArtifact;
		if(version == ROE)
		{
			uint8 ArtifactID[countArtifact];
		}
		else
		{
			uint16 ArtifactID[countArtifact];
		}
		uint8 countSpell;
		uint8 SpellID[countSpell];
		uint8 countCreature;
		creature creature[countCreature];
		uint8 unknown_1[8];
	}
	
	if(h3map_def.def[defnum].id == GRAIL)
	{
		uint32 grailRadious;
	}
	
	if(h3map_def.def[defnum].id == QUEST_GUARD || h3map_def.def[defnum].id == BORDERGUARD || h3map_def.def[defnum].id == BORDER_GATE)
	{
		quest quest;
	}	
	
	if(h3map_def.def[defnum].id == SHIPYARD || h3map_def.def[defnum].id == LIGHTHOUSE)
	{
		uint32 playercolor;
	}	

}

struct quest{
	uint8 missionType;
	if(missionType == 2)
	{
		uint8 m2stats[4];
	}

	if(missionType == 1 || missionType == 3 || missionType == 4)
	{
		uint32 m13489val;
	}

	if(missionType == 5)
	{
		uint8 artCount;
		uint16 artID[artCount];
	}
	
	if(missionType == 6)
	{
		uint8 typeCount;
		quest_creature quest_creature[typeCount];
	}
	
	if(missionType == 7)
	{
		uint32 m7resources[7]
	}
	
	if(missionType == 8 || missionType == 9)
	{
		uint8 m13489val;
	}	
	
	uint32 limit;
	string firstVisitText;
	string nextVisitText;
	string completedText;
}

struct quest_creature{
	uint16 type;
	uint16 count;
}

struct town{

	if(version > ROE)
	{
		uint32 ID;
	}
	uint8 playerColor;
	uint8 hasName;
	if(hasName)
	{
		string name;
	}
	uint8 hasGarrison;
	if(hasGarrison)
	{
		creature army[7];
	}
	uint8 formation;
	uint8 hasCustomBuildings;
	if(hasCustomBuildings)
	{
		uint8 builtBuildings[6];
		uint8 forbiddenBuildings[6];
	}
	else
	{
		uint8 hasFort;
	}
	
	if(version > ROE)
	{
		uint8 obligatorySpells[9];
	}
	uint8 possibleSpells;
	uint8 eventCount;
	castleEvent castleEvent[eventCount];
	
	if(version > AB)
	{
		uint8 alignment;
	}
	uint8 unknown[3];
}

struct h3map_event{
	uint32 count;
	event event[count];
}

struct event{
	string name;
	string message;
	uint32 resources[7];
	uint8 players;
	if(version > AB)
	{
		uint8 humanAffected;
	}
	uint8 computerAffected;
	uint16 firstOccurence;
	uint8 nextOccurence;
	uint8 unknow[17];
}

struct castleEvent{
	event event;
	uint8 buildings[6];
	uint16 creaturesBonus[7];
	uint32 unknown;
}

http://corexii.com/h3m_description.english.txt (uncomplete)

http://svn.code.sf.net/p/vcmi/code/tags/0.8/h3m.txt (complete - Polish)

Campaigns formats

Describe soon...

Retrieved from "https://wiki.vcmi.eu/index.php?title=User:Viader&oldid=1249"