CObjectHandler.h 38 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084
  1. #ifndef __COBJECTHANDLER_H__
  2. #define __COBJECTHANDLER_H__
  3. #include "../global.h"
  4. #include <string>
  5. #include <vector>
  6. #include <set>
  7. #include <map>
  8. #include <list>
  9. #include "CCreatureHandler.h"
  10. #include "../lib/HeroBonus.h"
  11. #ifndef _MSC_VER
  12. #include "CHeroHandler.h"
  13. #include "CTownHandler.h"
  14. #include "../lib/VCMI_Lib.h"
  15. #endif
  16. /*
  17. * CObjectHandler.h, part of VCMI engine
  18. *
  19. * Authors: listed in file AUTHORS in main folder
  20. *
  21. * License: GNU General Public License v2.0 or later
  22. * Full text of license available in license.txt file, in main folder
  23. *
  24. */
  25. class IGameCallback;
  26. struct BattleResult;
  27. class CCPPObjectScript;
  28. class CGObjectInstance;
  29. class CScript;
  30. class CObjectScript;
  31. class CGHeroInstance;
  32. class CTown;
  33. class CHero;
  34. class CBuilding;
  35. class CSpell;
  36. class CGTownInstance;
  37. class CGTownBuilding;
  38. class CArtifact;
  39. class CGDefInfo;
  40. class CSpecObjInfo;
  41. struct TerrainTile;
  42. struct InfoWindow;
  43. struct Component;
  44. struct BankConfig;
  45. class CGBoat;
  46. class DLL_EXPORT CCastleEvent
  47. {
  48. public:
  49. std::string name, message;
  50. std::vector<si32> resources; //gain / loss of resources
  51. ui8 players; //players for whom this event can be applied
  52. ui8 forHuman, forComputer;
  53. ui32 firstShow; //postpone of first encounter time in days
  54. ui32 forEvery; //every n days this event will occure
  55. ui8 bytes[6]; //build specific buildings (raw format, similar to town's)
  56. si32 gen[7]; //additional creatures in i-th level dwelling
  57. bool operator<(const CCastleEvent &drugie) const
  58. {
  59. return firstShow<drugie.firstShow;
  60. }
  61. template <typename Handler> void serialize(Handler &h, const int version)
  62. {
  63. h & name & message & resources & players & forHuman & forComputer & firstShow
  64. & forEvery & bytes & gen;
  65. }
  66. };
  67. class CQuest
  68. {
  69. public:
  70. enum Emission {MISSION_NONE = 0, MISSION_LEVEL = 1, MISSION_PRIMARY_STAT = 2, MISSION_KILL_HERO = 3, MISSION_KILL_CREATURE = 4,
  71. MISSION_ART = 5, MISSION_ARMY = 6, MISSION_RESOURCES = 7, MISSION_HERO = 8, MISSION_PLAYER = 9};
  72. ui8 missionType;
  73. si32 lastDay; //after this day (first day is 0) mission cannot be completed; if -1 - no limit
  74. ui32 m13489val;
  75. std::vector<ui32> m2stats;
  76. std::vector<ui16> m5arts; //artifacts id
  77. TSlots m6creatures; //pair[cre id, cre count], CreatureSet info irrelevant
  78. std::vector<ui32> m7resources;
  79. std::string firstVisitText, nextVisitText, completedText;
  80. bool checkQuest (const CGHeroInstance * h) const; //determines whether the quest is complete or not
  81. template <typename Handler> void serialize(Handler &h, const int version)
  82. {
  83. h & missionType & lastDay & m13489val & m2stats & m5arts & m6creatures & m7resources
  84. & firstVisitText & nextVisitText & completedText;
  85. }
  86. };
  87. class DLL_EXPORT IObjectInterface
  88. {
  89. public:
  90. static IGameCallback *cb;
  91. IObjectInterface();
  92. virtual ~IObjectInterface();
  93. virtual void onHeroVisit(const CGHeroInstance * h) const;
  94. virtual void onHeroLeave(const CGHeroInstance * h) const;
  95. virtual void newTurn() const;
  96. virtual void initObj(); //synchr
  97. virtual void setProperty(ui8 what, ui32 val);//synchr
  98. static void preInit(); //called before objs receive their initObj
  99. static void postInit();//caleed after objs receive their initObj
  100. };
  101. class DLL_EXPORT IShipyard
  102. {
  103. public:
  104. const CGObjectInstance *o;
  105. IShipyard(const CGObjectInstance *O);
  106. void getBoatCost(std::vector<si32> &cost) const;
  107. virtual void getOutOffsets(std::vector<int3> &offsets) const =0; //offsets to obj pos when we boat can be placed
  108. //virtual bool validLocation() const; //returns true if there is a water tile near where boat can be placed
  109. int3 bestLocation() const; //returns location when the boat should be placed
  110. int state() const; //0 - can buid, 1 - there is already a boat at dest tile, 2 - dest tile is blocked, 3 - no water
  111. static const IShipyard *castFrom(const CGObjectInstance *obj);
  112. static IShipyard *castFrom(CGObjectInstance *obj);
  113. };
  114. class DLL_EXPORT CGObjectInstance : public IObjectInterface
  115. {
  116. protected:
  117. void getNameVis(std::string &hname) const;
  118. void giveDummyBonus(int heroID, ui8 duration = HeroBonus::ONE_DAY) const;
  119. public:
  120. mutable std::string hoverName;
  121. int3 pos; //h3m pos
  122. si32 ID, subID; //normal ID (this one from OH3 maps ;]) - eg. town=98; hero=34
  123. si32 id;//number of object in CObjectHandler's vector
  124. CGDefInfo * defInfo;
  125. CSpecObjInfo * info;
  126. ui8 animPhaseShift;
  127. ui8 tempOwner;
  128. ui8 blockVisit; //if non-zero then blocks the tile but is visitable from neighbouring tile
  129. virtual ui8 getPassableness() const; //bitmap - if the bit is set the corresponding player can pass through the visitable tiles of object, even if it's blockvis; if not set - default properties from definfo are used
  130. virtual int3 getSightCenter() const; //"center" tile from which the sight distance is calculated
  131. virtual int getSightRadious() const; //sight distance (should be used if player-owned structure)
  132. void getSightTiles(std::set<int3> &tiles) const; //returns reference to the set
  133. int getOwner() const;
  134. void setOwner(int ow);
  135. int getWidth() const; //returns width of object graphic in tiles
  136. int getHeight() const; //returns height of object graphic in tiles
  137. bool visitableAt(int x, int y) const; //returns true if object is visitable at location (x, y) form left top tile of image (x, y in tiles)
  138. int3 getVisitableOffset() const; //returns (x,y,0) offset to first visitable tile from bottom right obj tile (0,0,0) (h3m pos)
  139. bool blockingAt(int x, int y) const; //returns true if object is blocking location (x, y) form left top tile of image (x, y in tiles)
  140. bool coveringAt(int x, int y) const; //returns true if object covers with picture location (x, y) form left top tile of maximal possible image (8 x 6 tiles) (x, y in tiles)
  141. std::set<int3> getBlockedPos() const; //returns set of positions blocked by this object
  142. bool operator<(const CGObjectInstance & cmp) const; //screen printing priority comparing
  143. CGObjectInstance();
  144. virtual ~CGObjectInstance();
  145. //CGObjectInstance(const CGObjectInstance & right);
  146. //CGObjectInstance& operator=(const CGObjectInstance & right);
  147. virtual const std::string & getHoverText() const;
  148. //////////////////////////////////////////////////////////////////////////
  149. void initObj();
  150. void onHeroVisit(const CGHeroInstance * h) const;
  151. void setProperty(ui8 what, ui32 val);//synchr
  152. virtual void setPropertyDer(ui8 what, ui32 val);//synchr
  153. friend class CGameHandler;
  154. template <typename Handler> void serialize(Handler &h, const int version)
  155. {
  156. h & hoverName & pos & ID & subID & id & animPhaseShift & tempOwner & blockVisit;
  157. //definfo is handled by map serializer
  158. }
  159. };
  160. class DLL_EXPORT CPlayersVisited: public CGObjectInstance
  161. {
  162. public:
  163. std::set<ui8> players; //players that visited this object
  164. bool hasVisited(ui8 player) const;
  165. virtual void setPropertyDer( ui8 what, ui32 val );
  166. template <typename Handler> void serialize(Handler &h, const int version)
  167. {
  168. h & static_cast<CGObjectInstance&>(*this);
  169. h & players;
  170. }
  171. };
  172. class DLL_EXPORT CArmedInstance: public CGObjectInstance
  173. {
  174. public:
  175. CCreatureSet army; //army
  176. virtual bool needsLastStack() const; //true if last stack cannot be taken
  177. int getArmyStrength() const; //sum of AI values of creatures
  178. ui64 getPower (TSlot slot) const; //value of specific stack
  179. std::string getRoughAmount (TSlot slot) const; //rought size of specific stack
  180. template <typename Handler> void serialize(Handler &h, const int version)
  181. {
  182. h & static_cast<CGObjectInstance&>(*this);
  183. h & army;
  184. }
  185. };
  186. class DLL_EXPORT CGHeroInstance : public CArmedInstance
  187. {
  188. public:
  189. //////////////////////////////////////////////////////////////////////////
  190. ui8 moveDir; //format: 123
  191. // 8 4
  192. // 765
  193. mutable ui8 isStanding, tacticFormationEnabled;
  194. //////////////////////////////////////////////////////////////////////////
  195. CHero * type;
  196. ui64 exp; //experience points
  197. si32 level; //current level of hero
  198. std::string name; //may be custom
  199. std::string biography; //if custom
  200. si32 portrait; //may be custom
  201. si32 mana; // remaining spell points
  202. std::vector<si32> primSkills; //0-attack, 1-defence, 2-spell power, 3-knowledge
  203. std::vector<std::pair<ui8,ui8> > secSkills; //first - ID of skill, second - level of skill (1 - basic, 2 - adv., 3 - expert); if hero has ability (-1, -1) it meansthat it should have default secondary abilities
  204. si32 movement; //remaining movement points
  205. si32 identifier; //from the map file
  206. ui8 sex;
  207. ui8 inTownGarrison; // if hero is in town garrison
  208. CGTownInstance * visitedTown; //set if hero is visiting town or in the town garrison
  209. CGBoat *boat; //set to CGBoat when sailing
  210. std::vector<ui32> artifacts; //hero's artifacts from bag
  211. std::map<ui16,ui32> artifWorn; //map<position,artifact_id>; positions: 0 - head; 1 - shoulders; 2 - neck; 3 - right hand; 4 - left hand; 5 - torso; 6 - right ring; 7 - left ring; 8 - feet; 9 - misc1; 10 - misc2; 11 - misc3; 12 - misc4; 13 - mach1; 14 - mach2; 15 - mach3; 16 - mach4; 17 - spellbook; 18 - misc5
  212. std::set<ui32> spells; //known spells (spell IDs)
  213. struct DLL_EXPORT Patrol
  214. {
  215. Patrol(){patrolling=false;patrolRadious=-1;};
  216. ui8 patrolling;
  217. si32 patrolRadious;
  218. template <typename Handler> void serialize(Handler &h, const int version)
  219. {
  220. h & patrolling & patrolRadious;
  221. }
  222. } patrol;
  223. std::list<HeroBonus> bonuses;
  224. //////////////////////////////////////////////////////////////////////////
  225. template <typename Handler> void serialize(Handler &h, const int version)
  226. {
  227. h & static_cast<CArmedInstance&>(*this);
  228. h & exp & level & name & biography & portrait & mana & primSkills & secSkills & movement
  229. & identifier & sex & inTownGarrison & artifacts & artifWorn & spells & patrol & bonuses
  230. & moveDir;
  231. ui8 standardType = (VLC->heroh->heroes[subID] == type);
  232. h & standardType;
  233. if(!standardType)
  234. h & type;
  235. else if(!h.saving)
  236. type = VLC->heroh->heroes[subID];
  237. //visitied town pointer will be restored by map serialization method
  238. }
  239. //////////////////////////////////////////////////////////////////////////
  240. int3 getSightCenter() const; //"center" tile from which the sight distance is calculated
  241. int getSightRadious() const; //sight distance (should be used if player-owned structure)
  242. //////////////////////////////////////////////////////////////////////////
  243. const HeroBonus *getBonus(int from, int id) const;
  244. int valOfBonuses(HeroBonus::BonusType type, int subtype = -1) const; //subtype -> subtype of bonus, if -1 then any
  245. bool hasBonusOfType(HeroBonus::BonusType type, int subtype = -1) const; //determines if hero has a bonus of given type (and optionally subtype)
  246. const std::string &getBiography() const;
  247. bool needsLastStack()const;
  248. unsigned int getTileCost(const TerrainTile &dest, const TerrainTile &from) const; //move cost - applying pathfinding skill, road and terrain modifiers. NOT includes diagonal move penalty, last move levelling
  249. unsigned int getLowestCreatureSpeed() const;
  250. int3 getPosition(bool h3m) const; //h3m=true - returns position of hero object; h3m=false - returns position of hero 'manifestation'
  251. si32 manaLimit() const; //maximum mana value for this hero (basically 10*knowledge)
  252. si32 manaRegain() const; //how many points of mana can hero regain "naturally" in one day
  253. bool canWalkOnSea() const;
  254. int getCurrentLuck(int stack=-1, bool town=false) const;
  255. std::vector<std::pair<int,std::string> > getCurrentLuckModifiers(int stack=-1, bool town=false) const; //args as above
  256. int getCurrentMorale(int stack=-1, bool town=false) const; //if stack - position of creature, if -1 then morale for hero is calculated; town - if bonuses from town (tavern) should be considered
  257. std::vector<std::pair<int,std::string> > getCurrentMoraleModifiers(int stack=-1, bool town=false) const; //args as above
  258. int getPrimSkillLevel(int id) const;
  259. ui8 getSecSkillLevel(const int & ID) const; //0 - no skill
  260. int maxMovePoints(bool onLand) const;
  261. ui32 getArtAtPos(ui16 pos) const; //-1 - no artifact
  262. const CArtifact * getArt(int pos) const;
  263. si32 getArtPos(int aid) const; //looks for equipped artifact with given ID and returns its slot ID or -1 if none(if more than one such artifact lower ID is returned)
  264. void giveArtifact (ui32 aid);
  265. int getSpellSecLevel(int spell) const; //returns level of secondary ability (fire, water, earth, air magic) known to this hero and applicable to given spell; -1 if error
  266. static int3 convertPosition(int3 src, bool toh3m); //toh3m=true: manifest->h3m; toh3m=false: h3m->manifest
  267. double getHeroStrength() const;
  268. int getTotalStrength() const;
  269. ui8 getSpellSchoolLevel(const CSpell * spell) const; //returns level on which given spell would be cast by this hero
  270. bool canCastThisSpell(const CSpell * spell) const; //determines if this hero can cast given spell; takes into account existing spell in spellbook, existing spellbook and artifact bonuses
  271. std::pair<ui32, si32> calculateNecromancy (const BattleResult &battleResult) const;
  272. void showNecromancyDialog (std::pair<ui32, si32> raisedStack) const;
  273. //////////////////////////////////////////////////////////////////////////
  274. void initHero();
  275. void initHero(int SUBID);
  276. void recreateArtBonuses();
  277. void initHeroDefInfo();
  278. CGHeroInstance();
  279. virtual ~CGHeroInstance();
  280. //////////////////////////////////////////////////////////////////////////
  281. void setPropertyDer(ui8 what, ui32 val);//synchr
  282. void initObj();
  283. void onHeroVisit(const CGHeroInstance * h) const;
  284. };
  285. class DLL_EXPORT CGDwelling : public CArmedInstance
  286. {
  287. public:
  288. std::vector<std::pair<ui32, std::vector<ui32> > > creatures; //creatures[level] -> <vector of alternative ids (base creature and upgrades, creatures amount>
  289. template <typename Handler> void serialize(Handler &h, const int version)
  290. {
  291. h & static_cast<CArmedInstance&>(*this) & creatures;
  292. }
  293. void initObj();
  294. void setProperty(ui8 what, ui32 val);
  295. void onHeroVisit(const CGHeroInstance * h) const;
  296. void newTurn() const;
  297. void heroAcceptsCreatures(const CGHeroInstance *h, ui32 answer) const;
  298. void fightOver(const CGHeroInstance *h, BattleResult *result) const;
  299. void wantsFight(const CGHeroInstance *h, ui32 answer) const;
  300. };
  301. class DLL_EXPORT CGVisitableOPH : public CGObjectInstance //objects visitable only once per hero
  302. {
  303. public:
  304. std::set<si32> visitors; //ids of heroes who have visited this obj
  305. si8 ttype; //tree type - used only by trees of knowledge: 0 - give level for free; 1 - take 2000 gold; 2 - take 10 gems
  306. const std::string & getHoverText() const;
  307. void setPropertyDer(ui8 what, ui32 val);//synchr
  308. void onHeroVisit(const CGHeroInstance * h) const;
  309. void onNAHeroVisit(int heroID, bool alreadyVisited) const;
  310. void initObj();
  311. void treeSelected(int heroID, int resType, int resVal, ui64 expVal, ui32 result) const; //handle player's anwer to the Tree of Knowledge dialog
  312. void schoolSelected(int heroID, ui32 which) const;
  313. void arenaSelected(int heroID, int primSkill) const;
  314. template <typename Handler> void serialize(Handler &h, const int version)
  315. {
  316. h & static_cast<CGObjectInstance&>(*this);
  317. h & visitors & ttype;
  318. }
  319. };
  320. class DLL_EXPORT CGTownBuilding : public IObjectInterface
  321. {
  322. ///basic class for town structures handled as map objects
  323. public:
  324. si32 ID; //from buildig list
  325. si32 id; //identifies its index on towns vector
  326. CGTownInstance *town;
  327. template <typename Handler> void serialize(Handler &h, const int version)
  328. {
  329. h & ID & id;
  330. }
  331. };
  332. class DLL_EXPORT COPWBonus : public CGTownBuilding
  333. {///used for OPW bonusing structures
  334. public:
  335. std::set<si32> visitors;
  336. void setProperty(ui8 what, ui32 val);
  337. void onHeroVisit (const CGHeroInstance * h) const;
  338. COPWBonus (int index, CGTownInstance *TOWN);
  339. COPWBonus (){ID = 0; town = NULL;};
  340. template <typename Handler> void serialize(Handler &h, const int version)
  341. {
  342. h & static_cast<CGTownBuilding&>(*this);
  343. h & visitors;
  344. }
  345. };
  346. class DLL_EXPORT CTownBonus : public CGTownBuilding
  347. {
  348. ///used for one-time bonusing structures
  349. ///feel free to merge inheritance tree
  350. public:
  351. std::set<si32> visitors;
  352. void setProperty(ui8 what, ui32 val);
  353. void onHeroVisit (const CGHeroInstance * h) const;
  354. CTownBonus (int index, CGTownInstance *TOWN);
  355. CTownBonus (){ID = 0; town = NULL;};
  356. template <typename Handler> void serialize(Handler &h, const int version)
  357. {
  358. h & static_cast<CGTownBuilding&>(*this);
  359. h & visitors;
  360. }
  361. };
  362. class DLL_EXPORT CGTownInstance : public CGDwelling, public IShipyard
  363. {
  364. public:
  365. CTown * town;
  366. std::string name; // name of town
  367. si32 builded; //how many buildings has been built this turn
  368. si32 destroyed; //how many buildings has been destroyed this turn
  369. const CGHeroInstance * garrisonHero, *visitingHero;
  370. ui32 identifier; //special identifier from h3m (only > RoE maps)
  371. si32 alignment;
  372. std::set<si32> forbiddenBuildings, builtBuildings;
  373. std::vector<CGTownBuilding*> bonusingBuildings;
  374. std::vector<ui32> possibleSpells, obligatorySpells;
  375. std::vector<std::vector<ui32> > spells; //spells[level] -> vector of spells, first will be available in guild
  376. std::set<CCastleEvent> events;
  377. //////////////////////////////////////////////////////////////////////////
  378. template <typename Handler> void serialize(Handler &h, const int version)
  379. {
  380. h & static_cast<CGDwelling&>(*this);
  381. h & name & builded & destroyed & identifier & alignment & forbiddenBuildings & builtBuildings
  382. & possibleSpells & obligatorySpells & spells & /*strInfo & */events & bonusingBuildings;
  383. for (std::vector<CGTownBuilding*>::iterator i = bonusingBuildings.begin(); i!=bonusingBuildings.end(); i++)
  384. (*i)->town = this;
  385. ui8 standardType = (&VLC->townh->towns[subID] == town);
  386. h & standardType;
  387. if(!standardType)
  388. h & town;
  389. else if(!h.saving)
  390. town = &VLC->townh->towns[subID];
  391. //garrison/visiting hero pointers will be restored in the map serialization
  392. }
  393. //////////////////////////////////////////////////////////////////////////
  394. int3 getSightCenter() const; //"center" tile from which the sight distance is calculated
  395. int getSightRadious() const; //returns sight distance
  396. void getOutOffsets(std::vector<int3> &offsets) const; //offsets to obj pos when we boat can be placed
  397. void setPropertyDer(ui8 what, ui32 val);
  398. void newTurn() const;
  399. //////////////////////////////////////////////////////////////////////////
  400. bool needsLastStack() const;
  401. int fortLevel() const; //0 - none, 1 - fort, 2 - citadel, 3 - castle
  402. int hallLevel() const; // -1 - none, 0 - village, 1 - town, 2 - city, 3 - capitol
  403. int mageGuildLevel() const; // -1 - none, 0 - village, 1 - town, 2 - city, 3 - capitol
  404. bool creatureDwelling(const int & level, bool upgraded=false) const;
  405. int getHordeLevel(const int & HID) const; //HID - 0 or 1; returns creature level or -1 if that horde structure is not present
  406. int creatureGrowth(const int & level) const;
  407. bool hasFort() const;
  408. bool hasCapitol() const;
  409. int dailyIncome() const; //calculates daily income of this town
  410. int spellsAtLevel(int level, bool checkGuild) const; //levels are counted from 1 (1 - 5)
  411. void removeCapitols (ui8 owner, bool me) const;
  412. CGTownInstance();
  413. virtual ~CGTownInstance();
  414. //////////////////////////////////////////////////////////////////////////
  415. void fightOver(const CGHeroInstance *h, BattleResult *result) const;
  416. void onHeroVisit(const CGHeroInstance * h) const;
  417. void onHeroLeave(const CGHeroInstance * h) const;
  418. void initObj();
  419. };
  420. class DLL_EXPORT CGPandoraBox : public CArmedInstance
  421. {
  422. public:
  423. std::string message;
  424. ui8 removeAfterVisit; //true if event is removed after occurring
  425. //gained things:
  426. ui32 gainedExp;
  427. si32 manaDiff; //amount of gained / lost mana
  428. si32 moraleDiff; //morale modifier
  429. si32 luckDiff; //luck modifier
  430. std::vector<si32> resources;//gained / lost resources
  431. std::vector<si32> primskills;//gained / lost resources
  432. std::vector<si32> abilities; //gained abilities
  433. std::vector<si32> abilityLevels; //levels of gained abilities
  434. std::vector<si32> artifacts; //gained artifacts
  435. std::vector<si32> spells; //gained spells
  436. CCreatureSet creatures; //gained creatures
  437. void initObj();
  438. void onHeroVisit(const CGHeroInstance * h) const;
  439. void open (const CGHeroInstance * h, ui32 accept) const;
  440. void endBattle(const CGHeroInstance *h, BattleResult *result) const;
  441. void giveContents(const CGHeroInstance *h, bool afterBattle) const;
  442. void getText( InfoWindow &iw, bool &afterBattle, int val, int negative, int positive, const CGHeroInstance * h ) const;
  443. void getText( InfoWindow &iw, bool &afterBattle, int text, const CGHeroInstance * h ) const;
  444. template <typename Handler> void serialize(Handler &h, const int version)
  445. {
  446. h & static_cast<CArmedInstance&>(*this);
  447. h & message & gainedExp & manaDiff & moraleDiff & luckDiff & resources & primskills
  448. & abilities & abilityLevels & artifacts & spells & creatures & army;
  449. }
  450. };
  451. class DLL_EXPORT CGEvent : public CGPandoraBox //event objects
  452. {
  453. public:
  454. ui8 availableFor; //players whom this event is available for
  455. ui8 computerActivate; //true if computre player can activate this event
  456. ui8 humanActivate; //true if human player can activate this event
  457. template <typename Handler> void serialize(Handler &h, const int version)
  458. {
  459. h & static_cast<CArmedInstance&>(*this);
  460. h & message & gainedExp & manaDiff & moraleDiff & luckDiff & resources & primskills
  461. & abilities & abilityLevels & artifacts & spells & creatures & availableFor
  462. & computerActivate & humanActivate & army;
  463. }
  464. void onHeroVisit(const CGHeroInstance * h) const;
  465. void activated(const CGHeroInstance * h) const;
  466. };
  467. class DLL_EXPORT CGCreature : public CArmedInstance //creatures on map
  468. {
  469. public:
  470. ui32 identifier; //unique code for this monster (used in missions)
  471. si8 character; //chracter of this set of creatures (0 - the most friendly, 4 - the most hostile) => on init changed to 0 (compliant) - 10 value (savage)
  472. std::string message; //message printed for attacking hero
  473. std::vector<ui32> resources; //[res_id], resources given to hero that has won with monsters
  474. si32 gainedArtifact; //ID of artifact gained to hero, -1 if none
  475. ui8 neverFlees; //if true, the troops will never flee
  476. ui8 notGrowingTeam; //if true, number of units won't grow
  477. void fight(const CGHeroInstance *h) const;
  478. void onHeroVisit(const CGHeroInstance * h) const;
  479. //const std::string & getHoverText() const;
  480. void flee( const CGHeroInstance * h ) const;
  481. void endBattle(BattleResult *result) const;
  482. void fleeDecision(const CGHeroInstance *h, ui32 pursue) const;
  483. void joinDecision(const CGHeroInstance *h, int cost, ui32 accept) const;
  484. void initObj();
  485. int takenAction(const CGHeroInstance *h, bool allowJoin=true) const; //action on confrontation: -2 - fight, -1 - flee, >=0 - will join for given value of gold (may be 0)
  486. template <typename Handler> void serialize(Handler &h, const int version)
  487. {
  488. h & static_cast<CArmedInstance&>(*this);
  489. h & identifier & character & message & resources & gainedArtifact & neverFlees & notGrowingTeam;
  490. }
  491. };
  492. class DLL_EXPORT CGSignBottle : public CGObjectInstance //signs and ocean bottles
  493. {
  494. public:
  495. std::string message;
  496. void onHeroVisit(const CGHeroInstance * h) const;
  497. void initObj();
  498. template <typename Handler> void serialize(Handler &h, const int version)
  499. {
  500. h & static_cast<CGObjectInstance&>(*this);
  501. h & message;
  502. }
  503. };
  504. class DLL_EXPORT CGSeerHut : public CGObjectInstance, public CQuest
  505. {
  506. public:
  507. ui8 rewardType; //type of reward: 0 - no reward; 1 - experience; 2 - mana points; 3 - morale bonus; 4 - luck bonus; 5 - resources; 6 - main ability bonus (attak, defence etd.); 7 - secondary ability gain; 8 - artifact; 9 - spell; 10 - creature
  508. si32 rID; //reward ID
  509. si32 rVal; //reward value
  510. ui8 textOption; //store randomized mission write-ups rather than entire string (?)
  511. std::string seerName;
  512. void initObj();
  513. const std::string & getHoverText() const;
  514. void onHeroVisit (const CGHeroInstance * h) const;
  515. void finishQuest (const CGHeroInstance * h) const {};
  516. template <typename Handler> void serialize(Handler &h, const int version)
  517. {
  518. h & static_cast<CGObjectInstance&>(*this) & static_cast<CQuest&>(*this);
  519. h & rewardType & rID & rVal & textOption & seerName;
  520. }
  521. };
  522. class DLL_EXPORT CGWitchHut : public CPlayersVisited
  523. {
  524. public:
  525. std::vector<si32> allowedAbilities;
  526. ui32 ability;
  527. const std::string & getHoverText() const;
  528. void onHeroVisit(const CGHeroInstance * h) const;
  529. void initObj();
  530. template <typename Handler> void serialize(Handler &h, const int version)
  531. {
  532. h & static_cast<CPlayersVisited&>(*this);
  533. h & allowedAbilities & ability;
  534. }
  535. };
  536. class DLL_EXPORT CGScholar : public CGObjectInstance
  537. {
  538. public:
  539. ui8 bonusType; //255 - random, 0 - primary skill, 1 - secondary skill, 2 - spell
  540. ui16 bonusID; //ID of skill/spell
  541. void giveAnyBonus(const CGHeroInstance * h) const;
  542. void onHeroVisit(const CGHeroInstance * h) const;
  543. void initObj();
  544. template <typename Handler> void serialize(Handler &h, const int version)
  545. {
  546. h & static_cast<CGObjectInstance&>(*this);
  547. h & bonusType & bonusID;
  548. }
  549. };
  550. class DLL_EXPORT CGGarrison : public CArmedInstance
  551. {
  552. public:
  553. ui8 removableUnits;
  554. ui8 getPassableness() const;
  555. void onHeroVisit (const CGHeroInstance *h) const;
  556. void fightOver (const CGHeroInstance *h, BattleResult *result) const;
  557. template <typename Handler> void serialize(Handler &h, const int version)
  558. {
  559. h & static_cast<CArmedInstance&>(*this);
  560. h & removableUnits;
  561. }
  562. };
  563. class DLL_EXPORT CGArtifact : public CArmedInstance
  564. {
  565. public:
  566. std::string message;
  567. ui32 spell; //if it's spell scroll
  568. void onHeroVisit(const CGHeroInstance * h) const;
  569. void fightForArt(ui32 agreed, const CGHeroInstance *h) const;
  570. void endBattle(BattleResult *result, const CGHeroInstance *h) const;
  571. void pick( const CGHeroInstance * h ) const;
  572. void initObj();
  573. template <typename Handler> void serialize(Handler &h, const int version)
  574. {
  575. h & static_cast<CArmedInstance&>(*this);
  576. h & message & spell;
  577. }
  578. };
  579. class DLL_EXPORT CGResource : public CArmedInstance
  580. {
  581. public:
  582. ui32 amount; //0 if random
  583. std::string message;
  584. void onHeroVisit(const CGHeroInstance * h) const;
  585. void collectRes(int player) const;
  586. void initObj();
  587. void fightForRes(ui32 agreed, const CGHeroInstance *h) const;
  588. void endBattle(BattleResult *result, const CGHeroInstance *h) const;
  589. template <typename Handler> void serialize(Handler &h, const int version)
  590. {
  591. h & static_cast<CArmedInstance&>(*this);
  592. h & amount & message;
  593. }
  594. };
  595. class DLL_EXPORT CGPickable : public CGObjectInstance //campfire, treasure chest, Flotsam, Shipwreck Survivor, Sea Chest
  596. {
  597. public:
  598. ui32 type, val1, val2;
  599. void onHeroVisit(const CGHeroInstance * h) const;
  600. void initObj();
  601. void chosen(int which, int heroID) const;
  602. template <typename Handler> void serialize(Handler &h, const int version)
  603. {
  604. h & static_cast<CGObjectInstance&>(*this);
  605. h & type & val1 & val2;
  606. }
  607. };
  608. class DLL_EXPORT CGShrine : public CPlayersVisited
  609. {
  610. public:
  611. ui8 spell; //number of spell or 255 if random
  612. void onHeroVisit(const CGHeroInstance * h) const;
  613. void initObj();
  614. const std::string & getHoverText() const;
  615. template <typename Handler> void serialize(Handler &h, const int version)
  616. {
  617. h & static_cast<CPlayersVisited&>(*this);;
  618. h & spell;
  619. }
  620. };
  621. class DLL_EXPORT CGQuestGuard : public CGObjectInstance, public CQuest
  622. {
  623. public:
  624. template <typename Handler> void serialize(Handler &h, const int version)
  625. {
  626. h & static_cast<CQuest&>(*this) & static_cast<CGObjectInstance&>(*this);
  627. }
  628. };
  629. class DLL_EXPORT CGMine : public CArmedInstance
  630. {
  631. public:
  632. void offerLeavingGuards(const CGHeroInstance *h) const;
  633. void onHeroVisit(const CGHeroInstance * h) const;
  634. void newTurn() const;
  635. void initObj();
  636. template <typename Handler> void serialize(Handler &h, const int version)
  637. {
  638. h & static_cast<CArmedInstance&>(*this);
  639. }
  640. };
  641. class DLL_EXPORT CGVisitableOPW : public CGObjectInstance //objects visitable OPW
  642. {
  643. public:
  644. ui8 visited; //true if object has been visited this week
  645. void setPropertyDer(ui8 what, ui32 val);//synchr
  646. void onHeroVisit(const CGHeroInstance * h) const;
  647. void newTurn() const;
  648. template <typename Handler> void serialize(Handler &h, const int version)
  649. {
  650. h & static_cast<CGObjectInstance&>(*this);
  651. h & visited;
  652. }
  653. };
  654. class DLL_EXPORT CGTeleport : public CGObjectInstance //teleports and subterranean gates
  655. {
  656. public:
  657. static std::map<int,std::map<int, std::vector<int> > > objs; //teleports: map[ID][subID] => vector of ids
  658. static std::vector<std::pair<int, int> > gates; //subterranean gates: pairs of ids
  659. void onHeroVisit(const CGHeroInstance * h) const;
  660. void initObj();
  661. static void postInit();
  662. template <typename Handler> void serialize(Handler &h, const int version)
  663. {
  664. h & static_cast<CGObjectInstance&>(*this);
  665. }
  666. };
  667. class DLL_EXPORT CGBonusingObject : public CGObjectInstance //objects giving bonuses to luck/morale/movement
  668. {
  669. public:
  670. void onHeroVisit(const CGHeroInstance * h) const;
  671. const std::string & getHoverText() const;
  672. void initObj();
  673. template <typename Handler> void serialize(Handler &h, const int version)
  674. {
  675. h & static_cast<CGObjectInstance&>(*this);
  676. }
  677. };
  678. class DLL_EXPORT CGMagicSpring : public CGVisitableOPW
  679. {///unfortunatelly, this one is quite different than others
  680. public:
  681. void onHeroVisit(const CGHeroInstance * h) const;
  682. const std::string & getHoverText() const;
  683. template <typename Handler> void serialize(Handler &h, const int version)
  684. {
  685. h & static_cast<CGObjectInstance&>(*this);
  686. h & visited;
  687. }
  688. };
  689. class DLL_EXPORT CGMagicWell : public CGObjectInstance //objects giving bonuses to luck/morale/movement
  690. {
  691. public:
  692. void onHeroVisit(const CGHeroInstance * h) const;
  693. const std::string & getHoverText() const;
  694. template <typename Handler> void serialize(Handler &h, const int version)
  695. {
  696. h & static_cast<CGObjectInstance&>(*this);
  697. }
  698. };
  699. class DLL_EXPORT CGSirens : public CGObjectInstance
  700. {
  701. public:
  702. void onHeroVisit(const CGHeroInstance * h) const;
  703. const std::string & getHoverText() const;
  704. void initObj();
  705. template <typename Handler> void serialize(Handler &h, const int version)
  706. {
  707. h & static_cast<CGObjectInstance&>(*this);
  708. }
  709. };
  710. class DLL_EXPORT CGObservatory : public CGObjectInstance //Redwood observatory
  711. {
  712. public:
  713. void onHeroVisit(const CGHeroInstance * h) const;
  714. template <typename Handler> void serialize(Handler &h, const int version)
  715. {
  716. h & static_cast<CGObjectInstance&>(*this);
  717. }
  718. };
  719. class DLL_EXPORT CGKeys : public CGObjectInstance //Base class for Keymaster and guards
  720. {
  721. public:
  722. static std::map <ui8, std::set <ui8> > playerKeyMap; //[players][keysowned]
  723. //SubID 0 - lightblue, 1 - green, 2 - red, 3 - darkblue, 4 - brown, 5 - purple, 6 - white, 7 - black
  724. void setPropertyDer (ui8 what, ui32 val);
  725. bool wasMyColorVisited (int player) const;
  726. template <typename Handler> void serialize(Handler &h, const int version)
  727. {
  728. h & static_cast<CGObjectInstance&>(*this);
  729. }
  730. };
  731. class DLL_EXPORT CGKeymasterTent : public CGKeys
  732. {
  733. public:
  734. void onHeroVisit(const CGHeroInstance * h) const;
  735. const std::string & getHoverText() const;
  736. template <typename Handler> void serialize(Handler &h, const int version)
  737. {
  738. h & static_cast<CGObjectInstance&>(*this);
  739. }
  740. };
  741. class DLL_EXPORT CGBorderGuard : public CGKeys
  742. {
  743. public:
  744. void initObj();
  745. const std::string & getHoverText() const;
  746. void onHeroVisit(const CGHeroInstance * h) const;
  747. void openGate(const CGHeroInstance *h, ui32 accept) const;
  748. template <typename Handler> void serialize(Handler &h, const int version)
  749. {
  750. h & static_cast<CGObjectInstance&>(*this);
  751. h & blockVisit;
  752. }
  753. };
  754. class DLL_EXPORT CGBorderGate : public CGBorderGuard //not fully imlemented, waiting for garrison
  755. {
  756. public:
  757. void onHeroVisit(const CGHeroInstance * h) const;
  758. ui8 getPassableness() const;
  759. };
  760. class DLL_EXPORT CGBoat : public CGObjectInstance
  761. {
  762. public:
  763. ui8 direction;
  764. const CGHeroInstance *hero; //hero on board
  765. void initObj();
  766. CGBoat()
  767. {
  768. hero = NULL;
  769. direction = 4;
  770. }
  771. template <typename Handler> void serialize(Handler &h, const int version)
  772. {
  773. h & static_cast<CGObjectInstance&>(*this) & direction;
  774. }
  775. };
  776. class DLL_EXPORT CGOnceVisitable : public CPlayersVisited
  777. ///wagon, corpse, lean to, warriors tomb
  778. {
  779. public:
  780. ui8 artOrRes; //0 - nothing; 1 - artifact; 2 - resource
  781. ui32 bonusType, //id of res or artifact
  782. bonusVal; //resource amount (or not used)
  783. void onHeroVisit(const CGHeroInstance * h) const;
  784. const std::string & getHoverText() const;
  785. void initObj();
  786. void searchTomb(const CGHeroInstance *h, ui32 accept) const;
  787. template <typename Handler> void serialize(Handler &h, const int version)
  788. {
  789. h & static_cast<CPlayersVisited&>(*this);;
  790. h & artOrRes & bonusType & bonusVal;
  791. }
  792. };
  793. class DLL_EXPORT CBank : public CArmedInstance
  794. {
  795. public:
  796. int index; //banks have unusal numbering - see ZCRBANK.txt and initObj()
  797. BankConfig *bc;
  798. float multiplier; //for improved banks script
  799. std::vector<ui32> artifacts; //fixed and deterministic
  800. ui32 daycounter;
  801. void initObj();
  802. const std::string & getHoverText() const;
  803. void setPropertyDer (ui8 what, ui32 val);
  804. void initialize() const;
  805. void reset(ui16 var1);
  806. void newTurn() const;
  807. virtual void onHeroVisit (const CGHeroInstance * h) const;
  808. virtual void fightGuards (const CGHeroInstance *h, ui32 accept) const;
  809. virtual void endBattle (const CGHeroInstance *h, const BattleResult *result) const;
  810. template <typename Handler> void serialize(Handler &h, const int version)
  811. {
  812. h & static_cast<CGObjectInstance&>(*this);
  813. h & index & multiplier & artifacts & daycounter & bc;
  814. }
  815. };
  816. class DLL_EXPORT CGPyramid : public CBank
  817. {
  818. public:
  819. static BankConfig pyramidConfig;
  820. ui16 spell;
  821. void initObj();
  822. const std::string & getHoverText() const;
  823. void newTurn() const {}; //empty, no reset
  824. void onHeroVisit (const CGHeroInstance * h) const;
  825. void endBattle (const CGHeroInstance *h, const BattleResult *result) const;
  826. template <typename Handler> void serialize(Handler &h, const int version)
  827. {
  828. h & static_cast<CBank&>(*this);
  829. h & spell;
  830. }
  831. };
  832. class CGShipyard : public CGObjectInstance, public IShipyard
  833. {
  834. public:
  835. void getOutOffsets(std::vector<int3> &offsets) const; //offsets to obj pos when we boat can be placed
  836. CGShipyard();
  837. void onHeroVisit(const CGHeroInstance * h) const;
  838. };
  839. class DLL_EXPORT CGMagi : public CGObjectInstance
  840. {
  841. public:
  842. static std::map <si32, std::vector<si32> > eyelist; //[subID][id], supports multiple sets as in H5
  843. void initObj();
  844. void onHeroVisit(const CGHeroInstance * h) const;
  845. template <typename Handler> void serialize(Handler &h, const int version)
  846. {
  847. h & static_cast<CGObjectInstance&>(*this);
  848. }
  849. };
  850. class DLL_EXPORT CCartographer : public CPlayersVisited
  851. {
  852. ///behaviour varies depending on surface and floor
  853. public:
  854. void onHeroVisit( const CGHeroInstance * h ) const;
  855. void buyMap (const CGHeroInstance *h, ui32 accept) const;
  856. template <typename Handler> void serialize(Handler &h, const int version)
  857. {
  858. h & static_cast<CPlayersVisited&>(*this);
  859. h & players;
  860. }
  861. };
  862. class DLL_EXPORT CShop : public CGObjectInstance
  863. {
  864. ///base class for university, art merchant, slave market etc.
  865. public:
  866. std::map<ui16, Component*> available;
  867. std::map<ui16, Component*> chosen, bought; //redundant?
  868. //keys are unique for all three maps
  869. std::map<ui16, ui32> price;
  870. void initObj() {};
  871. void setPropertyDer (ui8 what, ui32 val);
  872. void newTurn() const;
  873. virtual void reset (ui32 val) {}; //get new items for Black Market, Tavern, Refugee Camp
  874. virtual void onHeroVisit (const CGHeroInstance * h) const {};
  875. virtual void trade (const CGHeroInstance * h) const {};
  876. template <typename Handler> void serialize(Handler &h, const int version)
  877. {
  878. h & available & chosen & bought & price;
  879. }
  880. };
  881. class DLL_EXPORT CGArtMerchant : public CShop
  882. {
  883. public:
  884. void reset (ui32 val);
  885. void onHeroVisit (const CGHeroInstance * h) const {};
  886. };
  887. class DLL_EXPORT CGRefugeeCamp : public CShop
  888. {
  889. public:
  890. void reset (ui32 val);
  891. void onHeroVisit (const CGHeroInstance * h) const {};
  892. };
  893. struct BankConfig
  894. {
  895. BankConfig() {level = chance = upgradeChance = combatValue = value = rewardDifficulty = easiest = 0; };
  896. ui8 level; //1 - 4, how hard the battle will be
  897. ui8 chance; //chance for this level being chosen
  898. ui8 upgradeChance; //chance for creatures to be in upgraded versions
  899. std::vector< std::pair <ui16, ui32> > guards; //creature ID, amount
  900. ui32 combatValue; //how hard are guards of this level
  901. std::vector<si32> resources; //resources given in case of victory
  902. std::vector< std::pair <ui16, ui32> > creatures; //creatures granted in case of victory (creature ID, amount)
  903. std::vector<ui16> artifacts; //number of artifacts given in case of victory [0] -> treasure, [1] -> minor [2] -> major [3] -> relic
  904. ui32 value; //overall value of given things
  905. ui32 rewardDifficulty; //proportion of reward value to difficulty of guards; how profitable is this creature Bank config
  906. ui16 easiest; //?!?
  907. template <typename Handler> void serialize(Handler &h, const int version)
  908. {
  909. h & level & chance & upgradeChance & guards & combatValue & resources & creatures & artifacts & value & rewardDifficulty & easiest;
  910. }
  911. };
  912. class DLL_EXPORT CObjectHandler
  913. {
  914. public:
  915. std::vector<si32> cregens; //type 17. dwelling subid -> creature ID
  916. std::map <ui32, std::vector <BankConfig*> > banksInfo; //[index][preset]
  917. std::map <ui32, std::string> creBanksNames; //[crebank index] -> name of this creature bank
  918. void loadObjects();
  919. template <typename Handler> void serialize(Handler &h, const int version)
  920. {
  921. h & cregens & banksInfo & creBanksNames;
  922. }
  923. };
  924. #endif // __COBJECTHANDLER_H__