HeroBonus.h 50 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324
  1. /*
  2. * HeroBonus.h, part of VCMI engine
  3. *
  4. * Authors: listed in file AUTHORS in main folder
  5. *
  6. * License: GNU General Public License v2.0 or later
  7. * Full text of license available in license.txt file, in main folder
  8. *
  9. */
  10. #pragma once
  11. #include "GameConstants.h"
  12. #include "JsonNode.h"
  13. VCMI_LIB_NAMESPACE_BEGIN
  14. class CCreature;
  15. struct Bonus;
  16. class IBonusBearer;
  17. class CBonusSystemNode;
  18. class ILimiter;
  19. class IPropagator;
  20. class IUpdater;
  21. class BonusList;
  22. typedef std::shared_ptr<BonusList> TBonusListPtr;
  23. typedef std::shared_ptr<const BonusList> TConstBonusListPtr;
  24. typedef std::shared_ptr<ILimiter> TLimiterPtr;
  25. typedef std::shared_ptr<IPropagator> TPropagatorPtr;
  26. typedef std::shared_ptr<IUpdater> TUpdaterPtr;
  27. typedef std::set<CBonusSystemNode*> TNodes;
  28. typedef std::set<const CBonusSystemNode*> TCNodes;
  29. typedef std::vector<CBonusSystemNode *> TNodesVector;
  30. class CSelector : std::function<bool(const Bonus*)>
  31. {
  32. typedef std::function<bool(const Bonus*)> TBase;
  33. public:
  34. CSelector() {}
  35. template<typename T>
  36. CSelector(const T &t, //SFINAE trick -> include this c-tor in overload resolution only if parameter is class
  37. //(includes functors, lambdas) or function. Without that VC is going mad about ambiguities.
  38. typename std::enable_if < boost::mpl::or_ < std::is_class<T>, std::is_function<T >> ::value>::type *dummy = nullptr)
  39. : TBase(t)
  40. {}
  41. CSelector(std::nullptr_t)
  42. {}
  43. CSelector And(CSelector rhs) const
  44. {
  45. //lambda may likely outlive "this" (it can be even a temporary) => we copy the OBJECT (not pointer)
  46. auto thisCopy = *this;
  47. return [thisCopy, rhs](const Bonus *b) mutable { return thisCopy(b) && rhs(b); };
  48. }
  49. CSelector Or(CSelector rhs) const
  50. {
  51. auto thisCopy = *this;
  52. return [thisCopy, rhs](const Bonus *b) mutable { return thisCopy(b) || rhs(b); };
  53. }
  54. CSelector Not() const
  55. {
  56. auto thisCopy = *this;
  57. return [thisCopy](const Bonus *b) mutable { return !thisCopy(b); };
  58. }
  59. bool operator()(const Bonus *b) const
  60. {
  61. return TBase::operator()(b);
  62. }
  63. operator bool() const
  64. {
  65. return !!static_cast<const TBase&>(*this);
  66. }
  67. };
  68. class DLL_LINKAGE CBonusProxy
  69. {
  70. public:
  71. CBonusProxy(const IBonusBearer * Target, CSelector Selector);
  72. CBonusProxy(const CBonusProxy & other);
  73. CBonusProxy(CBonusProxy && other);
  74. CBonusProxy & operator=(CBonusProxy && other);
  75. CBonusProxy & operator=(const CBonusProxy & other);
  76. const BonusList * operator->() const;
  77. TConstBonusListPtr getBonusList() const;
  78. protected:
  79. CSelector selector;
  80. const IBonusBearer * target;
  81. mutable int64_t bonusListCachedLast;
  82. mutable TConstBonusListPtr bonusList[2];
  83. mutable int currentBonusListIndex;
  84. mutable boost::mutex swapGuard;
  85. void swapBonusList(TConstBonusListPtr other) const;
  86. };
  87. class DLL_LINKAGE CTotalsProxy : public CBonusProxy
  88. {
  89. public:
  90. CTotalsProxy(const IBonusBearer * Target, CSelector Selector, int InitialValue);
  91. CTotalsProxy(const CTotalsProxy & other);
  92. CTotalsProxy(CTotalsProxy && other) = delete;
  93. CTotalsProxy & operator=(const CTotalsProxy & other);
  94. CTotalsProxy & operator=(CTotalsProxy && other) = delete;
  95. int getMeleeValue() const;
  96. int getRangedValue() const;
  97. int getValue() const;
  98. /**
  99. Returns total value of all selected bonuses and sets bonusList as a pointer to the list of selected bonuses
  100. @param bonusList is the out list of all selected bonuses
  101. @return total value of all selected bonuses and 0 otherwise
  102. */
  103. int getValueAndList(TConstBonusListPtr & bonusList) const;
  104. private:
  105. int initialValue;
  106. mutable int64_t valueCachedLast;
  107. mutable int value;
  108. mutable int64_t meleeCachedLast;
  109. mutable int meleeValue;
  110. mutable int64_t rangedCachedLast;
  111. mutable int rangedValue;
  112. };
  113. class DLL_LINKAGE CCheckProxy
  114. {
  115. public:
  116. CCheckProxy(const IBonusBearer * Target, CSelector Selector);
  117. CCheckProxy(const CCheckProxy & other);
  118. CCheckProxy& operator= (const CCheckProxy & other) = default;
  119. bool getHasBonus() const;
  120. private:
  121. const IBonusBearer * target;
  122. CSelector selector;
  123. mutable int64_t cachedLast;
  124. mutable bool hasBonus;
  125. };
  126. class DLL_LINKAGE CAddInfo : public std::vector<si32>
  127. {
  128. public:
  129. enum { NONE = -1 };
  130. CAddInfo();
  131. CAddInfo(si32 value);
  132. bool operator==(si32 value) const;
  133. bool operator!=(si32 value) const;
  134. si32 & operator[](size_type pos);
  135. si32 operator[](size_type pos) const;
  136. std::string toString() const;
  137. JsonNode toJsonNode() const;
  138. };
  139. #define BONUS_TREE_DESERIALIZATION_FIX if(!h.saving && h.smartPointerSerialization) deserializationFix();
  140. #define BONUS_LIST \
  141. BONUS_NAME(NONE) \
  142. BONUS_NAME(LEVEL_COUNTER) /* for commander artifacts*/ \
  143. BONUS_NAME(MOVEMENT) /*both water/land*/ \
  144. BONUS_NAME(LAND_MOVEMENT) \
  145. BONUS_NAME(SEA_MOVEMENT) \
  146. BONUS_NAME(MORALE) \
  147. BONUS_NAME(LUCK) \
  148. BONUS_NAME(PRIMARY_SKILL) /*uses subtype to pick skill; additional info if set: 1 - only melee, 2 - only distance*/ \
  149. BONUS_NAME(SIGHT_RADIUS) \
  150. BONUS_NAME(MANA_REGENERATION) /*points per turn apart from normal (1 + mysticism)*/ \
  151. BONUS_NAME(FULL_MANA_REGENERATION) /*all mana points are replenished every day*/ \
  152. BONUS_NAME(NONEVIL_ALIGNMENT_MIX) /*good and neutral creatures can be mixed without morale penalty*/ \
  153. BONUS_NAME(SECONDARY_SKILL_PREMY) /*%*/ \
  154. BONUS_NAME(SURRENDER_DISCOUNT) /*%*/ \
  155. BONUS_NAME(STACKS_SPEED) /*additional info - percent of speed bonus applied after direct bonuses; >0 - added, <0 - subtracted to this part*/ \
  156. BONUS_NAME(FLYING_MOVEMENT) /*value - penalty percentage*/ \
  157. BONUS_NAME(SPELL_DURATION) \
  158. BONUS_NAME(AIR_SPELL_DMG_PREMY) \
  159. BONUS_NAME(EARTH_SPELL_DMG_PREMY) \
  160. BONUS_NAME(FIRE_SPELL_DMG_PREMY) \
  161. BONUS_NAME(WATER_SPELL_DMG_PREMY) \
  162. BONUS_NAME(WATER_WALKING) /*value - penalty percentage*/ \
  163. BONUS_NAME(NEGATE_ALL_NATURAL_IMMUNITIES) \
  164. BONUS_NAME(STACK_HEALTH) \
  165. BONUS_NAME(BLOCK_MORALE) \
  166. BONUS_NAME(BLOCK_LUCK) \
  167. BONUS_NAME(FIRE_SPELLS) \
  168. BONUS_NAME(AIR_SPELLS) \
  169. BONUS_NAME(WATER_SPELLS) \
  170. BONUS_NAME(EARTH_SPELLS) \
  171. BONUS_NAME(GENERATE_RESOURCE) /*daily value, uses subtype (resource type)*/ \
  172. BONUS_NAME(CREATURE_GROWTH) /*for legion artifacts: value - week growth bonus, subtype - monster level if aplicable*/ \
  173. BONUS_NAME(WHIRLPOOL_PROTECTION) /*hero won't lose army when teleporting through whirlpool*/ \
  174. BONUS_NAME(SPELL) /*hero knows spell, val - skill level (0 - 3), subtype - spell id*/ \
  175. BONUS_NAME(SPELLS_OF_LEVEL) /*hero knows all spells of given level, val - skill level; subtype - level*/ \
  176. BONUS_NAME(BATTLE_NO_FLEEING) /*for shackles of war*/ \
  177. 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*/ \
  178. BONUS_NAME(FREE_SHOOTING) /*stacks can shoot even if otherwise blocked (sharpshooter's bow effect)*/ \
  179. BONUS_NAME(OPENING_BATTLE_SPELL) /*casts a spell at expert level at beginning of battle, val - spell power, subtype - spell id*/ \
  180. BONUS_NAME(IMPROVED_NECROMANCY) /* raise more powerful creatures: subtype - creature type raised, addInfo - [required necromancy level, required stack level], val - necromancy level for this purpose */ \
  181. BONUS_NAME(CREATURE_GROWTH_PERCENT) /*increases growth of all units in all towns, val - percentage*/ \
  182. BONUS_NAME(FREE_SHIP_BOARDING) /*movement points preserved with ship boarding and landing*/ \
  183. BONUS_NAME(NO_TYPE) \
  184. BONUS_NAME(FLYING) \
  185. BONUS_NAME(SHOOTER) \
  186. BONUS_NAME(CHARGE_IMMUNITY) \
  187. BONUS_NAME(ADDITIONAL_ATTACK) \
  188. BONUS_NAME(UNLIMITED_RETALIATIONS) \
  189. BONUS_NAME(NO_MELEE_PENALTY) \
  190. BONUS_NAME(JOUSTING) /*for champions*/ \
  191. BONUS_NAME(HATE) /*eg. angels hate devils, subtype - ID of hated creature, val - damage bonus percent */ \
  192. BONUS_NAME(KING) /* val - required slayer bonus val to affect */\
  193. BONUS_NAME(MAGIC_RESISTANCE) /*in % (value)*/ \
  194. BONUS_NAME(CHANGES_SPELL_COST_FOR_ALLY) /*in mana points (value) , eg. mage*/ \
  195. BONUS_NAME(CHANGES_SPELL_COST_FOR_ENEMY) /*in mana points (value) , eg. pegasus */ \
  196. BONUS_NAME(SPELL_AFTER_ATTACK) /* subtype - spell id, value - chance %, addInfo[0] - level, addInfo[1] -> [0 - all attacks, 1 - shot only, 2 - melee only] */ \
  197. BONUS_NAME(SPELL_BEFORE_ATTACK) /* subtype - spell id, value - chance %, addInfo[0] - level, addInfo[1] -> [0 - all attacks, 1 - shot only, 2 - melee only] */ \
  198. BONUS_NAME(SPELL_RESISTANCE_AURA) /*eg. unicorns, value - resistance bonus in % for adjacent creatures*/ \
  199. BONUS_NAME(LEVEL_SPELL_IMMUNITY) /*creature is immune to all spell with level below or equal to value of this bonus */ \
  200. BONUS_NAME(BLOCK_MAGIC_ABOVE) /*blocks casting spells of the level > value */ \
  201. BONUS_NAME(BLOCK_ALL_MAGIC) /*blocks casting spells*/ \
  202. BONUS_NAME(TWO_HEX_ATTACK_BREATH) /*eg. dragons*/ \
  203. BONUS_NAME(SPELL_DAMAGE_REDUCTION) /*eg. golems; value - reduction in %, subtype - spell school; -1 - all, 0 - air, 1 - fire, 2 - water, 3 - earth*/ \
  204. BONUS_NAME(NO_WALL_PENALTY) \
  205. BONUS_NAME(NON_LIVING) /*eg. golems, cannot be rised or healed, only neutral morale */ \
  206. BONUS_NAME(RANDOM_SPELLCASTER) /*eg. master genie, val - level*/ \
  207. BONUS_NAME(BLOCKS_RETALIATION) /*eg. naga*/ \
  208. BONUS_NAME(SPELL_IMMUNITY) /*subid - spell id*/ \
  209. BONUS_NAME(MANA_CHANNELING) /*value in %, eg. familiar*/ \
  210. BONUS_NAME(SPELL_LIKE_ATTACK) /*subtype - spell, value - spell level; range is taken from spell, but damage from creature; eg. magog*/ \
  211. BONUS_NAME(THREE_HEADED_ATTACK) /*eg. cerberus*/ \
  212. BONUS_NAME(GENERAL_DAMAGE_PREMY) \
  213. BONUS_NAME(FIRE_IMMUNITY) /*subtype 0 - all, 1 - all except positive, 2 - only damage spells*/ \
  214. BONUS_NAME(WATER_IMMUNITY) \
  215. BONUS_NAME(EARTH_IMMUNITY) \
  216. BONUS_NAME(AIR_IMMUNITY) \
  217. BONUS_NAME(MIND_IMMUNITY) \
  218. BONUS_NAME(FIRE_SHIELD) \
  219. BONUS_NAME(UNDEAD) \
  220. BONUS_NAME(HP_REGENERATION) /*creature regenerates val HP every new round*/ \
  221. BONUS_NAME(MANA_DRAIN) /*value - spell points per turn*/ \
  222. BONUS_NAME(LIFE_DRAIN) \
  223. BONUS_NAME(DOUBLE_DAMAGE_CHANCE) /*value in %, eg. dread knight*/ \
  224. BONUS_NAME(RETURN_AFTER_STRIKE) \
  225. BONUS_NAME(SELF_MORALE) /*eg. minotaur*/ \
  226. BONUS_NAME(SPELLCASTER) /*subtype - spell id, value - level of school, additional info - weighted chance. use SPECIFIC_SPELL_POWER, CREATURE_SPELL_POWER or CREATURE_ENCHANT_POWER for calculating the power*/ \
  227. BONUS_NAME(CATAPULT) \
  228. BONUS_NAME(ENEMY_DEFENCE_REDUCTION) /*in % (value) eg. behemots*/ \
  229. BONUS_NAME(GENERAL_DAMAGE_REDUCTION) /* shield / air shield effect, also armorer skill/petrify effect for subtype -1*/ \
  230. BONUS_NAME(GENERAL_ATTACK_REDUCTION) /*eg. while stoned or blinded - in %,// subtype not used, use ONLY_MELEE_FIGHT / DISTANCE_FIGHT*/ \
  231. BONUS_NAME(DEFENSIVE_STANCE) /* val - bonus to defense while defending */ \
  232. BONUS_NAME(ATTACKS_ALL_ADJACENT) /*eg. hydra*/ \
  233. BONUS_NAME(MORE_DAMAGE_FROM_SPELL) /*value - damage increase in %, subtype - spell id*/ \
  234. BONUS_NAME(FEAR) \
  235. BONUS_NAME(FEARLESS) \
  236. BONUS_NAME(NO_DISTANCE_PENALTY) \
  237. BONUS_NAME(SELF_LUCK) /*halfling*/ \
  238. BONUS_NAME(ENCHANTER)/* for Enchanter spells, val - skill level, subtype - spell id, additionalInfo - cooldown */ \
  239. BONUS_NAME(HEALER) \
  240. BONUS_NAME(SIEGE_WEAPON) \
  241. BONUS_NAME(HYPNOTIZED) \
  242. BONUS_NAME(NO_RETALIATION) /*temporary bonus for basilisk, unicorn and scorpicore paralyze*/\
  243. BONUS_NAME(ADDITIONAL_RETALIATION) /*value - number of additional retaliations*/ \
  244. BONUS_NAME(MAGIC_MIRROR) /* value - chance of redirecting in %*/ \
  245. BONUS_NAME(ALWAYS_MINIMUM_DAMAGE) /*unit does its minimum damage from range; subtype: -1 - any attack, 0 - melee, 1 - ranged, value: additional damage penalty (it'll subtracted from dmg), additional info - multiplicative anti-bonus for dmg in % [eg 20 means that creature will inflict 80% of normal minimal dmg]*/ \
  246. 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 %*/ \
  247. BONUS_NAME(ATTACKS_NEAREST_CREATURE) /*while in berserk*/ \
  248. BONUS_NAME(IN_FRENZY) /*value - level*/ \
  249. BONUS_NAME(SLAYER) /*value - level*/ \
  250. BONUS_NAME(FORGETFULL) /*forgetfulness spell effect, value - level*/ \
  251. BONUS_NAME(NOT_ACTIVE) /* subtype - spell ID (paralyze, blind, stone gaze) for graphical effect*/ \
  252. BONUS_NAME(NO_LUCK) /*eg. when fighting on cursed ground*/ \
  253. BONUS_NAME(NO_MORALE) /*eg. when fighting on cursed ground*/ \
  254. BONUS_NAME(DARKNESS) /*val = radius */ \
  255. BONUS_NAME(SPECIAL_SECONDARY_SKILL) /*subtype = id, val = value per level in percent*/ \
  256. BONUS_NAME(SPECIAL_SPELL_LEV) /*subtype = id, val = value per level in percent*/\
  257. BONUS_NAME(SPELL_DAMAGE) /*val = value, now works for sorcery*/\
  258. BONUS_NAME(SPECIFIC_SPELL_DAMAGE) /*subtype = id of spell, val = value*/\
  259. BONUS_NAME(SPECIAL_PECULIAR_ENCHANT) /*blesses and curses with id = val dependent on unit's level, subtype = 0 or 1 for Coronius*/\
  260. BONUS_NAME(SPECIAL_UPGRADE) /*subtype = base, additionalInfo = target */\
  261. BONUS_NAME(DRAGON_NATURE) \
  262. BONUS_NAME(CREATURE_DAMAGE)/*subtype 0 = both, 1 = min, 2 = max*/\
  263. BONUS_NAME(EXP_MULTIPLIER)/* val - percent of additional exp gained by stack/commander (base value 100)*/\
  264. BONUS_NAME(SHOTS)\
  265. BONUS_NAME(DEATH_STARE) /*subtype 0 - gorgon, 1 - commander*/\
  266. BONUS_NAME(POISON) /*val - max health penalty from poison possible*/\
  267. BONUS_NAME(BIND_EFFECT) /*doesn't do anything particular, works as a marker)*/\
  268. BONUS_NAME(ACID_BREATH) /*additional val damage per creature after attack, additional info - chance in percent*/\
  269. BONUS_NAME(RECEPTIVE) /*accepts friendly spells even with immunity*/\
  270. BONUS_NAME(DIRECT_DAMAGE_IMMUNITY) /*direct damage spells, that is*/\
  271. BONUS_NAME(CASTS) /*how many times creature can cast activated spell*/ \
  272. BONUS_NAME(SPECIFIC_SPELL_POWER) /* value used for Thunderbolt and Resurrection cast by units, subtype - spell id */\
  273. BONUS_NAME(CREATURE_SPELL_POWER) /* value per unit, divided by 100 (so faerie Dragons have 800)*/ \
  274. BONUS_NAME(CREATURE_ENCHANT_POWER) /* total duration of spells cast by creature */ \
  275. BONUS_NAME(ENCHANTED) /* permanently enchanted with spell subID of level = val, if val > 3 then spell is mass and has level of val-3*/ \
  276. BONUS_NAME(REBIRTH) /* val - percent of life restored, subtype = 0 - regular, 1 - at least one unit (sacred Phoenix) */\
  277. BONUS_NAME(ADDITIONAL_UNITS) /*val of units with id = subtype will be added to hero's army at the beginning of battle */\
  278. BONUS_NAME(SPOILS_OF_WAR) /*val * 10^-6 * gained exp resources of subtype will be given to hero after battle*/\
  279. BONUS_NAME(BLOCK)\
  280. BONUS_NAME(DISGUISED) /* subtype - spell level */\
  281. BONUS_NAME(VISIONS) /* subtype - spell level */\
  282. BONUS_NAME(NO_TERRAIN_PENALTY) /* subtype - terrain type */\
  283. BONUS_NAME(SOUL_STEAL) /*val - number of units gained per enemy killed, subtype = 0 - gained units survive after battle, 1 - they do not*/ \
  284. BONUS_NAME(TRANSMUTATION) /*val - chance to trigger in %, subtype = 0 - resurrection based on HP, 1 - based on unit count, additional info - target creature ID (attacker default)*/\
  285. BONUS_NAME(SUMMON_GUARDIANS) /*val - amount in % of stack count, subtype = creature ID*/\
  286. BONUS_NAME(CATAPULT_EXTRA_SHOTS) /*val - number of additional shots, requires CATAPULT bonus to work*/\
  287. BONUS_NAME(RANGED_RETALIATION) /*allows shooters to perform ranged retaliation*/\
  288. BONUS_NAME(BLOCKS_RANGED_RETALIATION) /*disallows ranged retaliation for shooter unit, BLOCKS_RETALIATION bonus is for melee retaliation only*/\
  289. BONUS_NAME(SECONDARY_SKILL_VAL2) /*for secondary skills that have multiple effects, like eagle eye (max level and chance)*/ \
  290. BONUS_NAME(MANUAL_CONTROL) /* manually control warmachine with id = subtype, chance = val */ \
  291. BONUS_NAME(WIDE_BREATH) /* initial desigh: dragon breath affecting multiple nearby hexes */\
  292. BONUS_NAME(FIRST_STRIKE) /* first counterattack, then attack if possible */\
  293. BONUS_NAME(SYNERGY_TARGET) /* dummy skill for alternative upgrades mod */\
  294. BONUS_NAME(SHOOTS_ALL_ADJACENT) /* H4 Cyclops-like shoot (attacks all hexes neighboring with target) without spell-like mechanics */\
  295. BONUS_NAME(BLOCK_MAGIC_BELOW) /*blocks casting spells of the level < value */ \
  296. BONUS_NAME(DESTRUCTION) /*kills extra units after hit, subtype = 0 - kill percentage of units, 1 - kill amount, val = chance in percent to trigger, additional info - amount/percentage to kill*/ \
  297. BONUS_NAME(SPECIAL_CRYSTAL_GENERATION) /*crystal dragon crystal generation*/ \
  298. BONUS_NAME(NO_SPELLCAST_BY_DEFAULT) /*spellcast will not be default attack option for this creature*/ \
  299. BONUS_NAME(GARGOYLE) /* gargoyle is special than NON_LIVING, cannot be rised or healed */ \
  300. BONUS_NAME(SPECIAL_ADD_VALUE_ENCHANT) /*specialty spell like Aenin has, increased effect of spell, additionalInfo = value to add*/\
  301. BONUS_NAME(SPECIAL_FIXED_VALUE_ENCHANT) /*specialty spell like Melody has, constant spell effect (i.e. 3 luck), additionalInfo = value to fix.*/\
  302. BONUS_NAME(TOWN_MAGIC_WELL) /*one-time pseudo-bonus to implement Magic Well in the town*/\
  303. BONUS_NAME(LIMITED_SHOOTING_RANGE) /*limits range of shooting creatures, doesn't adjust any other mechanics (half vs full damage etc). val - range in hexes, additional info - optional new range for broken arrow mechanic */\
  304. BONUS_NAME(LEARN_BATTLE_SPELL_CHANCE) /*skill-agnostic eagle eye chance. subtype = 0 - from enemy, 1 - TODO: from entire battlefield*/\
  305. BONUS_NAME(LEARN_BATTLE_SPELL_LEVEL_LIMIT) /*skill-agnostic eagle eye limit, subtype - school (-1 for all), others TODO*/\
  306. BONUS_NAME(PERCENTAGE_DAMAGE_BOOST) /*skill-agnostic archery and offence, subtype is 0 for offence and 1 for archery*/\
  307. BONUS_NAME(LEARN_MEETING_SPELL_LIMIT) /*skill-agnostic scholar, subtype is -1 for all, TODO for others (> 0)*/\
  308. BONUS_NAME(ROUGH_TERRAIN_DISCOUNT) /*skill-agnostic pathfinding*/\
  309. BONUS_NAME(WANDERING_CREATURES_JOIN_BONUS) /*skill-agnostic diplomacy*/\
  310. BONUS_NAME(BEFORE_BATTLE_REPOSITION) /*skill-agnostic tactics, bonus for allowing tactics*/\
  311. BONUS_NAME(BEFORE_BATTLE_REPOSITION_BLOCK) /*skill-agnostic tactics, bonus for blocking opposite tactics. For now donble side tactics is TODO.*/\
  312. BONUS_NAME(HERO_EXPERIENCE_GAIN_PERCENT) /*skill-agnostic learning, and we can use it as a global effect also*/\
  313. BONUS_NAME(UNDEAD_RAISE_PERCENTAGE) /*Percentage of killed enemy creatures to be raised after battle as undead*/\
  314. /* end of list */
  315. #define BONUS_SOURCE_LIST \
  316. BONUS_SOURCE(ARTIFACT)\
  317. BONUS_SOURCE(ARTIFACT_INSTANCE)\
  318. BONUS_SOURCE(OBJECT)\
  319. BONUS_SOURCE(CREATURE_ABILITY)\
  320. BONUS_SOURCE(TERRAIN_NATIVE)\
  321. BONUS_SOURCE(TERRAIN_OVERLAY)\
  322. BONUS_SOURCE(SPELL_EFFECT)\
  323. BONUS_SOURCE(TOWN_STRUCTURE)\
  324. BONUS_SOURCE(HERO_BASE_SKILL)\
  325. BONUS_SOURCE(SECONDARY_SKILL)\
  326. BONUS_SOURCE(HERO_SPECIAL)\
  327. BONUS_SOURCE(ARMY)\
  328. BONUS_SOURCE(CAMPAIGN_BONUS)\
  329. BONUS_SOURCE(SPECIAL_WEEK)\
  330. BONUS_SOURCE(STACK_EXPERIENCE)\
  331. BONUS_SOURCE(COMMANDER) /*TODO: consider using simply STACK_INSTANCE */\
  332. BONUS_SOURCE(GLOBAL) /*used for base bonuses which all heroes or all stacks should have*/\
  333. BONUS_SOURCE(OTHER) /*used for defensive stance and default value of spell level limit*/
  334. #define BONUS_VALUE_LIST \
  335. BONUS_VALUE(ADDITIVE_VALUE)\
  336. BONUS_VALUE(BASE_NUMBER)\
  337. BONUS_VALUE(PERCENT_TO_ALL)\
  338. BONUS_VALUE(PERCENT_TO_BASE)\
  339. BONUS_VALUE(PERCENT_TO_SOURCE) /*Adds value only to bonuses with same source*/\
  340. BONUS_VALUE(PERCENT_TO_TARGET_TYPE) /*Adds value only to bonuses with SourceType target*/\
  341. BONUS_VALUE(INDEPENDENT_MAX) /*used for SPELL bonus */\
  342. BONUS_VALUE(INDEPENDENT_MIN) //used for SECONDARY_SKILL_PREMY bonus
  343. /// Struct for handling bonuses of several types. Can be transferred to any hero
  344. struct DLL_LINKAGE Bonus : public std::enable_shared_from_this<Bonus>
  345. {
  346. enum { EVERY_TYPE = -1 };
  347. enum BonusType
  348. {
  349. #define BONUS_NAME(x) x,
  350. BONUS_LIST
  351. #undef BONUS_NAME
  352. };
  353. enum BonusDuration //when bonus is automatically removed
  354. {
  355. PERMANENT = 1,
  356. ONE_BATTLE = 2, //at the end of battle
  357. ONE_DAY = 4, //at the end of day
  358. ONE_WEEK = 8, //at the end of week (bonus lasts till the end of week, thats NOT 7 days
  359. N_TURNS = 16, //used during battles, after battle bonus is always removed
  360. N_DAYS = 32,
  361. UNTIL_BEING_ATTACKED = 64, /*removed after attack and counterattacks are performed*/
  362. UNTIL_ATTACK = 128, /*removed after attack and counterattacks are performed*/
  363. STACK_GETS_TURN = 256, /*removed when stack gets its turn - used for defensive stance*/
  364. COMMANDER_KILLED = 512
  365. };
  366. enum BonusSource
  367. {
  368. #define BONUS_SOURCE(x) x,
  369. BONUS_SOURCE_LIST
  370. #undef BONUS_SOURCE
  371. NUM_BONUS_SOURCE /*This is a dummy value, which will be always last*/
  372. };
  373. enum LimitEffect
  374. {
  375. NO_LIMIT = 0,
  376. ONLY_DISTANCE_FIGHT=1, ONLY_MELEE_FIGHT, //used to mark bonuses for attack/defense primary skills from spells like Precision (distance only)
  377. ONLY_ENEMY_ARMY
  378. };
  379. enum ValueType
  380. {
  381. #define BONUS_VALUE(x) x,
  382. BONUS_VALUE_LIST
  383. #undef BONUS_VALUE
  384. };
  385. ui16 duration; //uses BonusDuration values
  386. si16 turnsRemain; //used if duration is N_TURNS, N_DAYS or ONE_WEEK
  387. BonusType type; //uses BonusType values - says to what is this bonus - 1 byte
  388. TBonusSubtype subtype; //-1 if not applicable - 4 bytes
  389. BonusSource source;//source type" uses BonusSource values - what gave that bonus
  390. BonusSource targetSourceType;//Bonuses of what origin this amplifies, uses BonusSource values. Needed for PERCENT_TO_TARGET_TYPE.
  391. si32 val;
  392. ui32 sid; //source id: id of object/artifact/spell
  393. ValueType valType;
  394. std::string stacking; // bonuses with the same stacking value don't stack (e.g. Angel/Archangel morale bonus)
  395. CAddInfo additionalInfo;
  396. LimitEffect effectRange; //if not NO_LIMIT, bonus will be omitted by default
  397. TLimiterPtr limiter;
  398. TPropagatorPtr propagator;
  399. TUpdaterPtr updater;
  400. TUpdaterPtr propagationUpdater;
  401. std::string description;
  402. Bonus(BonusDuration Duration, BonusType Type, BonusSource Src, si32 Val, ui32 ID, std::string Desc, si32 Subtype=-1);
  403. Bonus(BonusDuration Duration, BonusType Type, BonusSource Src, si32 Val, ui32 ID, si32 Subtype=-1, ValueType ValType = ADDITIVE_VALUE);
  404. Bonus();
  405. template <typename Handler> void serialize(Handler &h, const int version)
  406. {
  407. h & duration;
  408. h & type;
  409. h & subtype;
  410. h & source;
  411. h & val;
  412. h & sid;
  413. h & description;
  414. h & additionalInfo;
  415. h & turnsRemain;
  416. h & valType;
  417. h & stacking;
  418. h & effectRange;
  419. h & limiter;
  420. h & propagator;
  421. h & updater;
  422. h & propagationUpdater;
  423. h & targetSourceType;
  424. }
  425. template <typename Ptr>
  426. static bool compareByAdditionalInfo(const Ptr& a, const Ptr& b)
  427. {
  428. return a->additionalInfo < b->additionalInfo;
  429. }
  430. static bool NDays(const Bonus *hb)
  431. {
  432. return hb->duration & Bonus::N_DAYS;
  433. }
  434. static bool NTurns(const Bonus *hb)
  435. {
  436. return hb->duration & Bonus::N_TURNS;
  437. }
  438. static bool OneDay(const Bonus *hb)
  439. {
  440. return hb->duration & Bonus::ONE_DAY;
  441. }
  442. static bool OneWeek(const Bonus *hb)
  443. {
  444. return hb->duration & Bonus::ONE_WEEK;
  445. }
  446. static bool OneBattle(const Bonus *hb)
  447. {
  448. return hb->duration & Bonus::ONE_BATTLE;
  449. }
  450. static bool Permanent(const Bonus *hb)
  451. {
  452. return hb->duration & Bonus::PERMANENT;
  453. }
  454. static bool UntilGetsTurn(const Bonus *hb)
  455. {
  456. return hb->duration & Bonus::STACK_GETS_TURN;
  457. }
  458. static bool UntilAttack(const Bonus *hb)
  459. {
  460. return hb->duration & Bonus::UNTIL_ATTACK;
  461. }
  462. static bool UntilBeingAttacked(const Bonus *hb)
  463. {
  464. return hb->duration & Bonus::UNTIL_BEING_ATTACKED;
  465. }
  466. static bool UntilCommanderKilled(const Bonus *hb)
  467. {
  468. return hb->duration & Bonus::COMMANDER_KILLED;
  469. }
  470. inline bool operator == (const BonusType & cf) const
  471. {
  472. return type == cf;
  473. }
  474. inline void operator += (const ui32 Val) //no return
  475. {
  476. val += Val;
  477. }
  478. STRONG_INLINE static ui32 getSid32(ui32 high, ui32 low)
  479. {
  480. return (high << 16) + low;
  481. }
  482. std::string Description(boost::optional<si32> customValue = {}) const;
  483. JsonNode toJsonNode() const;
  484. std::string nameForBonus() const; // generate suitable name for bonus - e.g. for storing in json struct
  485. std::shared_ptr<Bonus> addLimiter(TLimiterPtr Limiter); //returns this for convenient chain-calls
  486. std::shared_ptr<Bonus> addPropagator(TPropagatorPtr Propagator); //returns this for convenient chain-calls
  487. std::shared_ptr<Bonus> addUpdater(TUpdaterPtr Updater); //returns this for convenient chain-calls
  488. void updateOppositeBonuses();
  489. };
  490. DLL_LINKAGE std::ostream & operator<<(std::ostream &out, const Bonus &bonus);
  491. class DLL_LINKAGE BonusList
  492. {
  493. public:
  494. typedef std::vector<std::shared_ptr<Bonus>> TInternalContainer;
  495. private:
  496. TInternalContainer bonuses;
  497. bool belongsToTree;
  498. void changed();
  499. public:
  500. typedef TInternalContainer::const_reference const_reference;
  501. typedef TInternalContainer::value_type value_type;
  502. typedef TInternalContainer::const_iterator const_iterator;
  503. typedef TInternalContainer::iterator iterator;
  504. BonusList(bool BelongsToTree = false);
  505. BonusList(const BonusList &bonusList);
  506. BonusList(BonusList && other);
  507. BonusList& operator=(const BonusList &bonusList);
  508. // wrapper functions of the STL vector container
  509. TInternalContainer::size_type size() const { return bonuses.size(); }
  510. void push_back(std::shared_ptr<Bonus> x);
  511. TInternalContainer::iterator erase (const int position);
  512. void clear();
  513. bool empty() const { return bonuses.empty(); }
  514. void resize(TInternalContainer::size_type sz, std::shared_ptr<Bonus> c = nullptr );
  515. void reserve(TInternalContainer::size_type sz);
  516. TInternalContainer::size_type capacity() const { return bonuses.capacity(); }
  517. STRONG_INLINE std::shared_ptr<Bonus> &operator[] (TInternalContainer::size_type n) { return bonuses[n]; }
  518. STRONG_INLINE const std::shared_ptr<Bonus> &operator[] (TInternalContainer::size_type n) const { return bonuses[n]; }
  519. std::shared_ptr<Bonus> &back() { return bonuses.back(); }
  520. std::shared_ptr<Bonus> &front() { return bonuses.front(); }
  521. const std::shared_ptr<Bonus> &back() const { return bonuses.back(); }
  522. const std::shared_ptr<Bonus> &front() const { return bonuses.front(); }
  523. // There should be no non-const access to provide solid,robust bonus caching
  524. TInternalContainer::const_iterator begin() const { return bonuses.begin(); }
  525. TInternalContainer::const_iterator end() const { return bonuses.end(); }
  526. TInternalContainer::size_type operator-=(std::shared_ptr<Bonus> const &i);
  527. // BonusList functions
  528. void stackBonuses();
  529. int totalValue() const;
  530. void getBonuses(BonusList &out, const CSelector &selector, const CSelector &limit) const;
  531. void getAllBonuses(BonusList &out) const;
  532. void getBonuses(BonusList & out, const CSelector &selector) const;
  533. //special find functions
  534. std::shared_ptr<Bonus> getFirst(const CSelector &select);
  535. std::shared_ptr<const Bonus> getFirst(const CSelector &select) const;
  536. int valOfBonuses(const CSelector &select) const;
  537. // conversion / output
  538. JsonNode toJsonNode() const;
  539. // remove_if implementation for STL vector types
  540. template <class Predicate>
  541. void remove_if(Predicate pred)
  542. {
  543. BonusList newList;
  544. for (ui32 i = 0; i < bonuses.size(); i++)
  545. {
  546. auto b = bonuses[i];
  547. if (!pred(b.get()))
  548. newList.push_back(b);
  549. }
  550. bonuses.clear();
  551. bonuses.resize(newList.size());
  552. std::copy(newList.begin(), newList.end(), bonuses.begin());
  553. }
  554. template <class InputIterator>
  555. void insert(const int position, InputIterator first, InputIterator last);
  556. void insert(TInternalContainer::iterator position, TInternalContainer::size_type n, std::shared_ptr<Bonus> const &x);
  557. template <typename Handler>
  558. void serialize(Handler &h, const int version)
  559. {
  560. h & static_cast<TInternalContainer&>(bonuses);
  561. }
  562. // C++ for range support
  563. auto begin () -> decltype (bonuses.begin())
  564. {
  565. return bonuses.begin();
  566. }
  567. auto end () -> decltype (bonuses.end())
  568. {
  569. return bonuses.end();
  570. }
  571. };
  572. // Extensions for BOOST_FOREACH to enable iterating of BonusList objects
  573. // Don't touch/call this functions
  574. inline BonusList::iterator range_begin(BonusList & x)
  575. {
  576. return x.begin();
  577. }
  578. inline BonusList::iterator range_end(BonusList & x)
  579. {
  580. return x.end();
  581. }
  582. inline BonusList::const_iterator range_begin(BonusList const &x)
  583. {
  584. return x.begin();
  585. }
  586. inline BonusList::const_iterator range_end(BonusList const &x)
  587. {
  588. return x.end();
  589. }
  590. DLL_LINKAGE std::ostream & operator<<(std::ostream &out, const BonusList &bonusList);
  591. struct BonusLimitationContext
  592. {
  593. std::shared_ptr<const Bonus> b;
  594. const CBonusSystemNode & node;
  595. const BonusList & alreadyAccepted;
  596. const BonusList & stillUndecided;
  597. };
  598. class DLL_LINKAGE ILimiter
  599. {
  600. public:
  601. enum EDecision {ACCEPT, DISCARD, NOT_SURE};
  602. virtual ~ILimiter();
  603. virtual int limit(const BonusLimitationContext &context) const; //0 - accept bonus; 1 - drop bonus; 2 - delay (drops eventually)
  604. virtual std::string toString() const;
  605. virtual JsonNode toJsonNode() const;
  606. template <typename Handler> void serialize(Handler &h, const int version)
  607. {
  608. }
  609. };
  610. class DLL_LINKAGE IBonusBearer
  611. {
  612. private:
  613. static CSelector anaffectedByMoraleSelector;
  614. CCheckProxy anaffectedByMorale;
  615. static CSelector moraleSelector;
  616. CTotalsProxy moraleValue;
  617. static CSelector luckSelector;
  618. CTotalsProxy luckValue;
  619. static CSelector selfMoraleSelector;
  620. CCheckProxy selfMorale;
  621. static CSelector selfLuckSelector;
  622. CCheckProxy selfLuck;
  623. public:
  624. //new bonusing node interface
  625. // * selector is predicate that tests if HeroBonus matches our criteria
  626. // * root is node on which call was made (nullptr will be replaced with this)
  627. //interface
  628. IBonusBearer();
  629. virtual ~IBonusBearer() = default;
  630. virtual TConstBonusListPtr getAllBonuses(const CSelector &selector, const CSelector &limit, const CBonusSystemNode *root = nullptr, const std::string &cachingStr = "") const = 0;
  631. int valOfBonuses(const CSelector &selector, const std::string &cachingStr = "") const;
  632. bool hasBonus(const CSelector &selector, const std::string &cachingStr = "") const;
  633. bool hasBonus(const CSelector &selector, const CSelector &limit, const std::string &cachingStr = "") const;
  634. TConstBonusListPtr getBonuses(const CSelector &selector, const CSelector &limit, const std::string &cachingStr = "") const;
  635. TConstBonusListPtr getBonuses(const CSelector &selector, const std::string &cachingStr = "") const;
  636. std::shared_ptr<const Bonus> getBonus(const CSelector &selector) const; //returns any bonus visible on node that matches (or nullptr if none matches)
  637. //legacy interface
  638. int valOfBonuses(Bonus::BonusType type, const CSelector &selector) const;
  639. int valOfBonuses(Bonus::BonusType type, int subtype = -1) const; //subtype -> subtype of bonus, if -1 then anyt;
  640. bool hasBonusOfType(Bonus::BonusType type, int subtype = -1) const;//determines if hero has a bonus of given type (and optionally subtype)
  641. bool hasBonusFrom(Bonus::BonusSource source, ui32 sourceID) const;
  642. //various hlp functions for non-trivial values
  643. //used for stacks and creatures only
  644. virtual int getMinDamage(bool ranged) const;
  645. virtual int getMaxDamage(bool ranged) const;
  646. virtual int getAttack(bool ranged) const;
  647. virtual int getDefense(bool ranged) const;
  648. int MoraleVal() const; //range [-3, +3]
  649. int LuckVal() const; //range [-3, +3]
  650. /**
  651. Returns total value of all morale bonuses and sets bonusList as a pointer to the list of selected bonuses.
  652. @param bonusList is the out param it's list of all selected bonuses
  653. @return total value of all morale in the range [-3, +3] and 0 otherwise
  654. */
  655. int MoraleValAndBonusList(TConstBonusListPtr & bonusList) const;
  656. int LuckValAndBonusList(TConstBonusListPtr & bonusList) const;
  657. ui32 MaxHealth() const; //get max HP of stack with all modifiers
  658. bool isLiving() const; //non-undead, non-non living or alive
  659. virtual si32 magicResistance() const;
  660. ui32 Speed(int turn = 0, bool useBind = false) const; //get speed of creature with all modificators
  661. si32 manaLimit() const; //maximum mana value for this hero (basically 10*knowledge)
  662. int getPrimSkillLevel(PrimarySkill::PrimarySkill id) const;
  663. virtual int64_t getTreeVersion() const = 0;
  664. };
  665. class DLL_LINKAGE CBonusSystemNode : public virtual IBonusBearer, public boost::noncopyable
  666. {
  667. public:
  668. enum ENodeTypes
  669. {
  670. NONE = -1,
  671. UNKNOWN, STACK_INSTANCE, STACK_BATTLE, SPECIALTY, ARTIFACT, CREATURE, ARTIFACT_INSTANCE, HERO, PLAYER, TEAM,
  672. TOWN_AND_VISITOR, BATTLE, COMMANDER, GLOBAL_EFFECTS, ALL_CREATURES, TOWN
  673. };
  674. private:
  675. BonusList bonuses; //wielded bonuses (local or up-propagated here)
  676. BonusList exportedBonuses; //bonuses coming from this node (wielded or propagated away)
  677. TNodesVector parents; //parents -> we inherit bonuses from them, we may attach our bonuses to them
  678. TNodesVector children;
  679. ENodeTypes nodeType;
  680. std::string description;
  681. bool isHypotheticNode;
  682. static const bool cachingEnabled;
  683. mutable BonusList cachedBonuses;
  684. mutable int64_t cachedLast;
  685. static std::atomic<int32_t> treeChanged;
  686. // Setting a value to cachingStr before getting any bonuses caches the result for later requests.
  687. // This string needs to be unique, that's why it has to be setted in the following manner:
  688. // [property key]_[value] => only for selector
  689. mutable std::map<std::string, TBonusListPtr > cachedRequests;
  690. mutable boost::mutex sync;
  691. void getAllBonusesRec(BonusList &out) const;
  692. TConstBonusListPtr getAllBonusesWithoutCaching(const CSelector &selector, const CSelector &limit, const CBonusSystemNode *root = nullptr) const;
  693. std::shared_ptr<Bonus> getUpdatedBonus(const std::shared_ptr<Bonus> & b, const TUpdaterPtr updater) const;
  694. public:
  695. explicit CBonusSystemNode();
  696. explicit CBonusSystemNode(bool isHypotetic);
  697. explicit CBonusSystemNode(ENodeTypes NodeType);
  698. CBonusSystemNode(CBonusSystemNode && other);
  699. virtual ~CBonusSystemNode();
  700. void limitBonuses(const BonusList &allBonuses, BonusList &out) const; //out will bo populed with bonuses that are not limited here
  701. TBonusListPtr limitBonuses(const BonusList &allBonuses) const; //same as above, returns out by val for convienence
  702. TConstBonusListPtr getAllBonuses(const CSelector &selector, const CSelector &limit, const CBonusSystemNode *root = nullptr, const std::string &cachingStr = "") const override;
  703. void getParents(TCNodes &out) const; //retrieves list of parent nodes (nodes to inherit bonuses from),
  704. std::shared_ptr<const Bonus> getBonusLocalFirst(const CSelector & selector) const;
  705. //non-const interface
  706. void getParents(TNodes &out); //retrieves list of parent nodes (nodes to inherit bonuses from)
  707. void getRedParents(TNodes &out); //retrieves list of red parent nodes (nodes bonuses propagate from)
  708. void getRedAncestors(TNodes &out);
  709. void getRedChildren(TNodes &out);
  710. void getRedDescendants(TNodes &out);
  711. void getAllParents(TCNodes & out) const;
  712. static PlayerColor retrieveNodeOwner(const CBonusSystemNode * node);
  713. std::shared_ptr<Bonus> getBonusLocalFirst(const CSelector & selector);
  714. void attachTo(CBonusSystemNode & parent);
  715. void detachFrom(CBonusSystemNode & parent);
  716. void detachFromAll();
  717. virtual void addNewBonus(const std::shared_ptr<Bonus>& b);
  718. void accumulateBonus(const std::shared_ptr<Bonus>& b); //add value of bonus with same type/subtype or create new
  719. void newChildAttached(CBonusSystemNode & child);
  720. void childDetached(CBonusSystemNode & child);
  721. void propagateBonus(std::shared_ptr<Bonus> b, const CBonusSystemNode & source);
  722. void unpropagateBonus(std::shared_ptr<Bonus> b);
  723. void removeBonus(const std::shared_ptr<Bonus>& b);
  724. void removeBonuses(const CSelector & selector);
  725. void removeBonusesRecursive(const CSelector & s);
  726. void newRedDescendant(CBonusSystemNode & descendant); //propagation needed
  727. void removedRedDescendant(CBonusSystemNode & descendant); //de-propagation needed
  728. bool isIndependentNode() const; //node is independent when it has no parents nor children
  729. bool actsAsBonusSourceOnly() const;
  730. ///updates count of remaining turns and removes outdated bonuses by selector
  731. void reduceBonusDurations(const CSelector &s);
  732. virtual std::string bonusToString(const std::shared_ptr<Bonus>& bonus, bool description) const {return "";}; //description or bonus name
  733. virtual std::string nodeName() const;
  734. virtual std::string nodeShortInfo() const;
  735. bool isHypothetic() const { return isHypotheticNode; }
  736. void deserializationFix();
  737. void exportBonus(std::shared_ptr<Bonus> b);
  738. void exportBonuses();
  739. const BonusList &getBonusList() const;
  740. BonusList & getExportedBonusList();
  741. const BonusList & getExportedBonusList() const;
  742. CBonusSystemNode::ENodeTypes getNodeType() const;
  743. void setNodeType(CBonusSystemNode::ENodeTypes type);
  744. const TNodesVector &getParentNodes() const;
  745. const TNodesVector &getChildrenNodes() const;
  746. const std::string &getDescription() const;
  747. void setDescription(const std::string &description);
  748. static void treeHasChanged();
  749. int64_t getTreeVersion() const override;
  750. virtual PlayerColor getOwner() const
  751. {
  752. return PlayerColor::NEUTRAL;
  753. }
  754. template <typename Handler> void serialize(Handler &h, const int version)
  755. {
  756. // h & bonuses;
  757. h & nodeType;
  758. h & exportedBonuses;
  759. h & description;
  760. BONUS_TREE_DESERIALIZATION_FIX
  761. //h & parents & children;
  762. }
  763. friend class CBonusProxy;
  764. };
  765. class DLL_LINKAGE IPropagator
  766. {
  767. public:
  768. virtual ~IPropagator();
  769. virtual bool shouldBeAttached(CBonusSystemNode *dest);
  770. virtual CBonusSystemNode::ENodeTypes getPropagatorType() const;
  771. template <typename Handler> void serialize(Handler &h, const int version)
  772. {}
  773. };
  774. class DLL_LINKAGE CPropagatorNodeType : public IPropagator
  775. {
  776. CBonusSystemNode::ENodeTypes nodeType;
  777. public:
  778. CPropagatorNodeType();
  779. CPropagatorNodeType(CBonusSystemNode::ENodeTypes NodeType);
  780. bool shouldBeAttached(CBonusSystemNode *dest) override;
  781. CBonusSystemNode::ENodeTypes getPropagatorType() const override;
  782. template <typename Handler> void serialize(Handler &h, const int version)
  783. {
  784. h & nodeType;
  785. }
  786. };
  787. namespace NBonus
  788. {
  789. //set of methods that may be safely called with nullptr objs
  790. DLL_LINKAGE int valOf(const CBonusSystemNode *obj, Bonus::BonusType type, int subtype = -1); //subtype -> subtype of bonus, if -1 then any
  791. DLL_LINKAGE bool hasOfType(const CBonusSystemNode *obj, Bonus::BonusType type, int subtype = -1);//determines if hero has a bonus of given type (and optionally subtype)
  792. }
  793. template<typename T>
  794. class CSelectFieldEqual
  795. {
  796. T Bonus::*ptr;
  797. public:
  798. CSelectFieldEqual(T Bonus::*Ptr)
  799. : ptr(Ptr)
  800. {
  801. }
  802. CSelector operator()(const T &valueToCompareAgainst) const
  803. {
  804. auto ptr2 = ptr; //We need a COPY because we don't want to reference this (might be outlived by lambda)
  805. return [ptr2, valueToCompareAgainst](const Bonus *bonus)
  806. {
  807. return bonus->*ptr2 == valueToCompareAgainst;
  808. };
  809. }
  810. };
  811. template<typename T> //can be same, needed for subtype field
  812. class CSelectFieldEqualOrEvery
  813. {
  814. T Bonus::*ptr;
  815. T val;
  816. public:
  817. CSelectFieldEqualOrEvery(T Bonus::*Ptr, const T &Val)
  818. : ptr(Ptr), val(Val)
  819. {
  820. }
  821. bool operator()(const Bonus *bonus) const
  822. {
  823. return (bonus->*ptr == val) || (bonus->*ptr == static_cast<T>(Bonus::EVERY_TYPE));
  824. }
  825. CSelectFieldEqualOrEvery& operator()(const T &setVal)
  826. {
  827. val = setVal;
  828. return *this;
  829. }
  830. };
  831. class DLL_LINKAGE CWillLastTurns
  832. {
  833. public:
  834. int turnsRequested;
  835. bool operator()(const Bonus *bonus) const
  836. {
  837. return turnsRequested <= 0 //every present effect will last zero (or "less") turns
  838. || !Bonus::NTurns(bonus) //so do every not expriing after N-turns effect
  839. || bonus->turnsRemain > turnsRequested;
  840. }
  841. CWillLastTurns& operator()(const int &setVal)
  842. {
  843. turnsRequested = setVal;
  844. return *this;
  845. }
  846. };
  847. class DLL_LINKAGE CWillLastDays
  848. {
  849. public:
  850. int daysRequested;
  851. bool operator()(const Bonus *bonus) const
  852. {
  853. if(daysRequested <= 0 || Bonus::Permanent(bonus) || Bonus::OneBattle(bonus))
  854. return true;
  855. else if(Bonus::OneDay(bonus))
  856. return false;
  857. else if(Bonus::NDays(bonus) || Bonus::OneWeek(bonus))
  858. {
  859. return bonus->turnsRemain > daysRequested;
  860. }
  861. return false; // TODO: ONE_WEEK need support for turnsRemain, but for now we'll exclude all unhandled durations
  862. }
  863. CWillLastDays& operator()(const int &setVal)
  864. {
  865. daysRequested = setVal;
  866. return *this;
  867. }
  868. };
  869. class DLL_LINKAGE AggregateLimiter : public ILimiter
  870. {
  871. protected:
  872. std::vector<TLimiterPtr> limiters;
  873. virtual const std::string & getAggregator() const = 0;
  874. public:
  875. void add(TLimiterPtr limiter);
  876. JsonNode toJsonNode() const override;
  877. template <typename Handler> void serialize(Handler & h, const int version)
  878. {
  879. h & static_cast<ILimiter&>(*this);
  880. h & limiters;
  881. }
  882. };
  883. class DLL_LINKAGE AllOfLimiter : public AggregateLimiter
  884. {
  885. protected:
  886. const std::string & getAggregator() const override;
  887. public:
  888. static const std::string aggregator;
  889. int limit(const BonusLimitationContext & context) const override;
  890. };
  891. class DLL_LINKAGE AnyOfLimiter : public AggregateLimiter
  892. {
  893. protected:
  894. const std::string & getAggregator() const override;
  895. public:
  896. static const std::string aggregator;
  897. int limit(const BonusLimitationContext & context) const override;
  898. };
  899. class DLL_LINKAGE NoneOfLimiter : public AggregateLimiter
  900. {
  901. protected:
  902. const std::string & getAggregator() const override;
  903. public:
  904. static const std::string aggregator;
  905. int limit(const BonusLimitationContext & context) const override;
  906. };
  907. class DLL_LINKAGE CCreatureTypeLimiter : public ILimiter //affect only stacks of given creature (and optionally it's upgrades)
  908. {
  909. public:
  910. const CCreature *creature;
  911. bool includeUpgrades;
  912. CCreatureTypeLimiter();
  913. CCreatureTypeLimiter(const CCreature & creature_, bool IncludeUpgrades = true);
  914. void setCreature (CreatureID id);
  915. int limit(const BonusLimitationContext &context) const override;
  916. virtual std::string toString() const override;
  917. virtual JsonNode toJsonNode() const override;
  918. template <typename Handler> void serialize(Handler &h, const int version)
  919. {
  920. h & static_cast<ILimiter&>(*this);
  921. h & creature;
  922. h & includeUpgrades;
  923. }
  924. };
  925. class DLL_LINKAGE HasAnotherBonusLimiter : public ILimiter //applies only to nodes that have another bonus working
  926. {
  927. public:
  928. Bonus::BonusType type;
  929. TBonusSubtype subtype;
  930. Bonus::BonusSource source;
  931. si32 sid;
  932. bool isSubtypeRelevant; //check for subtype only if this is true
  933. bool isSourceRelevant; //check for bonus source only if this is true
  934. bool isSourceIDRelevant; //check for bonus source only if this is true
  935. HasAnotherBonusLimiter(Bonus::BonusType bonus = Bonus::NONE);
  936. HasAnotherBonusLimiter(Bonus::BonusType bonus, TBonusSubtype _subtype);
  937. HasAnotherBonusLimiter(Bonus::BonusType bonus, Bonus::BonusSource src);
  938. HasAnotherBonusLimiter(Bonus::BonusType bonus, TBonusSubtype _subtype, Bonus::BonusSource src);
  939. int limit(const BonusLimitationContext &context) const override;
  940. virtual std::string toString() const override;
  941. virtual JsonNode toJsonNode() const override;
  942. template <typename Handler> void serialize(Handler &h, const int version)
  943. {
  944. h & static_cast<ILimiter&>(*this);
  945. h & type;
  946. h & subtype;
  947. h & isSubtypeRelevant;
  948. h & source;
  949. h & isSourceRelevant;
  950. h & sid;
  951. h & isSourceIDRelevant;
  952. }
  953. };
  954. class DLL_LINKAGE CreatureTerrainLimiter : public ILimiter //applies only to creatures that are on specified terrain, default native terrain
  955. {
  956. public:
  957. TerrainId terrainType;
  958. CreatureTerrainLimiter();
  959. CreatureTerrainLimiter(TerrainId terrain);
  960. int limit(const BonusLimitationContext &context) const override;
  961. virtual std::string toString() const override;
  962. virtual JsonNode toJsonNode() const override;
  963. template <typename Handler> void serialize(Handler &h, const int version)
  964. {
  965. h & static_cast<ILimiter&>(*this);
  966. h & terrainType;
  967. }
  968. };
  969. class DLL_LINKAGE CreatureFactionLimiter : public ILimiter //applies only to creatures of given faction
  970. {
  971. public:
  972. TFaction faction;
  973. CreatureFactionLimiter();
  974. CreatureFactionLimiter(TFaction faction);
  975. int limit(const BonusLimitationContext &context) const override;
  976. virtual std::string toString() const override;
  977. virtual JsonNode toJsonNode() const override;
  978. template <typename Handler> void serialize(Handler &h, const int version)
  979. {
  980. h & static_cast<ILimiter&>(*this);
  981. h & faction;
  982. }
  983. };
  984. class DLL_LINKAGE CreatureAlignmentLimiter : public ILimiter //applies only to creatures of given alignment
  985. {
  986. public:
  987. si8 alignment;
  988. CreatureAlignmentLimiter();
  989. CreatureAlignmentLimiter(si8 Alignment);
  990. int limit(const BonusLimitationContext &context) const override;
  991. virtual std::string toString() const override;
  992. virtual JsonNode toJsonNode() const override;
  993. template <typename Handler> void serialize(Handler &h, const int version)
  994. {
  995. h & static_cast<ILimiter&>(*this);
  996. h & alignment;
  997. }
  998. };
  999. class DLL_LINKAGE StackOwnerLimiter : public ILimiter //applies only to creatures of given alignment
  1000. {
  1001. public:
  1002. PlayerColor owner;
  1003. StackOwnerLimiter();
  1004. StackOwnerLimiter(PlayerColor Owner);
  1005. int limit(const BonusLimitationContext &context) const override;
  1006. template <typename Handler> void serialize(Handler &h, const int version)
  1007. {
  1008. h & static_cast<ILimiter&>(*this);
  1009. h & owner;
  1010. }
  1011. };
  1012. class DLL_LINKAGE OppositeSideLimiter : public ILimiter //applies only to creatures of enemy army during combat
  1013. {
  1014. public:
  1015. PlayerColor owner;
  1016. OppositeSideLimiter();
  1017. OppositeSideLimiter(PlayerColor Owner);
  1018. int limit(const BonusLimitationContext &context) const override;
  1019. template <typename Handler> void serialize(Handler &h, const int version)
  1020. {
  1021. h & static_cast<ILimiter&>(*this);
  1022. h & owner;
  1023. }
  1024. };
  1025. class DLL_LINKAGE RankRangeLimiter : public ILimiter //applies to creatures with min <= Rank <= max
  1026. {
  1027. public:
  1028. ui8 minRank, maxRank;
  1029. RankRangeLimiter();
  1030. RankRangeLimiter(ui8 Min, ui8 Max = 255);
  1031. int limit(const BonusLimitationContext &context) const override;
  1032. template <typename Handler> void serialize(Handler &h, const int version)
  1033. {
  1034. h & static_cast<ILimiter&>(*this);
  1035. h & minRank;
  1036. h & maxRank;
  1037. }
  1038. };
  1039. namespace Selector
  1040. {
  1041. extern DLL_LINKAGE CSelectFieldEqual<Bonus::BonusType> & type();
  1042. extern DLL_LINKAGE CSelectFieldEqual<TBonusSubtype> & subtype();
  1043. extern DLL_LINKAGE CSelectFieldEqual<CAddInfo> & info();
  1044. extern DLL_LINKAGE CSelectFieldEqual<Bonus::BonusSource> & sourceType();
  1045. extern DLL_LINKAGE CSelectFieldEqual<Bonus::BonusSource> & targetSourceType();
  1046. extern DLL_LINKAGE CSelectFieldEqual<Bonus::LimitEffect> & effectRange();
  1047. extern DLL_LINKAGE CWillLastTurns turns;
  1048. extern DLL_LINKAGE CWillLastDays days;
  1049. CSelector DLL_LINKAGE typeSubtype(Bonus::BonusType Type, TBonusSubtype Subtype);
  1050. CSelector DLL_LINKAGE typeSubtypeInfo(Bonus::BonusType type, TBonusSubtype subtype, CAddInfo info);
  1051. CSelector DLL_LINKAGE source(Bonus::BonusSource source, ui32 sourceID);
  1052. CSelector DLL_LINKAGE sourceTypeSel(Bonus::BonusSource source);
  1053. CSelector DLL_LINKAGE valueType(Bonus::ValueType valType);
  1054. /**
  1055. * Selects all bonuses
  1056. * Usage example: Selector::all.And(<functor>).And(<functor>)...)
  1057. */
  1058. extern DLL_LINKAGE CSelector all;
  1059. /**
  1060. * Selects nothing
  1061. * Usage example: Selector::none.Or(<functor>).Or(<functor>)...)
  1062. */
  1063. extern DLL_LINKAGE CSelector none;
  1064. bool DLL_LINKAGE matchesType(const CSelector &sel, Bonus::BonusType type);
  1065. bool DLL_LINKAGE matchesTypeSubtype(const CSelector &sel, Bonus::BonusType type, TBonusSubtype subtype);
  1066. }
  1067. extern DLL_LINKAGE const std::map<std::string, Bonus::BonusType> bonusNameMap;
  1068. extern DLL_LINKAGE const std::map<std::string, Bonus::ValueType> bonusValueMap;
  1069. extern DLL_LINKAGE const std::map<std::string, Bonus::BonusSource> bonusSourceMap;
  1070. extern DLL_LINKAGE const std::map<std::string, ui16> bonusDurationMap;
  1071. extern DLL_LINKAGE const std::map<std::string, Bonus::LimitEffect> bonusLimitEffect;
  1072. extern DLL_LINKAGE const std::map<std::string, TLimiterPtr> bonusLimiterMap;
  1073. extern DLL_LINKAGE const std::map<std::string, TPropagatorPtr> bonusPropagatorMap;
  1074. extern DLL_LINKAGE const std::map<std::string, TUpdaterPtr> bonusUpdaterMap;
  1075. // BonusList template that requires full interface of CBonusSystemNode
  1076. template <class InputIterator>
  1077. void BonusList::insert(const int position, InputIterator first, InputIterator last)
  1078. {
  1079. bonuses.insert(bonuses.begin() + position, first, last);
  1080. changed();
  1081. }
  1082. // observers for updating bonuses based on certain events (e.g. hero gaining level)
  1083. class DLL_LINKAGE IUpdater
  1084. {
  1085. public:
  1086. virtual ~IUpdater();
  1087. virtual std::shared_ptr<Bonus> createUpdatedBonus(const std::shared_ptr<Bonus> & b, const CBonusSystemNode & context) const;
  1088. virtual std::string toString() const;
  1089. virtual JsonNode toJsonNode() const;
  1090. template <typename Handler> void serialize(Handler & h, const int version)
  1091. {
  1092. }
  1093. };
  1094. class DLL_LINKAGE GrowsWithLevelUpdater : public IUpdater
  1095. {
  1096. public:
  1097. int valPer20;
  1098. int stepSize;
  1099. GrowsWithLevelUpdater();
  1100. GrowsWithLevelUpdater(int valPer20, int stepSize = 1);
  1101. template <typename Handler> void serialize(Handler & h, const int version)
  1102. {
  1103. h & static_cast<IUpdater &>(*this);
  1104. h & valPer20;
  1105. h & stepSize;
  1106. }
  1107. std::shared_ptr<Bonus> createUpdatedBonus(const std::shared_ptr<Bonus> & b, const CBonusSystemNode & context) const override;
  1108. virtual std::string toString() const override;
  1109. virtual JsonNode toJsonNode() const override;
  1110. };
  1111. class DLL_LINKAGE TimesHeroLevelUpdater : public IUpdater
  1112. {
  1113. public:
  1114. TimesHeroLevelUpdater();
  1115. template <typename Handler> void serialize(Handler & h, const int version)
  1116. {
  1117. h & static_cast<IUpdater &>(*this);
  1118. }
  1119. std::shared_ptr<Bonus> createUpdatedBonus(const std::shared_ptr<Bonus> & b, const CBonusSystemNode & context) const override;
  1120. virtual std::string toString() const override;
  1121. virtual JsonNode toJsonNode() const override;
  1122. };
  1123. class DLL_LINKAGE TimesStackLevelUpdater : public IUpdater
  1124. {
  1125. public:
  1126. TimesStackLevelUpdater();
  1127. template <typename Handler> void serialize(Handler & h, const int version)
  1128. {
  1129. h & static_cast<IUpdater &>(*this);
  1130. }
  1131. std::shared_ptr<Bonus> createUpdatedBonus(const std::shared_ptr<Bonus> & b, const CBonusSystemNode & context) const override;
  1132. virtual std::string toString() const override;
  1133. virtual JsonNode toJsonNode() const override;
  1134. };
  1135. class DLL_LINKAGE OwnerUpdater : public IUpdater
  1136. {
  1137. public:
  1138. OwnerUpdater();
  1139. template <typename Handler> void serialize(Handler& h, const int version)
  1140. {
  1141. h & static_cast<IUpdater &>(*this);
  1142. }
  1143. std::shared_ptr<Bonus> createUpdatedBonus(const std::shared_ptr<Bonus>& b, const CBonusSystemNode& context) const override;
  1144. virtual std::string toString() const override;
  1145. virtual JsonNode toJsonNode() const override;
  1146. };
  1147. VCMI_LIB_NAMESPACE_END