zero_code_here-CatchupLoot icon

CatchupLoot

Instance-based loot for Artifact of Sacrifice + Command, with per-player tier catchup to keep multiplayer balanced.

Last updated 4 hours ago
Total downloads 17
Total rating 1 
Categories Mods Client-side Server-side AI Generated
Dependency string zero_code_here-CatchupLoot-3.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

bbepis-BepInExPack-5.4.2117 icon
bbepis-BepInExPack

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

Preferred version: 5.4.2117
RiskofThunder-HookGenPatcher-1.2.5 icon
RiskofThunder-HookGenPatcher

MMHOOK generation at runtime.

Preferred version: 1.2.5
RiskofThunder-R2API_Items-1.0.4 icon
RiskofThunder-R2API_Items

API for adding custom items

Preferred version: 1.0.4
RiskofThunder-R2API_Language-1.0.1 icon
RiskofThunder-R2API_Language

API for modifying the language localisation of the game

Preferred version: 1.0.1
RiskofThunder-R2API_Networking-1.0.2 icon
RiskofThunder-R2API_Networking

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

Preferred version: 1.0.2
RiskofThunder-R2API_CommandHelper-1.0.2 icon
RiskofThunder-R2API_CommandHelper

API for registering console commands

Preferred version: 1.0.2

README

CatchupLoot

A Risk of Rain 2 mod that gives each player their own private command cubes when running with Artifact of Sacrifice and Artifact of Command.

What It Does

  • Instance loot: When an enemy dies, every player sees their own local Command Cube. No one can steal your drop.
  • Pull items: Press F3 (configurable) to pull all your unpicked cubes to your position.
  • Per-player catchup: If a player dies or falls behind on items, the mod gives them a higher chance of bonus drops for their missing tiers — so a player who missed a whole stage isn't permanently screwed.

Why Catchup?

In vanilla multiplayer with Command + Sacrifice, there is only one global drop. If someone dies or is slow, they miss out. Boss items in particular are devastating losses. This mod:

  1. Gives everyone their own copy of droplet drops
  2. Tracks each player's inventory per tier (white/green/red/boss)
  3. Compares everyone to the leading player
  4. Gives behind players a bonus roll for exactly the tier they're missing

The more you're behind, the higher the chance. But it's never guaranteed — just a nudge.

Tiers & Weights

Tier Weight Example
White Common items
Green Uncommon items
Red 10× Legendary items
Boss 15× Boss items

Lunar and void items are ignored for catchup scoring.

Catchup Math

For each tier, the mod calculates how many items you're behind the current leader. The bonus roll chance is:

chance = deficit * 5%  (capped at 50%)

If the roll succeeds, a separate cube of that exact tier spawns for you at a slightly random offset.

Console Commands

Command Description
drop_rate <value> Set base drop chance (0–100). Overrides dynamic scaling.
drop_rate_report Print a summary of drop stats for the current run.
instance_loot_hotkey <KeyCode> Change the pull-items keybind (default F3).

Requirements

  • BepInEx 5.x
  • R2API (Items, Language, Networking, CommandHelper modules)
  • Risk of Rain 2 (Seekers of the Storm compatible)

Installation

Drop CatchupLoot.dll into your BepInEx/plugins/ folder (or install via r2modman).

Important: This mod must be installed on all clients and the host. The instance loot is implemented via custom network messages.

Credits

Originally forked from programit/RoR2InstanceLootPlugin.

License

MIT