You are viewing a potentially older version of this package. View all versions.
tristanmcpherson-R2API-4.0.11 icon


A modding API for Risk of Rain 2

Date uploaded 2 years ago
Version 4.0.11
Download link
Downloads 69113
Dependency string tristanmcpherson-R2API-4.0.11

This mod requires the following mods to function

bbepis-BepInExPack-5.4.2109 icon

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.2109
RiskofThunder-HookGenPatcher-1.2.3 icon

MMHOOK generation at runtime.

Preferred version: 1.2.3
RiskofThunder-R2API_ArtifactCode-1.0.1 icon

API for making Artifact Codes

Preferred version: 1.0.1
RiskofThunder-R2API_CommandHelper-1.0.1 icon

API for registering console commands

Preferred version: 1.0.1
RiskofThunder-R2API_ContentManagement-1.0.1 icon

API for adding content to the game

Preferred version: 1.0.1
RiskofThunder-R2API_Core-5.0.10 icon

Core R2API module

Preferred version: 5.0.10
RiskofThunder-R2API_DamageType-1.0.4 icon

API for registering damage types

Preferred version: 1.0.4
RiskofThunder-R2API_Deployable-1.0.1 icon

API for adding custom deployables

Preferred version: 1.0.1
RiskofThunder-R2API_Difficulty-1.1.1 icon

API for adding custom in-game difficulties

Preferred version: 1.1.1
RiskofThunder-R2API_Director-1.1.1 icon

API for easily modifiying the Director (RoR2 monster / interactable spawner) behaviour

Preferred version: 1.1.1
RiskofThunder-R2API_Dot-1.0.1 icon

API for adding custom damage over time effects

Preferred version: 1.0.1
RiskofThunder-R2API_Elites-1.0.2 icon

API for adding custom elite types

Preferred version: 1.0.2
RiskofThunder-R2API_Items-1.0.3 icon

API for adding custom items

Preferred version: 1.0.3
RiskofThunder-R2API_Language-1.0.1 icon

API for modifying the language localisation of the game

Preferred version: 1.0.1
RiskofThunder-R2API_Loadout-1.0.2 icon

API for registering skills, skins and entity states

Preferred version: 1.0.2
RiskofThunder-R2API_LobbyConfig-1.0.1 icon

API for modifying the in-game lobby rules

Preferred version: 1.0.1
RiskofThunder-R2API_Networking-1.0.2 icon

Networking API around the Unity UNet Low Level API (LLAPI)

Preferred version: 1.0.2
RiskofThunder-R2API_Orb-1.0.1 icon

API for creation and management of custom Orb types.

Preferred version: 1.0.1
RiskofThunder-R2API_Prefab-1.0.3 icon

API for Prefab creation, networking and duplication

Preferred version: 1.0.3
RiskofThunder-R2API_RecalculateStats-1.2.0 icon

API for manipulating Character Stats

Preferred version: 1.2.0
RiskofThunder-R2API_SceneAsset-1.1.1 icon

API for retrieving assets that live exclusively in game scenes

Preferred version: 1.1.1
RiskofThunder-R2API_Sound-1.0.2 icon

API for adding custom sounds or musics

Preferred version: 1.0.2
RiskofThunder-R2API_TempVisualEffect-1.0.2 icon

API for adding custom temporary visual effects for characters.

Preferred version: 1.0.2
RiskofThunder-R2API_Unlockable-1.0.2 icon

API for adding custom achievements and unlockables

Preferred version: 1.0.2


R2API – a modding API for Risk of Rain 2

Build Status - DEPRECATED GitHub Actions Build


In the Release version of RoR2, Hopoo Games made a NetworkModCompatibilityHelper class, which can be given a mod list that is then transformed into a hash that will be checked upon client connection in multiplayer. If the hash doesnt correspond between the server and the connecting client, the connection is refused.

R2API will add mods to that mod list if they:

  • Use the NetworkCompatibility Attribute, either as an custom assembly attribute, or at the top of their plugin class inheriting from BaseUnityPlugin with the first argument being CompatibilityLevel.EveryoneMustHaveMod.
  • Don't have the NetworkCompatibility Attribute but depend on R2API (have [BepInDependency("com.bepis.r2api")] attribute).


R2API is a modding framework for other mods to work in, providing centralized and simplified APIs for Risk of Rain 2. This helps keeping mods compatible with each other.

At it's core, R2API should not change how the game behaves without any other mod installed. The only change is to keep mods out of quickplay and prismatic trials by request of the Hopoo Games team.

Manual installation

The contents of R2API should be extracted into the BepInEx folder, such that the files inside the plugins folder in the zip sit in the plugins folder in BepInEx.

Also you need to install HookGenPatcher because R2API wont function without it.


A lot of documentation is in the included xmldocs, and further information may be on the dedicated R2API wiki. Do not hestiate to ask in the modding discord too!

Bleeding Edge

Unless you are a mod developer, you won't need this.

Want to get the latest versions of R2API? The latest bleeding edge builds of master are hosted on Azure, and may be downloaded using the Artifacts drop down menu.

Note that such builds may be unstable.


The most recent changelog can always be found on the GitHub. In this readme, only the most recent minor version will have a changelog.