GameConstants.h 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092
  1. /*
  2. * GameConstants.h, part of VCMI engine
  3. *
  4. * Authors: listed in file AUTHORS in main folder
  5. *
  6. * License: GNU General Public License v2.0 or later
  7. * Full text of license available in license.txt file, in main folder
  8. *
  9. */
  10. #pragma once
  11. #include "ConstTransitivePtr.h"
  12. namespace GameConstants
  13. {
  14. DLL_LINKAGE extern const std::string VCMI_VERSION;
  15. const int PUZZLE_MAP_PIECES = 48;
  16. const int MAX_HEROES_PER_PLAYER = 8;
  17. const int AVAILABLE_HEROES_PER_PLAYER = 2;
  18. const int ALL_PLAYERS = 255; //bitfield
  19. const ui16 BACKPACK_START = 19;
  20. const int CREATURES_PER_TOWN = 7; //without upgrades
  21. const int SPELL_LEVELS = 5;
  22. const int SPELL_SCHOOL_LEVELS = 4;
  23. const int CRE_LEVELS = 10; // number of creature experience levels
  24. const int HERO_GOLD_COST = 2500;
  25. const int SPELLBOOK_GOLD_COST = 500;
  26. const int SKILL_GOLD_COST = 2000;
  27. const int BATTLE_PENALTY_DISTANCE = 10; //if the distance is > than this, then shooting stack has distance penalty
  28. const int ARMY_SIZE = 7;
  29. const int SKILL_PER_HERO=8;
  30. const int SKILL_QUANTITY=28;
  31. const int PRIMARY_SKILLS=4;
  32. const int TERRAIN_TYPES=10;
  33. const int RESOURCE_QUANTITY=8;
  34. const int HEROES_PER_TYPE=8; //amount of heroes of each type
  35. // amounts of OH3 objects. Can be changed by mods, should be used only during H3 loading phase
  36. const int F_NUMBER = 9;
  37. const int ARTIFACTS_QUANTITY=171;
  38. const int HEROES_QUANTITY=156;
  39. const int SPELLS_QUANTITY=70;
  40. const int CREATURES_COUNT = 197;
  41. const ui32 BASE_MOVEMENT_COST = 100; //default cost for non-diagonal movement
  42. const int HERO_PORTRAIT_SHIFT = 30;// 2 special frames + some extra portraits
  43. }
  44. class CArtifact;
  45. class CArtifactInstance;
  46. class CCreature;
  47. class CHero;
  48. class CSpell;
  49. class CSkill;
  50. class CGameInfoCallback;
  51. class CNonConstInfoCallback;
  52. #define ID_LIKE_CLASS_COMMON(CLASS_NAME, ENUM_NAME) \
  53. CLASS_NAME(const CLASS_NAME & other) \
  54. { \
  55. num = other.num; \
  56. } \
  57. CLASS_NAME & operator=(const CLASS_NAME & other) \
  58. { \
  59. num = other.num; \
  60. return *this; \
  61. } \
  62. explicit CLASS_NAME(si32 id) \
  63. : num(static_cast<ENUM_NAME>(id)) \
  64. {} \
  65. operator ENUM_NAME() const \
  66. { \
  67. return num; \
  68. } \
  69. ENUM_NAME toEnum() const \
  70. { \
  71. return num; \
  72. } \
  73. template <typename Handler> void serialize(Handler &h, const int version) \
  74. { \
  75. h & num; \
  76. } \
  77. CLASS_NAME & advance(int i) \
  78. { \
  79. num = (ENUM_NAME)((int)num + i); \
  80. return *this; \
  81. }
  82. // Operators are performance-critical and to be inlined they must be in header
  83. #define ID_LIKE_OPERATORS_INTERNAL(A, B, AN, BN) \
  84. STRONG_INLINE bool operator==(const A & a, const B & b) \
  85. { \
  86. return AN == BN ; \
  87. } \
  88. STRONG_INLINE bool operator!=(const A & a, const B & b) \
  89. { \
  90. return AN != BN ; \
  91. } \
  92. STRONG_INLINE bool operator<(const A & a, const B & b) \
  93. { \
  94. return AN < BN ; \
  95. } \
  96. STRONG_INLINE bool operator<=(const A & a, const B & b) \
  97. { \
  98. return AN <= BN ; \
  99. } \
  100. STRONG_INLINE bool operator>(const A & a, const B & b) \
  101. { \
  102. return AN > BN ; \
  103. } \
  104. STRONG_INLINE bool operator>=(const A & a, const B & b) \
  105. { \
  106. return AN >= BN ; \
  107. }
  108. #define ID_LIKE_OPERATORS(CLASS_NAME, ENUM_NAME) \
  109. ID_LIKE_OPERATORS_INTERNAL(CLASS_NAME, CLASS_NAME, a.num, b.num) \
  110. ID_LIKE_OPERATORS_INTERNAL(CLASS_NAME, ENUM_NAME, a.num, b) \
  111. ID_LIKE_OPERATORS_INTERNAL(ENUM_NAME, CLASS_NAME, a, b.num)
  112. #define OP_DECL_INT(CLASS_NAME, OP) \
  113. bool operator OP (const CLASS_NAME & b) const \
  114. { \
  115. return num OP b.num; \
  116. }
  117. #define INSTID_LIKE_CLASS_COMMON(CLASS_NAME, NUMERIC_NAME) \
  118. public: \
  119. CLASS_NAME() : BaseForID<CLASS_NAME, NUMERIC_NAME>(-1) {} \
  120. CLASS_NAME(const CLASS_NAME & other): \
  121. BaseForID<CLASS_NAME, NUMERIC_NAME>(other) \
  122. { \
  123. } \
  124. CLASS_NAME & operator=(const CLASS_NAME & other) \
  125. { \
  126. num = other.num; \
  127. return *this; \
  128. } \
  129. explicit CLASS_NAME(si32 id) \
  130. : BaseForID<CLASS_NAME, NUMERIC_NAME>(id) \
  131. {}
  132. template < typename Derived, typename NumericType>
  133. class BaseForID
  134. {
  135. protected:
  136. NumericType num;
  137. public:
  138. NumericType getNum() const
  139. {
  140. return num;
  141. }
  142. template <typename Handler> void serialize(Handler &h, const int version)
  143. {
  144. h & num;
  145. }
  146. explicit BaseForID(NumericType _num = -1)
  147. {
  148. num = _num;
  149. }
  150. void advance(int change)
  151. {
  152. num += change;
  153. }
  154. typedef BaseForID<Derived, NumericType> __SelfType;
  155. OP_DECL_INT(__SelfType, ==)
  156. OP_DECL_INT(__SelfType, !=)
  157. OP_DECL_INT(__SelfType, <)
  158. OP_DECL_INT(__SelfType, >)
  159. OP_DECL_INT(__SelfType, <=)
  160. OP_DECL_INT(__SelfType, >=)
  161. };
  162. template<typename Der, typename Num>
  163. std::ostream & operator << (std::ostream & os, BaseForID<Der, Num> id);
  164. template<typename Der, typename Num>
  165. std::ostream & operator << (std::ostream & os, BaseForID<Der, Num> id)
  166. {
  167. //We use common type with short to force char and unsigned char to be promoted and formatted as numbers.
  168. typedef typename std::common_type<short, Num>::type Number;
  169. return os << static_cast<Number>(id.getNum());
  170. }
  171. class ArtifactInstanceID : public BaseForID<ArtifactInstanceID, si32>
  172. {
  173. INSTID_LIKE_CLASS_COMMON(ArtifactInstanceID, si32)
  174. friend class CGameInfoCallback;
  175. friend class CNonConstInfoCallback;
  176. };
  177. class QueryID : public BaseForID<QueryID, si32>
  178. {
  179. INSTID_LIKE_CLASS_COMMON(QueryID, si32)
  180. QueryID & operator++()
  181. {
  182. ++num;
  183. return *this;
  184. }
  185. };
  186. class ObjectInstanceID : public BaseForID<ObjectInstanceID, si32>
  187. {
  188. INSTID_LIKE_CLASS_COMMON(ObjectInstanceID, si32)
  189. friend class CGameInfoCallback;
  190. friend class CNonConstInfoCallback;
  191. };
  192. class HeroTypeID : public BaseForID<HeroTypeID, si32>
  193. {
  194. INSTID_LIKE_CLASS_COMMON(HeroTypeID, si32)
  195. };
  196. class SlotID : public BaseForID<SlotID, si32>
  197. {
  198. INSTID_LIKE_CLASS_COMMON(SlotID, si32)
  199. friend class CGameInfoCallback;
  200. friend class CNonConstInfoCallback;
  201. DLL_LINKAGE static const SlotID COMMANDER_SLOT_PLACEHOLDER;
  202. DLL_LINKAGE static const SlotID SUMMONED_SLOT_PLACEHOLDER; ///<for all summoned creatures, only during battle
  203. DLL_LINKAGE static const SlotID WAR_MACHINES_SLOT; ///<for all war machines during battle
  204. DLL_LINKAGE static const SlotID ARROW_TOWERS_SLOT; ///<for all arrow towers during battle
  205. bool validSlot() const
  206. {
  207. return getNum() >= 0 && getNum() < GameConstants::ARMY_SIZE;
  208. }
  209. };
  210. class PlayerColor : public BaseForID<PlayerColor, ui8>
  211. {
  212. INSTID_LIKE_CLASS_COMMON(PlayerColor, ui8)
  213. enum EPlayerColor
  214. {
  215. PLAYER_LIMIT_I = 8
  216. };
  217. DLL_LINKAGE static const PlayerColor SPECTATOR; //252
  218. DLL_LINKAGE static const PlayerColor CANNOT_DETERMINE; //253
  219. DLL_LINKAGE static const PlayerColor UNFLAGGABLE; //254 - neutral objects (pandora, banks)
  220. DLL_LINKAGE static const PlayerColor NEUTRAL; //255
  221. DLL_LINKAGE static const PlayerColor PLAYER_LIMIT; //player limit per map
  222. DLL_LINKAGE bool isValidPlayer() const; //valid means < PLAYER_LIMIT (especially non-neutral)
  223. DLL_LINKAGE bool isSpectator() const;
  224. DLL_LINKAGE std::string getStr(bool L10n = false) const;
  225. DLL_LINKAGE std::string getStrCap(bool L10n = false) const;
  226. friend class CGameInfoCallback;
  227. friend class CNonConstInfoCallback;
  228. };
  229. class TeamID : public BaseForID<TeamID, ui8>
  230. {
  231. INSTID_LIKE_CLASS_COMMON(TeamID, ui8)
  232. DLL_LINKAGE static const TeamID NO_TEAM;
  233. friend class CGameInfoCallback;
  234. friend class CNonConstInfoCallback;
  235. };
  236. class TeleportChannelID : public BaseForID<TeleportChannelID, si32>
  237. {
  238. INSTID_LIKE_CLASS_COMMON(TeleportChannelID, si32)
  239. friend class CGameInfoCallback;
  240. friend class CNonConstInfoCallback;
  241. };
  242. // #ifndef INSTANTIATE_BASE_FOR_ID_HERE
  243. // extern template std::ostream & operator << <ArtifactInstanceID>(std::ostream & os, BaseForID<ArtifactInstanceID> id);
  244. // extern template std::ostream & operator << <ObjectInstanceID>(std::ostream & os, BaseForID<ObjectInstanceID> id);
  245. // #endif
  246. // Enum declarations
  247. namespace PrimarySkill
  248. {
  249. enum PrimarySkill { ATTACK, DEFENSE, SPELL_POWER, KNOWLEDGE,
  250. EXPERIENCE = 4}; //for some reason changePrimSkill uses it
  251. }
  252. class SecondarySkill
  253. {
  254. public:
  255. enum ESecondarySkill
  256. {
  257. WRONG = -2,
  258. DEFAULT = -1,
  259. PATHFINDING = 0, ARCHERY, LOGISTICS, SCOUTING, DIPLOMACY, NAVIGATION, LEADERSHIP, WISDOM, MYSTICISM,
  260. LUCK, BALLISTICS, EAGLE_EYE, NECROMANCY, ESTATES, FIRE_MAGIC, AIR_MAGIC, WATER_MAGIC, EARTH_MAGIC,
  261. SCHOLAR, TACTICS, ARTILLERY, LEARNING, OFFENCE, ARMORER, INTELLIGENCE, SORCERY, RESISTANCE,
  262. FIRST_AID, SKILL_SIZE
  263. };
  264. static_assert(GameConstants::SKILL_QUANTITY == SKILL_SIZE, "Incorrect number of skills");
  265. SecondarySkill(ESecondarySkill _num = WRONG) : num(_num)
  266. {}
  267. DLL_LINKAGE const CSkill * toSkill() const;
  268. ID_LIKE_CLASS_COMMON(SecondarySkill, ESecondarySkill)
  269. ESecondarySkill num;
  270. };
  271. ID_LIKE_OPERATORS(SecondarySkill, SecondarySkill::ESecondarySkill)
  272. namespace EAlignment
  273. {
  274. enum EAlignment { GOOD, EVIL, NEUTRAL };
  275. }
  276. namespace ETownType
  277. {
  278. enum ETownType
  279. {
  280. ANY = -1,
  281. CASTLE, RAMPART, TOWER, INFERNO, NECROPOLIS, DUNGEON, STRONGHOLD, FORTRESS, CONFLUX, NEUTRAL
  282. };
  283. }
  284. class BuildingID
  285. {
  286. public:
  287. //Quite useful as long as most of building mechanics hardcoded
  288. // NOTE: all building with completely configurable mechanics will be removed from list
  289. enum EBuildingID
  290. {
  291. DEFAULT = -50,
  292. NONE = -1,
  293. MAGES_GUILD_1 = 0, MAGES_GUILD_2, MAGES_GUILD_3, MAGES_GUILD_4, MAGES_GUILD_5,
  294. TAVERN, SHIPYARD, FORT, CITADEL, CASTLE,
  295. VILLAGE_HALL, TOWN_HALL, CITY_HALL, CAPITOL, MARKETPLACE,
  296. RESOURCE_SILO, BLACKSMITH, SPECIAL_1, HORDE_1, HORDE_1_UPGR,
  297. SHIP, SPECIAL_2, SPECIAL_3, SPECIAL_4, HORDE_2,
  298. HORDE_2_UPGR, GRAIL, EXTRA_TOWN_HALL, EXTRA_CITY_HALL, EXTRA_CAPITOL,
  299. DWELL_FIRST=30, DWELL_LVL_2, DWELL_LVL_3, DWELL_LVL_4, DWELL_LVL_5, DWELL_LVL_6, DWELL_LAST=36,
  300. DWELL_UP_FIRST=37, DWELL_LVL_2_UP, DWELL_LVL_3_UP, DWELL_LVL_4_UP, DWELL_LVL_5_UP,
  301. DWELL_LVL_6_UP, DWELL_UP_LAST=43,
  302. DWELL_LVL_1 = DWELL_FIRST,
  303. DWELL_LVL_7 = DWELL_LAST,
  304. DWELL_LVL_1_UP = DWELL_UP_FIRST,
  305. DWELL_LVL_7_UP = DWELL_UP_LAST,
  306. //Special buildings for towns.
  307. LIGHTHOUSE = SPECIAL_1,
  308. STABLES = SPECIAL_2, //Castle
  309. BROTHERHOOD = SPECIAL_3,
  310. MYSTIC_POND = SPECIAL_1,
  311. FOUNTAIN_OF_FORTUNE = SPECIAL_2, //Rampart
  312. TREASURY = SPECIAL_3,
  313. ARTIFACT_MERCHANT = SPECIAL_1,
  314. LOOKOUT_TOWER = SPECIAL_2, //Tower
  315. LIBRARY = SPECIAL_3,
  316. WALL_OF_KNOWLEDGE = SPECIAL_4,
  317. STORMCLOUDS = SPECIAL_2,
  318. CASTLE_GATE = SPECIAL_3, //Inferno
  319. ORDER_OF_FIRE = SPECIAL_4,
  320. COVER_OF_DARKNESS = SPECIAL_1,
  321. NECROMANCY_AMPLIFIER = SPECIAL_2, //Necropolis
  322. SKELETON_TRANSFORMER = SPECIAL_3,
  323. //ARTIFACT_MERCHANT - same ID as in tower
  324. MANA_VORTEX = SPECIAL_2,
  325. PORTAL_OF_SUMMON = SPECIAL_3, //Dungeon
  326. BATTLE_ACADEMY = SPECIAL_4,
  327. ESCAPE_TUNNEL = SPECIAL_1,
  328. FREELANCERS_GUILD = SPECIAL_2, //Stronghold
  329. BALLISTA_YARD = SPECIAL_3,
  330. HALL_OF_VALHALLA = SPECIAL_4,
  331. CAGE_OF_WARLORDS = SPECIAL_1,
  332. GLYPHS_OF_FEAR = SPECIAL_2, // Fortress
  333. BLOOD_OBELISK = SPECIAL_3,
  334. //ARTIFACT_MERCHANT - same ID as in tower
  335. MAGIC_UNIVERSITY = SPECIAL_2, // Conflux
  336. };
  337. BuildingID(EBuildingID _num = NONE) : num(_num)
  338. {}
  339. ID_LIKE_CLASS_COMMON(BuildingID, EBuildingID)
  340. EBuildingID num;
  341. };
  342. ID_LIKE_OPERATORS(BuildingID, BuildingID::EBuildingID)
  343. namespace EAiTactic
  344. {
  345. enum EAiTactic
  346. {
  347. NONE = -1,
  348. RANDOM,
  349. WARRIOR,
  350. BUILDER,
  351. EXPLORER
  352. };
  353. }
  354. namespace EBuildingState
  355. {
  356. enum EBuildingState
  357. {
  358. HAVE_CAPITAL, NO_WATER, FORBIDDEN, ADD_MAGES_GUILD, ALREADY_PRESENT, CANT_BUILD_TODAY,
  359. NO_RESOURCES, ALLOWED, PREREQUIRES, MISSING_BASE, BUILDING_ERROR, TOWN_NOT_OWNED
  360. };
  361. }
  362. namespace ESpellCastProblem
  363. {
  364. enum ESpellCastProblem
  365. {
  366. OK, NO_HERO_TO_CAST_SPELL, CASTS_PER_TURN_LIMIT, NO_SPELLBOOK,
  367. HERO_DOESNT_KNOW_SPELL, NOT_ENOUGH_MANA, ADVMAP_SPELL_INSTEAD_OF_BATTLE_SPELL,
  368. SPELL_LEVEL_LIMIT_EXCEEDED, NO_SPELLS_TO_DISPEL,
  369. NO_APPROPRIATE_TARGET, STACK_IMMUNE_TO_SPELL, WRONG_SPELL_TARGET, ONGOING_TACTIC_PHASE,
  370. MAGIC_IS_BLOCKED, //For Orb of Inhibition and similar - no casting at all
  371. INVALID
  372. };
  373. }
  374. namespace EMarketMode
  375. {
  376. enum EMarketMode
  377. {
  378. RESOURCE_RESOURCE, RESOURCE_PLAYER, CREATURE_RESOURCE, RESOURCE_ARTIFACT,
  379. ARTIFACT_RESOURCE, ARTIFACT_EXP, CREATURE_EXP, CREATURE_UNDEAD, RESOURCE_SKILL,
  380. MARTKET_AFTER_LAST_PLACEHOLDER
  381. };
  382. }
  383. namespace ECommander
  384. {
  385. enum SecondarySkills {ATTACK, DEFENSE, HEALTH, DAMAGE, SPEED, SPELL_POWER, CASTS, RESISTANCE};
  386. const int MAX_SKILL_LEVEL = 5;
  387. }
  388. namespace EWallPart
  389. {
  390. enum EWallPart
  391. {
  392. INDESTRUCTIBLE_PART_OF_GATE = -3, INDESTRUCTIBLE_PART = -2, INVALID = -1,
  393. KEEP = 0, BOTTOM_TOWER, BOTTOM_WALL, BELOW_GATE, OVER_GATE, UPPER_WALL, UPPER_TOWER, GATE,
  394. PARTS_COUNT /* This constant SHOULD always stay as the last item in the enum. */
  395. };
  396. }
  397. namespace EWallState
  398. {
  399. enum EWallState
  400. {
  401. NONE = -1, //no wall
  402. DESTROYED,
  403. DAMAGED,
  404. INTACT
  405. };
  406. }
  407. enum class EGateState : ui8
  408. {
  409. NONE,
  410. CLOSED,
  411. BLOCKED, //dead or alive stack blocking from outside
  412. OPENED,
  413. DESTROYED
  414. };
  415. namespace ESiegeHex
  416. {
  417. enum ESiegeHex : si16
  418. {
  419. DESTRUCTIBLE_WALL_1 = 29,
  420. DESTRUCTIBLE_WALL_2 = 78,
  421. DESTRUCTIBLE_WALL_3 = 130,
  422. DESTRUCTIBLE_WALL_4 = 182,
  423. GATE_BRIDGE = 94,
  424. GATE_OUTER = 95,
  425. GATE_INNER = 96
  426. };
  427. }
  428. namespace ETileType
  429. {
  430. enum ETileType
  431. {
  432. FREE,
  433. POSSIBLE,
  434. BLOCKED,
  435. USED
  436. };
  437. }
  438. enum class ETeleportChannelType
  439. {
  440. IMPASSABLE,
  441. BIDIRECTIONAL,
  442. UNIDIRECTIONAL,
  443. MIXED
  444. };
  445. namespace ERiverType
  446. {
  447. enum ERiverType
  448. {
  449. NO_RIVER, CLEAR_RIVER, ICY_RIVER, MUDDY_RIVER, LAVA_RIVER
  450. };
  451. }
  452. namespace ERoadType
  453. {
  454. enum ERoadType
  455. {
  456. NO_ROAD, DIRT_ROAD, GRAVEL_ROAD, COBBLESTONE_ROAD
  457. };
  458. }
  459. class Obj
  460. {
  461. public:
  462. enum EObj
  463. {
  464. NO_OBJ = -1,
  465. ALTAR_OF_SACRIFICE = 2,
  466. ANCHOR_POINT = 3,
  467. ARENA = 4,
  468. ARTIFACT = 5,
  469. PANDORAS_BOX = 6,
  470. BLACK_MARKET = 7,
  471. BOAT = 8,
  472. BORDERGUARD = 9,
  473. KEYMASTER = 10,
  474. BUOY = 11,
  475. CAMPFIRE = 12,
  476. CARTOGRAPHER = 13,
  477. SWAN_POND = 14,
  478. COVER_OF_DARKNESS = 15,
  479. CREATURE_BANK = 16,
  480. CREATURE_GENERATOR1 = 17,
  481. CREATURE_GENERATOR2 = 18,
  482. CREATURE_GENERATOR3 = 19,
  483. CREATURE_GENERATOR4 = 20,
  484. CURSED_GROUND1 = 21,
  485. CORPSE = 22,
  486. MARLETTO_TOWER = 23,
  487. DERELICT_SHIP = 24,
  488. DRAGON_UTOPIA = 25,
  489. EVENT = 26,
  490. EYE_OF_MAGI = 27,
  491. FAERIE_RING = 28,
  492. FLOTSAM = 29,
  493. FOUNTAIN_OF_FORTUNE = 30,
  494. FOUNTAIN_OF_YOUTH = 31,
  495. GARDEN_OF_REVELATION = 32,
  496. GARRISON = 33,
  497. HERO = 34,
  498. HILL_FORT = 35,
  499. GRAIL = 36,
  500. HUT_OF_MAGI = 37,
  501. IDOL_OF_FORTUNE = 38,
  502. LEAN_TO = 39,
  503. LIBRARY_OF_ENLIGHTENMENT = 41,
  504. LIGHTHOUSE = 42,
  505. MONOLITH_ONE_WAY_ENTRANCE = 43,
  506. MONOLITH_ONE_WAY_EXIT = 44,
  507. MONOLITH_TWO_WAY = 45,
  508. MAGIC_PLAINS1 = 46,
  509. SCHOOL_OF_MAGIC = 47,
  510. MAGIC_SPRING = 48,
  511. MAGIC_WELL = 49,
  512. MERCENARY_CAMP = 51,
  513. MERMAID = 52,
  514. MINE = 53,
  515. MONSTER = 54,
  516. MYSTICAL_GARDEN = 55,
  517. OASIS = 56,
  518. OBELISK = 57,
  519. REDWOOD_OBSERVATORY = 58,
  520. OCEAN_BOTTLE = 59,
  521. PILLAR_OF_FIRE = 60,
  522. STAR_AXIS = 61,
  523. PRISON = 62,
  524. PYRAMID = 63,//subtype 0
  525. WOG_OBJECT = 63,//subtype > 0
  526. RALLY_FLAG = 64,
  527. RANDOM_ART = 65,
  528. RANDOM_TREASURE_ART = 66,
  529. RANDOM_MINOR_ART = 67,
  530. RANDOM_MAJOR_ART = 68,
  531. RANDOM_RELIC_ART = 69,
  532. RANDOM_HERO = 70,
  533. RANDOM_MONSTER = 71,
  534. RANDOM_MONSTER_L1 = 72,
  535. RANDOM_MONSTER_L2 = 73,
  536. RANDOM_MONSTER_L3 = 74,
  537. RANDOM_MONSTER_L4 = 75,
  538. RANDOM_RESOURCE = 76,
  539. RANDOM_TOWN = 77,
  540. REFUGEE_CAMP = 78,
  541. RESOURCE = 79,
  542. SANCTUARY = 80,
  543. SCHOLAR = 81,
  544. SEA_CHEST = 82,
  545. SEER_HUT = 83,
  546. CRYPT = 84,
  547. SHIPWRECK = 85,
  548. SHIPWRECK_SURVIVOR = 86,
  549. SHIPYARD = 87,
  550. SHRINE_OF_MAGIC_INCANTATION = 88,
  551. SHRINE_OF_MAGIC_GESTURE = 89,
  552. SHRINE_OF_MAGIC_THOUGHT = 90,
  553. SIGN = 91,
  554. SIRENS = 92,
  555. SPELL_SCROLL = 93,
  556. STABLES = 94,
  557. TAVERN = 95,
  558. TEMPLE = 96,
  559. DEN_OF_THIEVES = 97,
  560. TOWN = 98,
  561. TRADING_POST = 99,
  562. LEARNING_STONE = 100,
  563. TREASURE_CHEST = 101,
  564. TREE_OF_KNOWLEDGE = 102,
  565. SUBTERRANEAN_GATE = 103,
  566. UNIVERSITY = 104,
  567. WAGON = 105,
  568. WAR_MACHINE_FACTORY = 106,
  569. SCHOOL_OF_WAR = 107,
  570. WARRIORS_TOMB = 108,
  571. WATER_WHEEL = 109,
  572. WATERING_HOLE = 110,
  573. WHIRLPOOL = 111,
  574. WINDMILL = 112,
  575. WITCH_HUT = 113,
  576. HOLE = 124,
  577. RANDOM_MONSTER_L5 = 162,
  578. RANDOM_MONSTER_L6 = 163,
  579. RANDOM_MONSTER_L7 = 164,
  580. BORDER_GATE = 212,
  581. FREELANCERS_GUILD = 213,
  582. HERO_PLACEHOLDER = 214,
  583. QUEST_GUARD = 215,
  584. RANDOM_DWELLING = 216,
  585. RANDOM_DWELLING_LVL = 217, //subtype = creature level
  586. RANDOM_DWELLING_FACTION = 218, //subtype = faction
  587. GARRISON2 = 219,
  588. ABANDONED_MINE = 220,
  589. TRADING_POST_SNOW = 221,
  590. CLOVER_FIELD = 222,
  591. CURSED_GROUND2 = 223,
  592. EVIL_FOG = 224,
  593. FAVORABLE_WINDS = 225,
  594. FIERY_FIELDS = 226,
  595. HOLY_GROUNDS = 227,
  596. LUCID_POOLS = 228,
  597. MAGIC_CLOUDS = 229,
  598. MAGIC_PLAINS2 = 230,
  599. ROCKLANDS = 231,
  600. };
  601. Obj(EObj _num = NO_OBJ) : num(_num)
  602. {}
  603. ID_LIKE_CLASS_COMMON(Obj, EObj)
  604. EObj num;
  605. };
  606. ID_LIKE_OPERATORS(Obj, Obj::EObj)
  607. namespace SecSkillLevel
  608. {
  609. enum SecSkillLevel
  610. {
  611. NONE,
  612. BASIC,
  613. ADVANCED,
  614. EXPERT,
  615. LEVELS_SIZE
  616. };
  617. }
  618. //follows ERM BI (battle image) format
  619. namespace BattlefieldBI
  620. {
  621. enum BattlefieldBI
  622. {
  623. NONE = -1,
  624. COASTAL,
  625. CURSED_GROUND,
  626. MAGIC_PLAINS,
  627. HOLY_GROUND,
  628. EVIL_FOG,
  629. CLOVER_FIELD,
  630. LUCID_POOLS,
  631. FIERY_FIELDS,
  632. ROCKLANDS,
  633. MAGIC_CLOUDS
  634. };
  635. }
  636. namespace Date
  637. {
  638. enum EDateType
  639. {
  640. DAY = 0,
  641. DAY_OF_WEEK = 1,
  642. WEEK = 2,
  643. MONTH = 3,
  644. DAY_OF_MONTH
  645. };
  646. }
  647. enum class EActionType : int32_t
  648. {
  649. CANCEL = -3,
  650. END_TACTIC_PHASE = -2,
  651. INVALID = -1,
  652. NO_ACTION = 0,
  653. HERO_SPELL,
  654. WALK, DEFEND,
  655. RETREAT,
  656. SURRENDER,
  657. WALK_AND_ATTACK,
  658. SHOOT,
  659. WAIT,
  660. CATAPULT,
  661. MONSTER_SPELL,
  662. BAD_MORALE,
  663. STACK_HEAL,
  664. DAEMON_SUMMONING
  665. };
  666. DLL_LINKAGE std::ostream & operator<<(std::ostream & os, const EActionType actionType);
  667. class DLL_LINKAGE ETerrainType
  668. {
  669. public:
  670. enum EETerrainType
  671. {
  672. WRONG = -2, BORDER = -1, DIRT, SAND, GRASS, SNOW, SWAMP,
  673. ROUGH, SUBTERRANEAN, LAVA, WATER, ROCK
  674. };
  675. ETerrainType(EETerrainType _num = WRONG) : num(_num)
  676. {}
  677. ID_LIKE_CLASS_COMMON(ETerrainType, EETerrainType)
  678. EETerrainType num;
  679. std::string toString() const;
  680. };
  681. DLL_LINKAGE std::ostream & operator<<(std::ostream & os, const ETerrainType terrainType);
  682. ID_LIKE_OPERATORS(ETerrainType, ETerrainType::EETerrainType)
  683. class DLL_LINKAGE EDiggingStatus
  684. {
  685. public:
  686. enum EEDiggingStatus
  687. {
  688. UNKNOWN = -1,
  689. CAN_DIG = 0,
  690. LACK_OF_MOVEMENT,
  691. WRONG_TERRAIN,
  692. TILE_OCCUPIED
  693. };
  694. EDiggingStatus(EEDiggingStatus _num = UNKNOWN) : num(_num)
  695. {}
  696. ID_LIKE_CLASS_COMMON(EDiggingStatus, EEDiggingStatus)
  697. EEDiggingStatus num;
  698. };
  699. ID_LIKE_OPERATORS(EDiggingStatus, EDiggingStatus::EEDiggingStatus)
  700. class DLL_LINKAGE EPathfindingLayer
  701. {
  702. public:
  703. enum EEPathfindingLayer : ui8
  704. {
  705. LAND = 0, SAIL = 1, WATER, AIR, NUM_LAYERS, WRONG, AUTO
  706. };
  707. EPathfindingLayer(EEPathfindingLayer _num = WRONG) : num(_num)
  708. {}
  709. ID_LIKE_CLASS_COMMON(EPathfindingLayer, EEPathfindingLayer)
  710. EEPathfindingLayer num;
  711. };
  712. DLL_LINKAGE std::ostream & operator<<(std::ostream & os, const EPathfindingLayer pathfindingLayer);
  713. ID_LIKE_OPERATORS(EPathfindingLayer, EPathfindingLayer::EEPathfindingLayer)
  714. class BFieldType
  715. {
  716. public:
  717. // 1. sand/shore 2. sand/mesas 3. dirt/birches 4. dirt/hills 5. dirt/pines 6. grass/hills 7. grass/pines
  718. //8. lava 9. magic plains 10. snow/mountains 11. snow/trees 12. subterranean 13. swamp/trees 14. fiery fields
  719. //15. rock lands 16. magic clouds 17. lucid pools 18. holy ground 19. clover field 20. evil fog
  720. //21. "favorable winds" text on magic plains background 22. cursed ground 23. rough 24. ship to ship 25. ship
  721. enum EBFieldType {NONE = -1, NONE2, SAND_SHORE, SAND_MESAS, DIRT_BIRCHES, DIRT_HILLS, DIRT_PINES, GRASS_HILLS,
  722. GRASS_PINES, LAVA, MAGIC_PLAINS, SNOW_MOUNTAINS, SNOW_TREES, SUBTERRANEAN, SWAMP_TREES, FIERY_FIELDS,
  723. ROCKLANDS, MAGIC_CLOUDS, LUCID_POOLS, HOLY_GROUND, CLOVER_FIELD, EVIL_FOG, FAVORABLE_WINDS, CURSED_GROUND,
  724. ROUGH, SHIP_TO_SHIP, SHIP
  725. };
  726. BFieldType(EBFieldType _num = NONE) : num(_num)
  727. {}
  728. ID_LIKE_CLASS_COMMON(BFieldType, EBFieldType)
  729. EBFieldType num;
  730. };
  731. ID_LIKE_OPERATORS(BFieldType, BFieldType::EBFieldType)
  732. namespace EPlayerStatus
  733. {
  734. enum EStatus {WRONG = -1, INGAME, LOSER, WINNER};
  735. }
  736. namespace PlayerRelations
  737. {
  738. enum PlayerRelations {ENEMIES, ALLIES, SAME_PLAYER};
  739. }
  740. class ArtifactPosition
  741. {
  742. public:
  743. enum EArtifactPosition
  744. {
  745. FIRST_AVAILABLE = -2,
  746. PRE_FIRST = -1, //sometimes used as error, sometimes as first free in backpack
  747. HEAD, SHOULDERS, NECK, RIGHT_HAND, LEFT_HAND, TORSO, //5
  748. RIGHT_RING, LEFT_RING, FEET, //8
  749. MISC1, MISC2, MISC3, MISC4, //12
  750. MACH1, MACH2, MACH3, MACH4, //16
  751. SPELLBOOK, MISC5, //18
  752. AFTER_LAST,
  753. //cres
  754. CREATURE_SLOT = 0,
  755. COMMANDER1 = 0, COMMANDER2, COMMANDER3, COMMANDER4, COMMANDER5, COMMANDER6, COMMANDER_AFTER_LAST
  756. };
  757. static_assert (AFTER_LAST == 19, "incorrect number of artifact slots");
  758. ArtifactPosition(EArtifactPosition _num = PRE_FIRST) : num(_num)
  759. {}
  760. ID_LIKE_CLASS_COMMON(ArtifactPosition, EArtifactPosition)
  761. EArtifactPosition num;
  762. };
  763. ID_LIKE_OPERATORS(ArtifactPosition, ArtifactPosition::EArtifactPosition)
  764. class ArtifactID
  765. {
  766. public:
  767. enum EArtifactID
  768. {
  769. NONE = -1,
  770. SPELLBOOK = 0,
  771. SPELL_SCROLL = 1,
  772. GRAIL = 2,
  773. CATAPULT = 3,
  774. BALLISTA = 4,
  775. AMMO_CART = 5,
  776. FIRST_AID_TENT = 6,
  777. //CENTAUR_AXE = 7,
  778. //BLACKSHARD_OF_THE_DEAD_KNIGHT = 8,
  779. ARMAGEDDONS_BLADE = 128,
  780. TITANS_THUNDER = 135,
  781. //CORNUCOPIA = 140,
  782. //FIXME: the following is only true if WoG is enabled. Otherwise other mod artifacts will take these slots.
  783. ART_SELECTION = 144,
  784. ART_LOCK = 145, // FIXME: We must get rid of this one since it's conflict with artifact from mods. See issue 2455
  785. AXE_OF_SMASHING = 146,
  786. MITHRIL_MAIL = 147,
  787. SWORD_OF_SHARPNESS = 148,
  788. HELM_OF_IMMORTALITY = 149,
  789. PENDANT_OF_SORCERY = 150,
  790. BOOTS_OF_HASTE = 151,
  791. BOW_OF_SEEKING = 152,
  792. DRAGON_EYE_RING = 153
  793. //HARDENED_SHIELD = 154,
  794. //SLAVAS_RING_OF_POWER = 155
  795. };
  796. ArtifactID(EArtifactID _num = NONE) : num(_num)
  797. {}
  798. DLL_LINKAGE const CArtifact * toArtifact() const;
  799. ///json serialization helpers
  800. static si32 decode(const std::string & identifier);
  801. static std::string encode(const si32 index);
  802. ID_LIKE_CLASS_COMMON(ArtifactID, EArtifactID)
  803. EArtifactID num;
  804. };
  805. ID_LIKE_OPERATORS(ArtifactID, ArtifactID::EArtifactID)
  806. class CreatureID
  807. {
  808. public:
  809. enum ECreatureID
  810. {
  811. NONE = -1,
  812. CAVALIER = 10,
  813. CHAMPION = 11,
  814. STONE_GOLEM = 32,
  815. IRON_GOLEM = 33,
  816. IMP = 42,
  817. SKELETON = 56,
  818. WALKING_DEAD = 58,
  819. WIGHTS = 60,
  820. LICHES = 64,
  821. BONE_DRAGON = 68,
  822. TROGLODYTES = 70,
  823. HYDRA = 110,
  824. CHAOS_HYDRA = 111,
  825. AIR_ELEMENTAL = 112,
  826. EARTH_ELEMENTAL = 113,
  827. FIRE_ELEMENTAL = 114,
  828. WATER_ELEMENTAL = 115,
  829. GOLD_GOLEM = 116,
  830. DIAMOND_GOLEM = 117,
  831. PSYCHIC_ELEMENTAL = 120,
  832. CATAPULT = 145,
  833. BALLISTA = 146,
  834. FIRST_AID_TENT = 147,
  835. AMMO_CART = 148,
  836. ARROW_TOWERS = 149
  837. };
  838. CreatureID(ECreatureID _num = NONE) : num(_num)
  839. {}
  840. DLL_LINKAGE const CCreature * toCreature() const;
  841. ID_LIKE_CLASS_COMMON(CreatureID, ECreatureID)
  842. ECreatureID num;
  843. ///json serialization helpers
  844. static si32 decode(const std::string & identifier);
  845. static std::string encode(const si32 index);
  846. };
  847. ID_LIKE_OPERATORS(CreatureID, CreatureID::ECreatureID)
  848. class SpellID
  849. {
  850. public:
  851. enum ESpellID
  852. {
  853. PRESET = -2,
  854. NONE = -1,
  855. SUMMON_BOAT=0, SCUTTLE_BOAT=1, VISIONS=2, VIEW_EARTH=3, DISGUISE=4, VIEW_AIR=5,
  856. FLY=6, WATER_WALK=7, DIMENSION_DOOR=8, TOWN_PORTAL=9,
  857. QUICKSAND=10, LAND_MINE=11, FORCE_FIELD=12, FIRE_WALL=13, EARTHQUAKE=14,
  858. MAGIC_ARROW=15, ICE_BOLT=16, LIGHTNING_BOLT=17, IMPLOSION=18,
  859. CHAIN_LIGHTNING=19, FROST_RING=20, FIREBALL=21, INFERNO=22,
  860. METEOR_SHOWER=23, DEATH_RIPPLE=24, DESTROY_UNDEAD=25, ARMAGEDDON=26,
  861. SHIELD=27, AIR_SHIELD=28, FIRE_SHIELD=29, PROTECTION_FROM_AIR=30,
  862. PROTECTION_FROM_FIRE=31, PROTECTION_FROM_WATER=32,
  863. PROTECTION_FROM_EARTH=33, ANTI_MAGIC=34, DISPEL=35, MAGIC_MIRROR=36,
  864. CURE=37, RESURRECTION=38, ANIMATE_DEAD=39, SACRIFICE=40, BLESS=41,
  865. CURSE=42, BLOODLUST=43, PRECISION=44, WEAKNESS=45, STONE_SKIN=46,
  866. DISRUPTING_RAY=47, PRAYER=48, MIRTH=49, SORROW=50, FORTUNE=51,
  867. MISFORTUNE=52, HASTE=53, SLOW=54, SLAYER=55, FRENZY=56,
  868. TITANS_LIGHTNING_BOLT=57, COUNTERSTRIKE=58, BERSERK=59, HYPNOTIZE=60,
  869. FORGETFULNESS=61, BLIND=62, TELEPORT=63, REMOVE_OBSTACLE=64, CLONE=65,
  870. SUMMON_FIRE_ELEMENTAL=66, SUMMON_EARTH_ELEMENTAL=67, SUMMON_WATER_ELEMENTAL=68, SUMMON_AIR_ELEMENTAL=69,
  871. STONE_GAZE=70, POISON=71, BIND=72, DISEASE=73, PARALYZE=74, AGE=75, DEATH_CLOUD=76, THUNDERBOLT=77,
  872. DISPEL_HELPFUL_SPELLS=78, DEATH_STARE=79, ACID_BREATH_DEFENSE=80, ACID_BREATH_DAMAGE=81,
  873. FIRST_NON_SPELL = 70, AFTER_LAST = 82
  874. };
  875. SpellID(ESpellID _num = NONE) : num(_num)
  876. {}
  877. DLL_LINKAGE const CSpell * toSpell() const;
  878. ID_LIKE_CLASS_COMMON(SpellID, ESpellID)
  879. ESpellID num;
  880. ///json serialization helpers
  881. static si32 decode(const std::string & identifier);
  882. static std::string encode(const si32 index);
  883. };
  884. ID_LIKE_OPERATORS(SpellID, SpellID::ESpellID)
  885. enum class ESpellSchool: ui8
  886. {
  887. AIR = 0,
  888. FIRE = 1,
  889. WATER = 2,
  890. EARTH = 3
  891. };
  892. enum class EMetaclass: ui8
  893. {
  894. INVALID = 0,
  895. ARTIFACT,
  896. CREATURE,
  897. FACTION,
  898. EXPERIENCE,
  899. HERO,
  900. HEROCLASS,
  901. LUCK,
  902. MANA,
  903. MORALE,
  904. MOVEMENT,
  905. OBJECT,
  906. PRIMARY_SKILL,
  907. SECONDARY_SKILL,
  908. SPELL,
  909. RESOURCE
  910. };
  911. enum class EHealLevel: ui8
  912. {
  913. HEAL,
  914. RESURRECT,
  915. OVERHEAL
  916. };
  917. enum class EHealPower : ui8
  918. {
  919. ONE_BATTLE,
  920. PERMANENT
  921. };
  922. // Typedef declarations
  923. typedef ui8 TFaction;
  924. typedef si64 TExpType;
  925. typedef std::pair<si64, si64> TDmgRange;
  926. typedef si32 TBonusSubtype;
  927. typedef si32 TQuantity;
  928. typedef int TRmgTemplateZoneId;
  929. #undef ID_LIKE_CLASS_COMMON
  930. #undef ID_LIKE_OPERATORS
  931. #undef ID_LIKE_OPERATORS_INTERNAL
  932. #undef INSTID_LIKE_CLASS_COMMON
  933. #undef OP_DECL_INT