R2API RecalculateStats
API for manipulating Character Stats
About this mod Author’s original text
R2API.RecalculateStats - Global solution for manipulating Character Stats.
About
R2API.RecalculateStats is a submodule assembly for R2API that allows mod creators to finely tune stat changes for Characters ingame
It is intended to be a global solution for mods in general.
Use Cases / Features
R2API.RecalculateStats works via the GetStatCoefficients event, which allows a mod creator to run logic and modify the incoming stat changes for a Character.
These stat changes are represented in the StatHookEventArgs, which includes arguments for modifying a variety of stats, these include:
- Max Health
- Health Regeneration
- Movement Speed
- Jump Power
- Jump Count
- Damage
- Attack Speed
- Critical Strike Chance
- Armor
- Curse
- Cooldown reduction for skills
- Shield
- Critical Strike Damage
- Luck
- Barrier Decay Rate
- Barrer Decay Freeze
Related Pages
Changelog
1.6.6
- Fixed barrier decay freeze stat failing to freeze barrier decay
- Flat cooldown reduction stat can now be negative (increasing cooldowns by a flat amount)
1.6.5
- Fixed luck and barrier stat hooks for Alloyed Collective
1.6.4
- Skill slot stats are now handled by SkillSlotStatModifiers:
- Split into primarySkill/secondarySkill/utilitySkill/specialSkill/allSkills for stat manipulation to apply to specific slots or all slots simultaneously.
- Added cooldownReductionMultAdd, and cooldownMultiplier stats for better modification of skill cooldowns.
- Added bonusStockAdd for adding charges to skills.
1.6.3
- Improved reliability of luck stat hooks
1.6.2
- Added support for fractional/non-integer luck values
- Added luckAdd stat for increasing and decreasing luck
- Added shouldFreezeBarrier, barrierDecayAdd, and barrierDecayMult stats for modifying barrier decay rate
- Improved reliability of jump stat hook
1.6.1
- Added stats: jumpCountAdd and jumpCountMult.
1.6.0
- Added multiplicative stat modifiers healthTotalMult, shieldTotalMult, regenTotalMult, moveSpeedTotalMult, jumpPowerTotalMult, damageTotalMult attackSpeedTotalMult, critMult, bleedChanceMult, armorMult, and curseTotalMult.
'1.5.0'
- Added bleedChanceAdd.
'1.4.0'
- Initial fixes for SOTS DLC2 Release.
'1.3.0'
- Added stats: levelHealthAdd, levelShieldAdd, levelRegenAdd, levelMoveSpeedAdd, levelJumpPowerAdd, levelDamageAdd, levelAttackSpeedAdd, levelCritAdd, and levelArmorAdd to scale stat bonuses with character level.
'1.2.0'
- Added levelFlatAdd stat for changing effective level additively.
- Added sprintSpeedAdd stat for changing sprint speed multiplier.
'1.1.0'
- Added attackSpeedReductionMultAdd stat for reducing attack speed.
'1.0.0'
- Split from the main R2API.dll into its own submodule.
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: