Planned Evolution

A Risk of Rain 2 mod that gives you complete control over the Evolution artifact! Instead of random items, monsters gain items according to your custom schedule. This was heavily inspired by ArtifactofEvolutionPlusPlus by the talented Lunzir.

Features

• Stage-by-Stage Planning: Configure exactly what items monsters get on each stage (1-20)
• Flexible Item Selection: Use item names, tier keywords (AnyWhite, AnyGreen, AnyRed, AnyVoid), or specific item codes
• Blacklist System: Ban specific items from random pools (default: RollOfPennies, SquidPolyp, ShockNearby)
• In-Game Announcements: See what items monsters gained each stage in chat
• Full Compatibility: Works with modded items and the base Evolution artifact

Installation

Requirements

• BepInEx 5.4.21 or later
• HookGenPatcher (handles On.IL hooks)
• Risk of Rain 2 (Survivors of the Void DLC recommended)

Steps

1. Install BepInEx if you haven't already
2. Install HookGenPatcher
3. Download Planned Evolution and extract to your BepInEx/plugins folder
4. Launch the game and enable the Artifact of Evolution

Configuration

After running the mod once, edit BepInEx/config/com.FortressForce.PlannedEvolution.cfg:

General Settings

[General]
# Set to false to disable the mod
Enabled = true

Evolution Schedule

Configure stages 1-20. Default progression:

• Stages 1-5: 1 random white item per stage
• Stages 6-10: 1 random green item per stage
• Stages 11-20: 1 random red item per stage

[Evolution Schedule]
Stage 1 = AnyWhite, 1
Stage 2 = AnyWhite, 1
Stage 3 = AnyWhite, 1
Stage 6 = AnyGreen, 1
Stage 11 = AnyRed, 1

Blacklists

Prevent specific items from appearing in random pools:

[Blacklists]
Banned Whites = RollOfPennies
Banned Greens = SquidPolyp
Banned Reds = ShockNearby

Configuration Syntax

Format

Each stage config line follows this pattern:

ItemIdentifier, Count; ItemIdentifier, Count

Examples

Give 1 Soldier's Syringe

Stage 1 = Syringe, 1

Give 3 Lens-Maker's Glasses

Stage 2 = CritGlasses, 3

Give 1 random white, then 2 Gasoline

Stage 3 = AnyWhite, 1; Gasoline, 2

Give 5 random greens

Stage 4 = AnyGreen, 5

Item Identifiers

Specific Items - Use internal item codes:

• Syringe = Soldier's Syringe
• CritGlasses = Lens-Maker's Glasses
• Behemoth = Brilliant Behemoth
• Hoof = Paul's Goat Hoof

Random Tiers - Use keywords:

• AnyWhite = Random white (common) item
• AnyGreen = Random green (uncommon) item
• AnyRed = Random red (legendary) item
• AnyVoid = Random void item

Count

• Positive numbers: Add items (3 = give 3 items)
• Negative numbers: Remove items (-2 = take away 2 items)

Example: Reverse progression

Stage 5 = AnyRed, 1
Stage 10 = AnyRed, -1; AnyWhite, 5

Finding Item Codes

Not sure what an item's code is? Check these resources:

• RoR2 Wiki Item List
• Item Code Reference

Common Item Codes

Compatibility

Risk of Options

This mod uses standard BepInEx config files. If you have Risk of Options installed, you can edit settings in-game from the pause menu without needing to manually edit config files!

Other Mods

• ✅ Compatible with modded items (use their item codes)
• ✅ Compatible with other artifact mods
• ⚠️ Replaces vanilla Evolution artifact behavior (intentional!)
• ❌ Conflicts with other Evolution-overriding mods (use only one)

Example Configurations

Slow Burn (Gradual scaling)

Stage 1 = AnyWhite, 1
Stage 2 = AnyWhite, 1
Stage 3 = AnyWhite, 2
Stage 4 = AnyGreen, 1
Stage 5 = AnyGreen, 1
Stage 6 = AnyGreen, 2
Stage 7 = AnyRed, 1

Boss Rush (Immediate difficulty)

Stage 1 = AnyRed, 1
Stage 2 = AnyRed, 1
Stage 3 = AnyRed, 1
Stage 4 = AnyRed, 2
Stage 5 = AnyRed, 2

Fixed Build (Same items every run)

Stage 1 = Syringe, 1
Stage 2 = Syringe, 1
Stage 3 = Hoof, 1
Stage 4 = CritGlasses, 2
Stage 5 = Behemoth, 1
Stage 6 = Behemoth, 1

Changelog

v2.3.3

• Fixed chat spam when Evolution artifact is disabled

v2.3.2

• Fixed softlock issue when overriding vanilla Evolution artifact
• Improved reflection-based inventory access
• Added proper error handling

Credits

• Original mod: Based on Artifact Evolution++ by Lunzir
• Maintained by: FortressForce (Hats)

Support

If you encounter issues:

1. Check that BepInEx and HookGenPatcher are installed
2. Verify the Evolution artifact is enabled in-game
3. Check BepInEx/LogOutput.log for error messages
4. Report bugs on the mod page with your log file

License

This mod is provided as-is for the Risk of Rain 2 community. Feel free to modify and share!