ItemRoulette

ItemRoulette transforms item acquisition in Risk of Rain 2. Instead of scouring every corner of the map for scattered chests, you acquire items on the move via a dynamic on-screen HUD reel. Fight, dash, defeat bosses, and build your survivor without ever interrupting combat.

Beyond the core HUD reel, the mod introduces a European casino roulette wheel with gold and item wagers, a high-stakes "Life Bet" mechanic, and unpredictable Chaos Events.

🎮 Core Mechanics

🎯 On-Screen Item Reel (HUD Reel)

The primary method for acquiring loot during your run:

• Instant Spin [B]: An animated item ribbon integrated directly into the upper HUD above your inventory bar. Spin on the fly—while sprinting, jumping, and shooting—without opening pause menus or stopping gameplay.
• Dynamic Cost Scaling: Base spin costs scale with run difficulty and increase with each paid roll on the current stage, resetting completely upon advancing to the next environment.
• Free Spins:
  • Fully charging the Teleporter awards a free spin (with additional bonus spins for each activated Mountain Shrine).
  • The Sale Star item grants bonus free spins at the start of each stage.
  • Roll Stacking: Unspent free spins carry over across stages rather than expiring.
• Auto-Spin [Hold V]: A seamless background mode. If you run out of gold, the reel pauses and automatically resumes spinning as soon as you earn enough currency.
• Item Synergies: Native support for Chance Doll—every rolled item has a chance to instantly upgrade its tier directly on the ribbon.

🔮 Void Items: Corruption, Reroll & Cleansing

Rolling a Void item is a pivotal choice. When the reel lands on a newly discovered corrupted item, it pauses and presents three tactical choices:

• [B] Take Item: Embrace the Void and corrupt corresponding standard items in your inventory.
• [R] Reroll Item: Test your luck again using Lunar Coins (cost and maximum attempts per item are configurable).
• [C] Decline Corruption:
  • Via Lunar Coins: Safely cleanse the item with no negative side effects.
  • Via Maximum Health: Cleanse at the cost of a temporary max HP penalty until the end of the stage (stacks cumulatively with each decline, displays native curse bar striping, and respects a configurable safety cap).

🎰 European Roulette & "Life Bet"

For survivors willing to risk their hard-earned gold and equipment:

• Side Panel [K]: A sleek European roulette interface (37 pockets: 0 to 36) positioned cleanly so it doesn't obstruct combat visibility or crosshairs.
• Gold Bets: Red/Black, Even/Odd, Low (1–18)/High (19–36), Dozens, Columns, and Straight-Up numbers with authentic casino payout ratios.
• Item Bet on Zero (0): Stake any item from your inventory on Zero. If the ball lands on 0, your item is duplicated; otherwise, the item is destroyed.
• ☠ "Life Bet" Mode: The ultimate gamble. Wager your survivor's very life. The payout value is dynamically calculated based on your level, stage, and the combined net worth of your inventory. Victory grants an enormous windfall of gold; defeat results in instant permadeath. Includes a two-step confirmation dialog with a safety countdown to prevent accidental clicks.

🌀 Chaos Events

Mystery question mark sectors occasionally appear on the reel, triggering dynamic game-altering events:

• 13 Boon Events (Green): Instant payout doubling, temporary arsenal duplication, support drone reinforcements, rarity blessings, and cash windfalls.
• 15 Hazard Events (Red): Price inflation, gold loss, elite monster ambushes, hostile attack drones, lunar gravity, or temporary artifact trials.
• Per-Player Scoping: Hazard modifiers and event effects apply strictly to the player who triggered them, preserving fair play in multiplayer.

⚙️ Configuration & Customization

Tune gameplay mechanics on the fly via the in-game Risk of Options menu or the configuration file (com.user.itemroulette.cfg):

• Item & Artifact Pool Management: Fine-tune drop rates, toggle individual Lunar items, and configure the artifact pool (including custom blacklists).
• Equipment Barrels: Physical equipment barrels remain untouched in stages to preserve intentional active equipment builds.
• Multiplayer Support: Full multiplayer compatibility with host-authoritative netcode. Fallen players in spectator/drone mode can continue spinning rolls for the next stage.
• Third-Party Mod Compatibility: Built-in soft-dependency support for ZetAspects, Goorakh-Quality (Quality tiers, Quality chests, Chaos scaling & custom events), modded items, and third-party artifacts.
• Debug & Admin Menu [F7]: Instantly test Chaos events, simulate rolls, and verify mechanics.

⌨️ Default Controls

All hotkeys can be rebound under the 01. Controls configuration section.

📦 Installation

1. Install BepInExPack for Risk of Rain 2.
2. (Recommended) Install Risk of Options for in-game configuration.
3. Extract the mod archive into your Risk of Rain 2/BepInEx/plugins/ItemRoulette/ directory.

💬 Feedback & Bug Reporting

Found a bug, want to suggest new Chaos Events, or discuss balance? Join our community:

