HeroBonus.h 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644
  1. #pragma once
  2. #include "../global.h"
  3. #include <string>
  4. #include <list>
  5. #include <set>
  6. #include <boost/function.hpp>
  7. #include <boost/smart_ptr/shared_ptr.hpp>
  8. /*
  9. * HeroBonus.h, part of VCMI engine
  10. *
  11. * Authors: listed in file AUTHORS in main folder
  12. *
  13. * License: GNU General Public License v2.0 or later
  14. * Full text of license available in license.txt file, in main folder
  15. *
  16. */
  17. typedef ui8 TBonusType;
  18. typedef si32 TBonusSubtype;
  19. class CCreature;
  20. class CSpell;
  21. struct Bonus;
  22. class CBonusSystemNode;
  23. class ILimiter;
  24. class IPropagator;
  25. typedef std::vector<std::pair<int,std::string> > TModDescr; //modifiers values and their descriptions
  26. typedef std::set<CBonusSystemNode*> TNodes;
  27. typedef std::set<const CBonusSystemNode*> TCNodes;
  28. typedef std::vector<CBonusSystemNode *> TNodesVector;
  29. typedef boost::function<bool(const Bonus*)> CSelector;
  30. namespace PrimarySkill
  31. {
  32. enum { ATTACK, DEFENSE, SPELL_POWER, KNOWLEDGE};
  33. }
  34. #define BONUS_LIST \
  35. BONUS_NAME(NONE) \
  36. BONUS_NAME(MOVEMENT) /*both water/land*/ \
  37. BONUS_NAME(LAND_MOVEMENT) \
  38. BONUS_NAME(SEA_MOVEMENT) \
  39. BONUS_NAME(MORALE) \
  40. BONUS_NAME(LUCK) \
  41. BONUS_NAME(PRIMARY_SKILL) /*uses subtype to pick skill; additional info if set: 1 - only melee, 2 - only distance*/ \
  42. BONUS_NAME(SIGHT_RADIOUS) \
  43. BONUS_NAME(MANA_REGENERATION) /*points per turn apart from normal (1 + mysticism)*/ \
  44. BONUS_NAME(FULL_MANA_REGENERATION) /*all mana points are replenished every day*/ \
  45. BONUS_NAME(NONEVIL_ALIGNMENT_MIX) /*good and neutral creatures can be mixed without morale penalty*/ \
  46. BONUS_NAME(SECONDARY_SKILL_PREMY) /*%*/ \
  47. BONUS_NAME(SURRENDER_DISCOUNT) /*%*/ \
  48. BONUS_NAME(STACKS_SPEED) /*additional info - percent of speed bonus applied after direct bonuses; >0 - added, <0 - substracted to this part*/ \
  49. BONUS_NAME(FLYING_MOVEMENT) /*subtype 1 - without penalty, 2 - with penalty*/ \
  50. BONUS_NAME(SPELL_DURATION) \
  51. BONUS_NAME(AIR_SPELL_DMG_PREMY) \
  52. BONUS_NAME(EARTH_SPELL_DMG_PREMY) \
  53. BONUS_NAME(FIRE_SPELL_DMG_PREMY) \
  54. BONUS_NAME(WATER_SPELL_DMG_PREMY) \
  55. BONUS_NAME(BLOCK_SPELLS_ABOVE_LEVEL) \
  56. BONUS_NAME(WATER_WALKING) /*subtype 1 - without penalty, 2 - with penalty*/ \
  57. BONUS_NAME(NO_SHOTING_PENALTY) \
  58. BONUS_NAME(DISPEL_IMMUNITY) \
  59. BONUS_NAME(NEGATE_ALL_NATURAL_IMMUNITIES) \
  60. BONUS_NAME(STACK_HEALTH) \
  61. BONUS_NAME(BLOCK_MORALE) \
  62. BONUS_NAME(BLOCK_LUCK) \
  63. BONUS_NAME(FIRE_SPELLS) \
  64. BONUS_NAME(AIR_SPELLS) \
  65. BONUS_NAME(WATER_SPELLS) \
  66. BONUS_NAME(EARTH_SPELLS) \
  67. BONUS_NAME(GENERATE_RESOURCE) /*daily value, uses subtype (resource type)*/ \
  68. BONUS_NAME(CREATURE_GROWTH) /*for legion artifacts: value - week growth bonus, subtype - monster level if aplicable*/ \
  69. BONUS_NAME(WHIRLPOOL_PROTECTION) /*hero won't lose army when teleporting through whirlpool*/ \
  70. BONUS_NAME(SPELL) /*hero knows spell, val - skill level (0 - 3), subtype - spell id*/ \
  71. BONUS_NAME(SPELLS_OF_LEVEL) /*hero knows all spells of given level, val - skill level; subtype - level*/ \
  72. BONUS_NAME(ENEMY_CANT_ESCAPE) /*for shackles of war*/ \
  73. BONUS_NAME(MAGIC_SCHOOL_SKILL) /* //eg. for magic plains terrain, subtype: school of magic (0 - all, 1 - fire, 2 - air, 4 - water, 8 - earth), value - level*/ \
  74. BONUS_NAME(FREE_SHOOTING) /*stacks can shoot even if otherwise blocked (sharpshooter's bow effect)*/ \
  75. BONUS_NAME(OPENING_BATTLE_SPELL) /*casts a spell at expert level at beginning of battle, val - spell power, subtype - spell id*/ \
  76. BONUS_NAME(IMPROVED_NECROMANCY) /*allows Necropolis units other than skeletons to be raised by necromancy*/ \
  77. BONUS_NAME(CREATURE_GROWTH_PERCENT) /*increases growth of all units in all towns, val - percentage*/ \
  78. BONUS_NAME(FREE_SHIP_BOARDING) /*movement points preserved with ship boarding and landing*/ \
  79. BONUS_NAME(NO_TYPE) \
  80. BONUS_NAME(FLYING) \
  81. BONUS_NAME(SHOOTER) \
  82. BONUS_NAME(CHARGE_IMMUNITY) \
  83. BONUS_NAME(ADDITIONAL_ATTACK) \
  84. BONUS_NAME(UNLIMITED_RETALIATIONS) \
  85. BONUS_NAME(NO_MELEE_PENALTY) \
  86. BONUS_NAME(JOUSTING) /*for champions*/ \
  87. BONUS_NAME(HATE) /*eg. angels hate devils, subtype - ID of hated creature*/ \
  88. BONUS_NAME(KING1) \
  89. BONUS_NAME(KING2) \
  90. BONUS_NAME(KING3) \
  91. BONUS_NAME(MAGIC_RESISTANCE) /*in % (value)*/ \
  92. BONUS_NAME(CHANGES_SPELL_COST_FOR_ALLY) /*in mana points (value) , eg. mage*/ \
  93. BONUS_NAME(CHANGES_SPELL_COST_FOR_ENEMY) /*in mana points (value) , eg. pegasus */ \
  94. BONUS_NAME(SPELL_AFTER_ATTACK) /* subtype - spell id, value - spell level, (additional info)%1000 - chance in %; eg. dendroids, (additional info)/1000 -> [0 - all attacks, 1 - shot only, 2 - melee only*/ \
  95. BONUS_NAME(SPELL_RESISTANCE_AURA) /*eg. unicorns, value - resistance bonus in % for adjacent creatures*/ \
  96. BONUS_NAME(LEVEL_SPELL_IMMUNITY) /*creature is immune to all spell with level below or equal to value of this bonus*/ \
  97. BONUS_NAME(TWO_HEX_ATTACK_BREATH) /*eg. dragons*/ \
  98. BONUS_NAME(SPELL_DAMAGE_REDUCTION) /*eg. golems; value - reduction in %, subtype - spell school; -1 - all, 0 - air, 1 - fire, 2 - water, 3 - earth*/ \
  99. BONUS_NAME(NO_WALL_PENALTY) \
  100. BONUS_NAME(NON_LIVING) /*eg. gargoyle*/ \
  101. BONUS_NAME(RANDOM_GENIE_SPELLCASTER) /*eg. master genie*/ \
  102. BONUS_NAME(BLOCKS_RETALIATION) /*eg. naga*/ \
  103. BONUS_NAME(SPELL_IMMUNITY) /*subid - spell id*/ \
  104. BONUS_NAME(MANA_CHANNELING) /*value in %, eg. familiar*/ \
  105. BONUS_NAME(SPELL_LIKE_ATTACK) /*value - spell id; range is taken from spell, but damage from creature; eg. magog*/ \
  106. BONUS_NAME(THREE_HEADED_ATTACK) /*eg. cerberus*/ \
  107. BONUS_NAME(DAEMON_SUMMONING) /*pit lord*/ \
  108. BONUS_NAME(FIRE_IMMUNITY) \
  109. BONUS_NAME(FIRE_SHIELD) \
  110. BONUS_NAME(UNDEAD) \
  111. BONUS_NAME(HP_REGENERATION) /*creature regenerates val HP every new round*/ \
  112. BONUS_NAME(FULL_HP_REGENERATION) /*first creature regenerates all HP every new round; subtype 0 - animation 4 (trolllike), 1 - animation 47 (wightlike)*/ \
  113. BONUS_NAME(MANA_DRAIN) /*value - spell points per turn*/ \
  114. BONUS_NAME(LIFE_DRAIN) \
  115. BONUS_NAME(DOUBLE_DAMAGE_CHANCE) /*value in %, eg. dread knight*/ \
  116. BONUS_NAME(RETURN_AFTER_STRIKE) \
  117. BONUS_NAME(SELF_MORALE) /*eg. minotaur*/ \
  118. BONUS_NAME(SPELLCASTER) /*subtype - spell id, value - level of school, additional info - spell power*/ \
  119. BONUS_NAME(CATAPULT) \
  120. BONUS_NAME(ENEMY_DEFENCE_REDUCTION) /*in % (value) eg. behemots*/ \
  121. BONUS_NAME(GENERAL_DAMAGE_REDUCTION) /* shield / air shield effect */ \
  122. BONUS_NAME(GENERAL_ATTACK_REDUCTION) /*eg. while stoned or blinded - in %, subtype: -1 - any damage, 0 - melee damage, 1 - ranged damage*/ \
  123. BONUS_NAME(ATTACKS_ALL_ADJACENT) /*eg. hydra*/ \
  124. BONUS_NAME(MORE_DAMAGE_FROM_SPELL) /*value - damage increase in %, subtype - spell id*/ \
  125. BONUS_NAME(CASTS_SPELL_WHEN_KILLED) /*similar to spell after attack*/ \
  126. BONUS_NAME(FEAR) \
  127. BONUS_NAME(FEARLESS) \
  128. BONUS_NAME(NO_DISTANCE_PENALTY) \
  129. BONUS_NAME(NO_OBSTACLES_PENALTY) \
  130. BONUS_NAME(SELF_LUCK) /*halfling*/ \
  131. BONUS_NAME(ENCHANTER) \
  132. BONUS_NAME(HEALER) \
  133. BONUS_NAME(SIEGE_WEAPON) \
  134. BONUS_NAME(HYPNOTIZED) \
  135. BONUS_NAME(ADDITIONAL_RETALIATION) /*value - number of additional retaliations*/ \
  136. BONUS_NAME(MAGIC_MIRROR) /* value - chance of redirecting in %*/ \
  137. BONUS_NAME(ALWAYS_MINIMUM_DAMAGE) /*unit does its minimum damage from range; subtype: -1 - any attack, 0 - melee, 1 - ranged, value: additional damage, additional info - multiplicative anti-bonus for dmg in % [eg 20 means that creature will inflict 80% of normal dmg]*/ \
  138. BONUS_NAME(ALWAYS_MAXIMUM_DAMAGE) /*eg. bless effect, subtype: -1 - any attack, 0 - melee, 1 - ranged, value: additional damage, additional info - multiplicative bonus for dmg in %*/ \
  139. BONUS_NAME(ATTACKS_NEAREST_CREATURE) /*while in berserk*/ \
  140. BONUS_NAME(IN_FRENZY) /*value - level*/ \
  141. BONUS_NAME(SLAYER) /*value - level*/ \
  142. BONUS_NAME(FORGETFULL) /*forgetfulness spell effect, value - level*/ \
  143. BONUS_NAME(NOT_ACTIVE) \
  144. BONUS_NAME(NO_LUCK) /*eg. when fighting on cursed ground*/ \
  145. BONUS_NAME(NO_MORALE) /*eg. when fighting on cursed ground*/ \
  146. BONUS_NAME(DARKNESS) /*val = radius */ \
  147. BONUS_NAME(SPECIAL_SECONDARY_SKILL) /*val = id, additionalInfo = value per level in percent*/ \
  148. BONUS_NAME(SPECIAL_SPELL_LEV) /*val = id, additionalInfo = value per level in percent*/\
  149. BONUS_NAME(SPELL_DAMAGE) /*val = value*/\
  150. BONUS_NAME(SPECIFIC_SPELL_DAMAGE) /*subtype = id of spell, val = value*/\
  151. BONUS_NAME(SPECIAL_BLESS_DAMAGE) /*val = spell (bless), additionalInfo = value per level in percent*/\
  152. BONUS_NAME(MAXED_SPELL) /*val = id*/\
  153. BONUS_NAME(SPECIAL_PECULIAR_ENCHANT) /*blesses and curses with id = val dependent on unit's level, subtype = 0 or 1 for Coronius*/\
  154. BONUS_NAME(SPECIAL_UPGRADE) /*val = base, additionalInfo = target */\
  155. BONUS_NAME(DRAGON_NATURE) /*TODO: implement it!*/\
  156. BONUS_NAME(CREATURE_DAMAGE)/*subtype 0 = both, 1 = min, 2 = max*/
  157. struct DLL_EXPORT Bonus
  158. {
  159. enum BonusType
  160. {
  161. #define BONUS_NAME(x) x,
  162. BONUS_LIST
  163. #undef BONUS_NAME
  164. };
  165. enum BonusDuration //when bonus is automatically removed
  166. {
  167. PERMANENT = 1,
  168. ONE_BATTLE = 2, //at the end of battle
  169. ONE_DAY = 4, //at the end of day
  170. ONE_WEEK = 8, //at the end of week (bonus lasts till the end of week, thats NOT 7 days
  171. N_TURNS = 16, //used during battles, after battle bonus is always removed
  172. N_DAYS = 32,
  173. UNITL_BEING_ATTACKED = 64,/*removed after attack and counterattacks are performed*/
  174. UNTIL_ATTACK = 128, /*removed after attack and counterattacks are performed*/
  175. STACK_GETS_TURN = 256 /*removed when stack gets its turn - used for defensive stance*/
  176. };
  177. enum BonusSource
  178. {
  179. ARTIFACT,
  180. ARTIFACT_INSTANCE,
  181. OBJECT,
  182. CASTED_SPELL,
  183. CREATURE_ABILITY,
  184. TERRAIN_NATIVE,
  185. TERRAIN_OVERLAY,
  186. SPELL_EFFECT,
  187. TOWN_STRUCTURE,
  188. HERO_BASE_SKILL,
  189. SECONDARY_SKILL,
  190. HERO_SPECIAL,
  191. ARMY,
  192. CAMPAIGN_BONUS,
  193. SPECIAL_WEEK,
  194. OTHER /*used for defensive stance*/
  195. };
  196. enum LimitEffect
  197. {
  198. NO_LIMIT = 0,
  199. ONLY_DISTANCE_FIGHT=1, ONLY_MELEE_FIGHT, //used to mark bonuses for attack/defense primary skills from spells like Precision (distance only)
  200. ONLY_ALLIED_ARMY, ONLY_ENEMY_ARMY,
  201. PLAYR_HEROES,
  202. GLOBAL //Statue of Legion etc.
  203. };
  204. enum ValueType
  205. {
  206. ADDITIVE_VALUE,
  207. BASE_NUMBER,
  208. PERCENT_TO_ALL,
  209. PERCENT_TO_BASE,
  210. INDEPENDENT_MAX //used for SPELL bonus
  211. };
  212. ui16 duration; //uses BonusDuration values
  213. si16 turnsRemain; //used if duration is N_TURNS or N_DAYS
  214. TBonusType type; //uses BonusType values - says to what is this bonus - 1 byte
  215. TBonusSubtype subtype; //-1 if not applicable - 4 bytes
  216. ui8 source;//source type" uses BonusSource values - what gave that bonus
  217. si32 val;
  218. ui32 id; //source id: id of object/artifact/spell
  219. ui8 valType; //by ValueType enum
  220. si32 additionalInfo;
  221. ui8 effectRange; //if not NO_LIMIT, bonus will be ommitted by default
  222. boost::shared_ptr<ILimiter> limiter;
  223. boost::shared_ptr<IPropagator> propagator;
  224. std::string description;
  225. Bonus(ui8 Dur, ui8 Type, ui8 Src, si32 Val, ui32 ID, std::string Desc, si32 Subtype=-1);
  226. Bonus(ui8 Dur, ui8 Type, ui8 Src, si32 Val, ui32 ID, si32 Subtype=-1, ui8 ValType = ADDITIVE_VALUE);
  227. Bonus();
  228. ~Bonus();
  229. // //comparison
  230. // bool operator==(const HeroBonus &other)
  231. // {
  232. // return &other == this;
  233. // //TODO: what is best logic for that?
  234. // }
  235. // bool operator<(const HeroBonus &other)
  236. // {
  237. // return &other < this;
  238. // //TODO: what is best logic for that?
  239. // }
  240. template <typename Handler> void serialize(Handler &h, const int version)
  241. {
  242. h & duration & type & subtype & source & val & id & description & additionalInfo & turnsRemain & valType & effectRange & limiter;
  243. }
  244. static bool OneDay(const Bonus *hb)
  245. {
  246. return hb->duration & Bonus::ONE_DAY;
  247. }
  248. static bool OneWeek(const Bonus *hb)
  249. {
  250. return hb->duration & Bonus::ONE_WEEK;
  251. }
  252. static bool OneBattle(const Bonus *hb)
  253. {
  254. return hb->duration & Bonus::ONE_BATTLE;
  255. }
  256. static bool UntilGetsTurn(const Bonus *hb)
  257. {
  258. return hb->duration & Bonus::STACK_GETS_TURN;
  259. }
  260. static bool UntilAttack(const Bonus *hb)
  261. {
  262. return hb->duration & Bonus::UNTIL_ATTACK;
  263. }
  264. static bool UntilBeingAttacked(const Bonus *hb)
  265. {
  266. return hb->duration & Bonus::UNITL_BEING_ATTACKED;
  267. }
  268. static bool IsFrom(const Bonus &hb, ui8 source, ui32 id) //if id==0xffffff then id doesn't matter
  269. {
  270. return hb.source==source && (id==0xffffff || hb.id==id);
  271. }
  272. inline bool operator == (const BonusType & cf) const
  273. {
  274. return type == cf;
  275. }
  276. inline void ChangeBonusVal (const ui32 newVal)
  277. {
  278. val = newVal;
  279. }
  280. inline void operator += (const ui32 Val) //no return
  281. {
  282. val += Val;
  283. }
  284. const CSpell * sourceSpell() const;
  285. std::string Description() const;
  286. Bonus *addLimiter(ILimiter *Limiter); //returns this for convenient chain-calls
  287. };
  288. struct DLL_EXPORT stackExperience : public Bonus
  289. {
  290. std::vector<ui32> expBonuses; // variations for levels 1-10, copied to val field;
  291. bool enable; //if true - turns ability on / off for zero value
  292. template <typename Handler> void serialize(Handler &h, const int version)
  293. {
  294. h & static_cast<Bonus&>(this);
  295. h & expBonuses & enable;
  296. }
  297. };
  298. DLL_EXPORT std::ostream & operator<<(std::ostream &out, const Bonus &bonus);
  299. class BonusList : public std::list<Bonus*>
  300. {
  301. public:
  302. int DLL_EXPORT totalValue() const; //subtype -> subtype of bonus, if -1 then any
  303. void DLL_EXPORT getBonuses(BonusList &out, const CSelector &selector, const CBonusSystemNode *source = NULL) const;
  304. void DLL_EXPORT getBonuses(BonusList &out, const CSelector &selector, const CSelector &limit, const CBonusSystemNode *source = NULL) const;
  305. void DLL_EXPORT getModifiersWDescr(TModDescr &out) const;
  306. void DLL_EXPORT removeSpells(Bonus::BonusSource sourceType);
  307. //special find functions
  308. DLL_EXPORT Bonus * getFirst(const CSelector &select);
  309. DLL_EXPORT const Bonus * getFirst(const CSelector &select) const;
  310. void limit(const CBonusSystemNode &node); //erases bonuses using limitor
  311. template <typename Handler> void serialize(Handler &h, const int version)
  312. {
  313. h & static_cast<std::list<Bonus*>&>(*this);
  314. }
  315. };
  316. DLL_EXPORT std::ostream & operator<<(std::ostream &out, const BonusList &bonusList);
  317. class DLL_EXPORT IPropagator
  318. {
  319. public:
  320. virtual ~IPropagator();
  321. virtual CBonusSystemNode *getDestNode(CBonusSystemNode *source);
  322. };
  323. class DLL_EXPORT ILimiter
  324. {
  325. public:
  326. virtual ~ILimiter();
  327. virtual bool limit(const Bonus *b, const CBonusSystemNode &node) const; //return true to drop the bonus
  328. template <typename Handler> void serialize(Handler &h, const int version)
  329. {}
  330. };
  331. class DLL_EXPORT CBonusSystemNode
  332. {
  333. public:
  334. BonusList bonuses; //wielded bonuses (local and up-propagated here)
  335. BonusList exportedBonuses;
  336. TNodesVector parents, //parents -> we inherit bonuses from them, we may attach our bonuses to them
  337. children;
  338. ui8 nodeType;
  339. CBonusSystemNode();
  340. virtual ~CBonusSystemNode();
  341. //new bonusing node interface
  342. // * selector is predicate that tests if HeroBonus matches our criteria
  343. // * root is node on which call was made (NULL will be replaced with this)
  344. void getParents(TCNodes &out) const; //retrieves list of parent nodes (nodes to inherit bonuses from), source is the prinary asker
  345. void getBonuses(BonusList &out, const CSelector &selector, const CBonusSystemNode *root = NULL) const;
  346. //////////////////////////////////////////////////////////////////////////
  347. //interface
  348. void getModifiersWDescr(TModDescr &out, const CSelector &selector) const; //out: pairs<modifier value, modifier description>
  349. int getBonusesCount(const CSelector &selector) const;
  350. int valOfBonuses(const CSelector &selector) const;
  351. bool hasBonus(const CSelector &selector) const;
  352. BonusList getBonuses(const CSelector &selector, const CSelector &limit) const;
  353. void getBonuses(BonusList &out, const CSelector &selector, const CSelector &limit) const;
  354. BonusList getBonuses(const CSelector &selector) const;
  355. //legacy interface
  356. int valOfBonuses(Bonus::BonusType type, const CSelector &selector) const;
  357. int valOfBonuses(Bonus::BonusType type, int subtype = -1) const; //subtype -> subtype of bonus, if -1 then anyt;
  358. bool hasBonusOfType(Bonus::BonusType type, int subtype = -1) const;//determines if hero has a bonus of given type (and optionally subtype)
  359. bool hasBonusFrom(ui8 source, ui32 sourceID) const;
  360. void getModifiersWDescr( TModDescr &out, Bonus::BonusType type, int subtype = -1 ) const; //out: pairs<modifier value, modifier description>
  361. int getBonusesCount(int from, int id) const;
  362. ui32 getMinDamage() const; //used for stacks and creatures only
  363. ui32 getMaxDamage() const;
  364. int MoraleVal() const; //range [-3, +3]
  365. int LuckVal() const; //range [-3, +3]
  366. si32 Attack() const; //get attack of stack with all modificators
  367. si32 Defense(bool withFrenzy = true) const; //get defense of stack with all modificators
  368. ui16 MaxHealth() const; //get max HP of stack with all modifiers
  369. const Bonus *getBonus(const CSelector &selector) const;
  370. //non-const interface
  371. void getParents(TNodes &out); //retrieves list of parent nodes (nodes to inherit bonuses from), source is the prinary asker
  372. Bonus *getBonus(const CSelector &selector);
  373. void attachTo(CBonusSystemNode *parent);
  374. void detachFrom(CBonusSystemNode *parent);
  375. void detachFromAll();
  376. void addNewBonus(Bonus *b); //b will be deleted with destruction of node
  377. void newChildAttached(CBonusSystemNode *child);
  378. void childDetached(CBonusSystemNode *child);
  379. void propagateBonus(Bonus * b);
  380. //void addNewBonus(const Bonus &b); //b will copied
  381. void removeBonus(Bonus *b);
  382. TNodesVector &nodesOnWhichWePropagate();
  383. bool isIndependentNode() const; //node is independent when it has no parents nor children
  384. bool weActAsBonusSourceOnly() const;
  385. bool isLimitedOnUs(Bonus *b) const; //if bonus should be removed from list acquired from this node
  386. CBonusSystemNode *whereToPropagate(Bonus *b);
  387. void popBonuses(const CSelector &s);
  388. virtual std::string nodeName() const;
  389. template <typename Handler> void serialize(Handler &h, const int version)
  390. {
  391. h & bonuses & nodeType;
  392. }
  393. enum ENodeTypes
  394. {
  395. UNKNOWN, STACK, SPECIALITY, ARTIFACT, CREATURE, ARTIFACT_INSTANCE, HERO
  396. };
  397. };
  398. namespace NBonus
  399. {
  400. //set of methods that may be safely called with NULL objs
  401. DLL_EXPORT int valOf(const CBonusSystemNode *obj, Bonus::BonusType type, int subtype = -1); //subtype -> subtype of bonus, if -1 then any
  402. DLL_EXPORT bool hasOfType(const CBonusSystemNode *obj, Bonus::BonusType type, int subtype = -1);//determines if hero has a bonus of given type (and optionally subtype)
  403. //DLL_EXPORT const HeroBonus * get(const CBonusSystemNode *obj, int from, int id );
  404. DLL_EXPORT void getModifiersWDescr(const CBonusSystemNode *obj, TModDescr &out, Bonus::BonusType type, int subtype = -1 ); //out: pairs<modifier value, modifier description>
  405. DLL_EXPORT int getCount(const CBonusSystemNode *obj, int from, int id);
  406. };
  407. //generates HeroBonus from given data
  408. inline Bonus* makeFeature(Bonus::BonusType type, ui8 duration, si16 subtype, si32 value, Bonus::BonusSource source, ui16 turnsRemain = 0, si32 additionalInfo = 0)
  409. {
  410. Bonus* sf = new Bonus();
  411. sf->type = type;
  412. sf->duration = duration;
  413. sf->source = source;
  414. sf->turnsRemain = turnsRemain;
  415. sf->subtype = subtype;
  416. sf->val = value;
  417. sf->additionalInfo = additionalInfo;
  418. return sf;
  419. }
  420. class DLL_EXPORT CSelectorsConjunction
  421. {
  422. const CSelector first, second;
  423. public:
  424. CSelectorsConjunction(const CSelector &First, const CSelector &Second)
  425. :first(First), second(Second)
  426. {
  427. }
  428. bool operator()(const Bonus *bonus) const
  429. {
  430. return first(bonus) && second(bonus);
  431. }
  432. };
  433. CSelector DLL_EXPORT operator&&(const CSelector &first, const CSelector &second);
  434. class DLL_EXPORT CSelectorsAlternative
  435. {
  436. const CSelector first, second;
  437. public:
  438. CSelectorsAlternative(const CSelector &First, const CSelector &Second)
  439. :first(First), second(Second)
  440. {
  441. }
  442. bool operator()(const Bonus *bonus) const
  443. {
  444. return first(bonus) || second(bonus);
  445. }
  446. };
  447. CSelector DLL_EXPORT operator||(const CSelector &first, const CSelector &second);
  448. template<typename T>
  449. class CSelectFieldEqual
  450. {
  451. T Bonus::*ptr;
  452. T val;
  453. public:
  454. CSelectFieldEqual(T Bonus::*Ptr, const T &Val)
  455. : ptr(Ptr), val(Val)
  456. {
  457. }
  458. bool operator()(const Bonus *bonus) const
  459. {
  460. return bonus->*ptr == val;
  461. }
  462. CSelectFieldEqual& operator()(const T &setVal)
  463. {
  464. val = setVal;
  465. return *this;
  466. }
  467. };
  468. class DLL_EXPORT CWillLastTurns
  469. {
  470. public:
  471. int turnsRequested;
  472. bool operator()(const Bonus *bonus) const
  473. {
  474. return turnsRequested <= 0 //every present effect will last zero (or "less") turns
  475. || !(bonus->duration & Bonus::N_TURNS) //so do every not expriing after N-turns effect
  476. || bonus->turnsRemain > turnsRequested;
  477. }
  478. CWillLastTurns& operator()(const int &setVal)
  479. {
  480. turnsRequested = setVal;
  481. return *this;
  482. }
  483. };
  484. class DLL_EXPORT CCreatureTypeLimiter : public ILimiter //affect only stacks of given creature (and optionally it's upgrades)
  485. {
  486. public:
  487. const CCreature *creature;
  488. ui8 includeUpgrades;
  489. CCreatureTypeLimiter();
  490. CCreatureTypeLimiter(const CCreature &Creature, ui8 IncludeUpgrades = true);
  491. bool limit(const Bonus *b, const CBonusSystemNode &node) const OVERRIDE;
  492. template <typename Handler> void serialize(Handler &h, const int version)
  493. {
  494. h & creature & includeUpgrades;
  495. }
  496. };
  497. class DLL_EXPORT HasAnotherBonusLimiter : public ILimiter //applies only to nodes that have another bonus working
  498. {
  499. public:
  500. TBonusType type;
  501. TBonusSubtype subtype;
  502. ui8 isSubtypeRelevant; //check for subtype only if this is true
  503. HasAnotherBonusLimiter(TBonusType bonus = Bonus::NONE);
  504. HasAnotherBonusLimiter(TBonusType bonus, TBonusSubtype _subtype);
  505. bool limit(const Bonus *b, const CBonusSystemNode &node) const OVERRIDE;
  506. template <typename Handler> void serialize(Handler &h, const int version)
  507. {
  508. h & type & subtype & isSubtypeRelevant;
  509. }
  510. };
  511. class DLL_EXPORT CreatureNativeTerrainLimiter : public ILimiter //applies only to creatures that are on their native terrain
  512. {
  513. public:
  514. si8 terrainType;
  515. CreatureNativeTerrainLimiter();
  516. CreatureNativeTerrainLimiter(int TerrainType);
  517. bool limit(const Bonus *b, const CBonusSystemNode &node) const OVERRIDE;
  518. template <typename Handler> void serialize(Handler &h, const int version)
  519. {
  520. h & terrainType;
  521. }
  522. };
  523. class DLL_EXPORT CreatureFactionLimiter : public ILimiter //applies only to creatures of given faction
  524. {
  525. public:
  526. si8 faction;
  527. CreatureFactionLimiter();
  528. CreatureFactionLimiter(int TerrainType);
  529. bool limit(const Bonus *b, const CBonusSystemNode &node) const OVERRIDE;
  530. template <typename Handler> void serialize(Handler &h, const int version)
  531. {
  532. h & faction;
  533. }
  534. };
  535. class DLL_EXPORT CreatureAlignmentLimiter : public ILimiter //applies only to creatures of given alignment
  536. {
  537. public:
  538. si8 alignment;
  539. CreatureAlignmentLimiter();
  540. CreatureAlignmentLimiter(si8 Alignment);
  541. bool limit(const Bonus *b, const CBonusSystemNode &node) const OVERRIDE;
  542. template <typename Handler> void serialize(Handler &h, const int version)
  543. {
  544. h & alignment;
  545. }
  546. };
  547. const CCreature *retrieveCreature(const CBonusSystemNode *node);
  548. namespace Selector
  549. {
  550. extern DLL_EXPORT CSelectFieldEqual<TBonusType> type;
  551. extern DLL_EXPORT CSelectFieldEqual<TBonusSubtype> subtype;
  552. extern DLL_EXPORT CSelectFieldEqual<si32> info;
  553. extern DLL_EXPORT CSelectFieldEqual<ui8> sourceType;
  554. extern DLL_EXPORT CSelectFieldEqual<ui8> effectRange;
  555. extern DLL_EXPORT CWillLastTurns turns;
  556. CSelector DLL_EXPORT typeSybtype(TBonusType Type, TBonusSubtype Subtype);
  557. CSelector DLL_EXPORT typeSybtypeInfo(TBonusType type, TBonusSubtype subtype, si32 info);
  558. CSelector DLL_EXPORT source(ui8 source, ui32 sourceID);
  559. CSelector DLL_EXPORT sourceTypeSel(ui8 source);
  560. bool DLL_EXPORT matchesType(const CSelector &sel, TBonusType type);
  561. bool DLL_EXPORT matchesTypeSubtype(const CSelector &sel, TBonusType type, TBonusSubtype subtype);
  562. }
  563. extern DLL_EXPORT const std::map<std::string, int> bonusNameMap;