HeroBonus.h 52 KB

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