GameConstants.h 27 KB

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