• Discord: Join our Discord Server (https://discord.gg/mpHBdhMBVY)
• When reporting bugs, please include your BepInEx log file (BepInEx/LogOutput.log) and a brief description of what happened.

Changelog

[1.3.14] - 2026-10-16

Localization & Internationalization (EN / RU):

• Full English (EN) Language Support:
  • Comprehensive English localization across all aspects of the mod alongside native Russian.
  • Automatic language detection: detects client language (RoR2.Language.currentLanguageName). Automatically defaults to Russian if the game is set to Russian ("ru"), and English for any other language ("en", "zh-CN", "fr", "de", "es", etc.).
• Configurable Language Setting (00. Language):
  • LanguageSetting (default: Auto): Choose between Auto, English, or Russian directly via config or the Risk of Options menu.
• 100% Bilingual Interface & HUD:
  • HUD Reel: Spin prompts, hold progress bars, auto-spin badges, free roll counter pills, tier upgrade toasts, and status alerts.
  • Void Corruptions: Bilingual decision banners, action buttons (Take [B], Reroll [R], Decline [C]), cost displays, and max HP penalty warnings.
  • All 29 Chaos Events: Fully localized titles, descriptions, drone squad options, and chat announcements for all 14 Positive and 15 Negative events.
  • Casino Roulette: Board bets, pocket labels, chip/currency selectors (Gold / Life), validation warnings, win/loss toasts, chat broadcasts, and Life Bet permadeath confirmation modals.
  • Admin / Debug Menu [F7]: Control buttons, positive/negative event columns, and instant simulation alerts.
  • Quality Mod Integration: Localized quality tier frames, prompts, and custom events (Forge Anomaly & Void Corrosion).

[1.3.13] - 2026-10-16

Quality Mod Compatibility (Goorakh-Quality):

• Full Soft-Dependency Integration:
  • Added pure reflection bridge in QualityCompat.cs for com.Gorakh.ItemQualities (ItemQualities.dll). Zero hard dependencies, completely isolated.
  • Automatically identifies and supports all Quality tiers: Uncommon, Rare, Epic, and Legendary.
• Configurable Quality Chest Generation & Rewards (04d. Quality Integration):
  • AllowQualityChestSpawns (default: true): Toggle generation of QualityChest1 and QualityChest2 interactables on stages.
  • QualityChestRewardAllPlayers (default: false): Configure reward distribution when opening Quality chests (Opener Only vs Team-wide). Opening rewards free quality rolls with guaranteed quality upgrades.
  • QualityRollChanceMultiplier (default: 1.0x): Multiplier for base quality chance during roulette rolls.
• Chaos Quality Influence Mechanic:
  • EnableChaosQualityInfluence (default: true): Connects player's total accumulated Chaos percentage (Good% + Bad%) to item quality upgrades.
  • ChaosQualityInfluenceFactor (default: 0.05% per 1% Chaos): Increases quality upgrade odds with high-risk builds (+5% quality chance at 100% Chaos).
• Exclusive Chaos Events:
  • Forge Anomaly (Good): Automatically reforges a random inventory item or won item, elevating its quality tier by +1. Only rolled when Quality mod is loaded.
  • Void Corrosion (Bad): Corrupts an item in the player's inventory, degrading its quality tier by 1. Only rolled when Quality mod is loaded.
  • Ally Mirror Enhancement: Faithfully duplicates ally items with their exact Quality tier preserved.
• HUD & UI Quality Presentation:
  • Quality items on the HUD reel are adorned with glowing rarity accents, quality frames, and the ✦ symbol.
  • Status prompt indicates available [B] КРУТКА КАЧЕСТВА: БЕСПЛАТНО (X) rolls with dedicated emerald-cyan styling.

[1.3.12] - 2026-10-16

Elite Aspect Pool Filtering:

• Incomplete Aspect Validation:
  • Added strict validation in ElementalAspectDrop event to ensure only fully functional elite aspects with active passive buff definitions (passiveBuffDef != null) are included in the pool.
  • Automatically filters out incomplete/dummy internal DLC equipment without passive buffs.

[1.3.11] - 2026-10-16

Dependency & Clean Installation Fix:

• HookGenPatcher Dependency Added:
  • Added RiskofThunder-HookGenPatcher-1.2.5 to Thunderstore dependencies in manifest.json.
  • Fixes TypeLoadException: Could not load file or assembly 'MMHOOK_RoR2' when installing the mod on clean/fresh mod profiles.

[1.3.8] - 2026-10-15

Void Item Reroll Mechanic (Lunar Coins):

• Void Decision Reroll System:
  • Added ability to reroll an unowned Void item directly from the decision banner using Lunar Coins.
  • New hotkey VoidRerollHotkey (default: KeyCode.R, configurable in 01. Controls and RiskOfOptions).
• Configurable Reroll Settings (02. Drop Suppression):
  • EnableVoidReroll (default: true): Enable or disable Void item rerolling.
  • VoidRerollLunarCoinsCost (default: 2, range 0-20): Cost in Lunar Coins per reroll attempt.
  • VoidRerollMaxPerItem (default: 3, range 1-10): Maximum reroll attempts allowed per dropped Void item.
• Interactive 3-Button Decision Banner:
  • Dynamically displays 3 responsive action buttons in VoidDecision state:
    • [✓ ВЗЯТЬ [B]] (Green)
    • [↻ ПЕРЕКРУТИТЬ (-2 Лун.) [0/3] [R]] (Cyan/Celestial Lunar)
    • [✕ ОТКАЗАТЬСЯ (-4 Лун. / -30% ХП) [C]] (Violet / Crimson)
  • Clear state indicators for reaching maximum rerolls or insufficient coins.
• Multiplayer Synchronization:
  • Server-authoritative deduction of Lunar Coins with broadcast chat notifications.

[1.3.7] - 2026-10-15

Artifact Pool Configuration & Artifact of Kin Removal:

• Artifact of Kin (SingleMonsterType) Disabled by Default:
  • Removed from the base active debuff pool (AllowArtifactKin = false). This eliminates the infinite teleporter boss mob spawn spam during teleporter charging.
• Dedicated Artifact Pool Configuration (05b. Artifact Pool):
  • Added new configuration category in config file and RiskOfOptions menu.
  • Individual toggles for all debuff artifacts: Spite, Warfare, Honor, Chaos (coop), Dissonance, Kin, Swarms, Frailty, Soul.
  • Optional toggles for all other game artifacts: Devotion, Delusion, Rebirth, Glass, Evolution, Vengeance, Metamorphosis, Enigma, Sacrifice, Command, Death.
• Modded Artifact Support:
  • AllowModdedArtifacts (default: true): dynamic discovery and inclusion of any third-party artifacts from ArtifactCatalog.
  • ArtifactCustomBlacklist: customizable string blacklist for unwanted artifacts.

[1.3.6] - 2026-10-15

Switchable Void Decline Cost (Lunar Coins vs Max HP):

• Configurable Decline Cost Mode (VoidDeclineCostMode):
  • LunarCoins: Classic decline costing Lunar Coins (default: 4 coins).
  • MaxHealthPenalty: Decline at the cost of temporary maximum health reduction (default: 30% per decline).
• Cumulative Stacking & Safety Cap:
  • Declining multiple times on the same stage accumulates penalty: 1st decline = -30%, 2nd = -60%, 3rd = -90%.
  • Added configurable safety cap VoidDeclineMaxHealthPenaltyCap (default: 90%) preventing instant suicide.
• RoR2 Native Curse Bar Visualization (cursePenalty):
  • Deducted maximum health is visually blocked on the health bar with native diagonal curse stripes.
• Stage Reset:
  • Health penalty stacks are cleared upon teleporter stage transition or starting a new run.
• Adaptive UI & Multiplayer Sync:
  • Action buttons and header labels dynamically update to show cost in coins or health penalty.
  • Server-authoritative penalty processing with multiplayer chat announcements and stack synchronization.

[1.3.5] - 2026-10-15

Lunar Item Pool Configuration & ZetAspects Mod Support:

• Comprehensive Lunar Item Pool Settings:
  • Added 04b. Lunar Pool configuration category with individual toggles for all 20 passive Lunar items and 5 Lunar equipments across base game and DLCs (SotV, SotS).
  • Added custom Lunar blacklist setting (LunarCustomBlacklist).
• ZetAspects (com.TPDespair.ZetAspects) Integration:
  • Mod compatibility layer with soft-dependency reflection.
  • In Chaos event «Elemental Aspect Drop», aspects are awarded as permanent passive items instead of overriding active equipment.
  • Added setting to include ZetAspects elite items into the roulette pool.

[1.3.4] - 2026-10-14

Void Roll Isolation & Interaction Fixes:

• Void Rolls Excluded from Auto-Spin:
  • Auto-spin mode ([V]) will not consume Void rolls; player retains full manual control via [C].
• UI & Button Fixes:
  • Fixed button text clipping and currency token issues.
• Multiplayer Cradle Fix:
  • Resolved local player match check so opening a Void Cradle awards a roll exclusively to the activator.
• Lunar Shop & Cauldron Compatibility:
  • Ensured physical purchases and conversions in Bazaar Between Time and Cauldrons function seamlessly without interference.

[1.3.0] - 2026-10-13

Auto-Spin, Chance Doll & Chaos Overhaul:

• Continuous Auto-Spin mode with hold progress bar ([Hold V]).
• Chance Doll integration: 5% chance per stack to upgrade rolled item tier (White -> Green -> Red).
• New Chaos events: Support Drones, Hostile Enemy Drones, High-Tier Pylon, Aurelionite quality scaling.
• In-game config via RiskOfOptions.

[1.0.0] - 2026-10-10

Initial Release:

• Top HUD CS2-style case opening roulette ([B]).
• European Casino roulette wheel with gold bets ([K]).
• Life Bet mechanic with permadeath risk.
• 28 dynamic Chaos events.