VinesTweaks

Adds configurable artifacts and gameplay tweaks for Risk of Rain 2.

Version 0.4.0 has been human playtested and fixes a few bugs found during local playtesting.

G-Chicken Booster

This is a white-tier damage item.

• Gain 8% critical strike chance by default, plus 5% per additional stack.
• Critical strikes deal 6% more damage by default, plus 5% per additional stack.
• Crit damage is added to the crit multiplier, so one stack makes normal 200% crits deal 206% damage.
• Flavor text: "Clinically untested. Emotionally convincing."
• VinesTweaks items can be enabled or disabled through Risk of Options.
• All G-Chicken Booster values are configurable through Risk of Options.

Note: changing the global item toggle during a run disables item effects immediately, but fully adding or removing VinesTweaks items from item drop pools requires a game restart.

Deflective Yolk

This is a green-tier utility item.

• Gain 14% critical strike chance by default, plus 5% per additional stack.
• Critical hits grant temporary barrier equal to 3% of maximum health by default, plus 3% per additional stack.
• Barrier grants have a 0.25 second per-player cooldown by default to prevent rapid multi-hit crits from creating excessive barrier.
• All Deflective Yolk values are configurable through Risk of Options.

Sanguine Bargains

This is a direct Blood Shrine tweak, not an artifact. It can be enabled or disabled through Risk of Options.

When this tweak is enabled:

• Blood Shrines track the actual health sacrificed by each player.
• Every 50% cumulative max health sacrificed earns a Blood Tithe reward roll by default.
• Blood Tithe rewards drop a white item by default, with configurable green and red upgrade chances.
• If a Blood Shrine leaves the player at or below 55% combined health, Blood Insurance grants a temporary barrier by default.
• Reward chance, threshold, green/red chances, barrier threshold, barrier amount, and visual feedback are configurable.
• A per-use reward cap prevents extreme config values from creating item bursts.

Artifact of Rewarding Vines

When this artifact is enabled:

• Normal monsters drop a weighted random item at 0.3% by default.
• Elite monsters drop a weighted random item at 1% by default.
• Boss/champion monsters drop an extra weighted random item at 10% by default.
• The first 5 player team level-ups grant white-tier item reward rolls at 100% by default.
• Each time the player team reaches a new 25-level milestone above 0, it rolls a red-tier item at 100% by default.

Artifact of Recalibration

When this artifact is enabled:

• Direct player hits cannot remove more than a configurable fraction of a monster's max combined health.
• Common monsters default to 50% max health per direct hit.
• Elite monsters default to 15% max health per direct hit.
• Boss/champion monsters default to 3% max health per direct hit.
• Passive proc-chain damage is dampened by default to 15% of its original damage and capped at 2% of the monster's max combined health.
• Rapid direct hits on the same target share a short 0.10 second damage budget window by default.
• A distinct impact effect can play when damage is recalibrated.

Artifact of Undying

When this artifact is enabled:

• Monsters that would take lethal damage are held at 1 HP.
• They become immune and continue moving/attacking for a configurable duration.
• Common monsters default to 1.5 seconds.
• Elite monsters default to 4 seconds.
• Boss/champion monsters default to 8 seconds.
• A visible Undying status icon is applied during the last-stand period.
• A repeated visual pulse marks monsters during the immune last-stand period.
• When the timer expires, the monster dies for real.

Artifact of Survival Instinct

When this artifact is enabled:

• Monsters that survive a heavy hit gain temporary damage resistance.
• Common monsters trigger at 35% max health damage by default.
• Elite monsters trigger at 20% max health damage by default.
• Boss/champion monsters trigger at 8% max health damage by default.
• Active Survival Instinct reduces follow-up player damage by 45% for 1.25 seconds by default.
• Each monster has a configurable cooldown before it can trigger again.

Artifact of Scrappy Beginnings

When this artifact is enabled:

• Players take reduced damage during the opening stages.
• Protection lasts for the first 2 stages by default.
• Incoming player damage is reduced by 20% by default.
• The effect ends naturally after the configured protected stage count.

Artifact of Escalation

When this artifact is enabled:

• Monsters gain stage-scaling damage resistance after the early game.
• Escalation starts on stage 5 by default.
• Monsters gain 3% damage reduction per escalation stage by default.
• Elites gain an additional 5% reduction by default.
• Boss/champion monsters gain an additional 12% reduction by default.
• Total reduction is capped at 60% by default.

All numeric values are configurable through Risk of Options.

Configuration

Open Risk of Options in-game and tune:

• Monster drop chance percent
• Elite drop chance percent
• Boss extra drop chance percent
• Early white item level count
• Early white item chance percent
• Player level red tier threshold
• Red tier milestone chance percent
• Common, uncommon, and legendary tier weights
• Item drop launch velocity
• Rewarding Vines kill-drop per-second safety limit
• Visual effect throttle
• Common, elite, and boss direct damage caps
• Passive proc damage multiplier and cap
• Direct damage budget window
• Recalibration impact effect toggle
• Common, elite, and boss undying durations
• Undying visual pulse interval
• Undying visual effect toggle
• Survival Instinct trigger thresholds, duration, cooldown, reduction, and visual effect toggle
• Scrappy Beginnings protected stage count, damage reduction, and visual effect toggle
• Escalation start stage, per-stage scaling, elite/boss bonuses, maximum reduction, and visual effect toggle
• Sanguine Bargains enable switch
• Blood Tithe threshold, reward chance, green chance, and red chance
• Blood Tithe per-use reward limit
• Blood Insurance enable switch, health threshold, barrier amount, and visual effect toggle
• VinesTweaks item enable switch
• G-Chicken Booster crit chance and crit damage values
• Deflective Yolk crit chance, barrier amount, and barrier cooldown values
• Debug logging

Visual effect prefabs are also retried lazily in-game so feedback effects can recover if RoR2 asset references are not ready during plugin startup.

The same values are also stored in BepInEx config under:

BepInEx/config/com.vgmworld.vinestweaks.cfg

Build

1. Install the dependencies in a separate r2modman or Thunderstore profile.
2. Copy local.props.example to local.props.
3. Set BepInExProfilePath and RoR2ManagedPath.
4. Run:

dotnet build

Install Locally

Copy the built DLL from bin/Release/netstandard2.1/ into:

<profile>/BepInEx/plugins/vinestweaks/

Launch the modded profile, enable the VinesTweaks artifacts you want before starting a run, and inspect the BepInEx console or BepInEx/LogOutput.log if an artifact does not appear.