LunarRitual

v0.1.2·Updated 2026-03-16

A mod for Risk of Rain 2 that introduces a persistent currency and a ritual system that allows players to start each run with powerful bonuses.

Screenshots 3 screenshots

About this mod Author’s original text

See the full change history in CHANGELOG

Thunderstone mod page

Lunar Ritual is a mod for Risk of Rain 2 that introduces a persistent currency and a ritual system that allows players to start each run with powerful bonuses.

The mod adds a new meta-progression mechanic called Genesis Shards, which are stored between runs and can be spent on powerful Lunar Rituals before the run begins.

You can config some parametrs using RiskOfOptions menu:

Features

  • New persistent currency: Genesis Shards [default chance 1%]
  • Ritual system available at the start of every run
  • Multiple offering tiers with different rewards
  • Strong build-defining bonuses before the run even starts

Genesis Shards

Genesis Shards are a special currency added by the mod.

  • They persist between runs
  • They are spent to perform rituals
  • Rituals provide items, stat bonuses, or other rewards

Ritual System

At the start of every run, you will be prompted to perform one ritual.

Each ritual has three offering tiers:

| Offering | Cost |

|---|---|

| Small Offering | 1 coin |

| Medium Offering | 5 coins |

| Grand Offering | 10 coins |

The higher the offering, the stronger the reward.

Rituals

Ritual of Essence

Receive a random item based on the offering amount.

| Offering | Reward |

|---|---|

| 1 coin | 1-5 random common item |

| 5 coins | 1-5 random uncommon item |

| 10 coins | 1-2 random legendary item |

Ritual of Ego

Grants stacks of the lunar item Egocentrism.

Item: Egocentrism

Game Code: LunarSun

| Offering | Reward |

|---|---|

| 1 coin | 1–3 stacks |

| 5 coins | 4–6 stacks |

| 10 coins | 7–10 stacks |

Ritual of Blessing

Grants a permanent stat bonus.

Possible flat stats:

  • Base Damage (+5/15/25)
  • Movement Speed (+1/2/3)
  • HP Regen (+5/15/25)
  • Max HP (+50/100/500)
  • Defence (+50/100/500)

The strength of the bonus scales with the offering size.

Ritual of Lightness

Grants stacks of Hopoo Feather.

Item: Hopoo Feather

Game Code: Feather

| Offering | Reward |

|---|---|

| 1 coin | 2-3 stacks |

| 5 coins | 4-5 stacks |

| 10 coins | 6–10 stacks |

Ritual of Heresy

Grants the full Heresy set, allowing transformation into the hidden character Heretic.

| Offering | Reward |

|---|---|

| 1 coin | 1 stack |

| 5 coins | 2–3 stacks |

| 10 coins | 4–5 stacks |

Items received:

  • Visions of Heresy (Game code: LunarPrimaryReplacement)
  • Hooks of Heresy (Game code: LunarSecondaryReplacement)
  • Strides of Heresy (Game code: LunarUtilityReplacement)
  • Essence of Heresy (Game code: LunarSpecialReplacement)

Ritual of Subjugation

Starts summoner gameplay. Add Happiest Mask and Newly Hatched Zoea.

| Offering | Reward |

|---|---|

| 1 coin | 1 stack |

| 5 coins | 3 stacks |

| 10 coins | 4 stacks |

Items received:

Items: Happiest Mask and Newly Hatched Zoea

Game Code: GhostOnKill and VoidMegaCrabItem

Ritual of Greed

Receive a large amount of gold at the start of the run.

| Offering | Reward |

|---|---|

| 1 coin | 100–200 gold |

| 5 coins | 500–1000 gold |

| 10 coins | 1000–5000 gold |

Ritual of Hunt

Grants stacks of the item Wake of Vultures.

| Offering | Reward |

|---|---|

| 1 coin | 1 stack |

| 5 coins | 3 stacks |

| 10 coins | 5 stacks |

Items received:

Item: Wake of Vultures

Game Code: HeadHunter

Installation

  • Download from Thunderstone
  • Extract all files on ror2modman folder. Example: C:\Users\Ferhassio\AppData\Roaming\r2modmanPlus-local\RiskOfRain2\profiles\test\BepInEx\plugins\LunarRitual

To build the mod from source run (libs required):

dotnet build LunarRitual.sln --configuration Release

Thunderstone - Mod

Compatibility

  • Designed for Risk of Rain 2 Alloyed Collective
  • Works with most gameplay mods
  • MP Compatible
  • ProperSave and Risk of Options

Future Plans

  • Check TODO channel in mod discord

License

MIT License

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. 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.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. 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.

Dependencies

Install these first, or the mod will not work:

tristanmcpherson-R2APIRune580-Risk_Of_Options

File & checksum

Filename
LunarRitual-0.1.2.zip
File size
102.1 KiB