Petrichor Codex LogoPetrichor Codex

How modding is distributed here

Modding for this game does not run through the storefront. The feature list Valve publishes for the game covers single-player, online co-op and PvP, Remote Play, leaderboards and family sharing — a mod workshop is not among them, and the developer's own patch notes and announcements never discuss modding either.

In practice that means mods live on Thunderstore, a community platform that hosts packages independently of the game. That single channel is where every mod, library and compatibility patch comes from, which is worth knowing before you follow a tutorial that assumes a one-click subscription.

The ecosystem by the numbers

Packages published

7,442

Combined downloads

55.0M

Reading taken

2026-10-10

Confirmed by official sources — counted from the platform's own public API. The figures are a snapshot rather than a live counter, and the package count in particular only grows.

Why foundational libraries lead the top downloads

The most useful thing to understand about this ecosystem is what sits at the top of it. The most-downloaded packages are not the exciting mods — they are the infrastructure those mods are built on, and they carry huge download counts because every other mod pulls them in as a dependency.

PackageDownloadsLayerWhat it is
R2API_StringSerializerExtensionsRiskofThunder873,350LibraryA submodule of the community API that widens what the game's string serializer can handle — infrastructure other mods build on rather than a feature you play with.
R2API_SkinsRiskofThunder806,665LibraryThe submodule that lets mods add custom skins and skin-related utilities.
ZioRiskOfOptionsBubbet599,506LibraryBridges a mod's configuration file into an in-game options menu, which is why so many mods list it as a dependency.
R2API_LanguageRiskofThunder446,669LibraryThe submodule that lets a mod modify the game's localisation.
R2API_SoundRiskofThunder438,960LibraryThe submodule for adding custom sounds and music.
EmptyChestsBeGoneTheRealElysium1,186,168Quality of lifeRemoves empty lootables once they have been opened, so a cleared stage stops advertising chests that contain nothing.
FixGenesisLoopConsoleSpamMoffein512,003Compatibility fixRepairs console spam caused by one specific item interacting with custom skins and survivors — a patch between two other mods rather than a feature layer.

Two consequences follow from that. First, a mod list is never just a mod list — installing one content mod will usually mean installing a handful of libraries it names, and skipping them is the most common reason a mod appears to do nothing. Second, the community API layer is effectively the second game: it is what exposes systems the base game never expected to be extended.

The failure modes worth expecting

  • A patch is what breaks things. Updates change the base game underneath the mods, so anything reaching into a system that shifted needs its own update before it works again. This is routine rather than a sign that the ecosystem is unhealthy.
  • Mods break each other. The download table above includes a package whose entire purpose is repairing one item's interaction with custom skins — published by a different author than either side of the conflict. That pattern is normal at scale.
  • Co-op narrows what is acceptable. A mod that only changes your own interface is broadly safe in a lobby. A mod that adds items, enemies or survivors changes the run itself, so the lobby has to agree on a matching set or the run desynchronises.
  • Anything touching progression can corrupt a save. Mods that alter unlocks, stats or the item pool are the ones worth testing on a fresh profile rather than on years of progress.

Where to start, and what to leave alone

The sensible order is to install a loader first, then a single quality-of-life mod with its dependencies named, confirm it works, and only then start adding content. The top of the download table is a good starting shortlist precisely because those packages are the ones other mods already assume you have.

Browsing the whole catalogue is a mistake for the same reason. With 7,442 packages published, the majority are old, superseded or written for a much earlier version, and download count is a better guide to what still works than novelty is. The community platform's listing for this game is the place to check that:Thunderstore · Risk of Rain 2.

Before committing to a modded install, it is worth checking the version timeline for how recently the game changed. A mod ecosystem right after a 2026 release is a different proposition from one six months into a stable patch.

What the official side establishes

商店的 categories 字段列出了单人与在线合作、PvP、Remote Play、家庭共享等,其中没有 Steam 创意工坊这一项。 That is a verified fact about the store listing rather than a policy statement.

在已采集的补丁说明与官方公告中检索 mod / workshop 关键词均无命中。

Read together, those two observations describe a modding scene that grew up alongside the game rather than one the developers built a lane for. That is not a judgement about whether modding is encouraged; it is the extent of what the public material establishes, and this page stops there rather than inferring an endorsement or a prohibition.

What is still being collected

  • 官方对 mod 的态度没有公开条文可比对:补丁说明与公告里检索 mod / workshop 均无命中,因此本页只陈述已核实的事实,不替官方表态。
  • 各 mod 的兼容性矩阵尚未采集,只登记了下载量最高的几个包作为生态结构示例。
  • 主机平台能否使用 mod 未核实。

Frequently asked

Does Risk of Rain 2 have official mod support?
Modding is supported entirely through the community Thunderstore ecosystem rather than an in-game Steam Workshop integration. Verified via official storefront feature lists and patch notes, Risk of Rain 2 runs mods through the BepInEx runtime loader and R2API framework. While official in-game distribution is not built into the client, players can install and manage mods seamlessly using the Thunderstore Mod Manager or r2modman.
Where do Risk of Rain 2 mods come from?
They are distributed through Thunderstore, a community platform that hosts the packages independently of the game. Every mod, library and compatibility patch used by the community arrives through that one channel.
Why do mods need other mods installed first?
Because part of the ecosystem is infrastructure. The most-downloaded packages are libraries that expose game systems to other mods rather than features you play with, so a content mod will usually name several libraries as dependencies.
Do mods break when the game updates?
That is the normal failure mode. A patch changes the base game underneath the mods, and anything relying on the parts that changed has to be updated before it works again. The safest habit is to wait for the mods you depend on to catch up rather than launching straight into a new patch.
Can I play modded with friends who are unmodded?
It depends on what the mod does. Interface and quality-of-life mods that only change your own client are generally fine; anything that adds items, enemies or survivors changes the run itself, so everyone in the lobby has to be running compatible versions.