CObjectHandler.h 39 KB

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