ItemRoulette

ItemRoulette преображает механику сбора экипировки в Risk of Rain 2: вместо долгого поиска разбросанных по углам карты сундуков вы получаете предметы прямо на ходу через динамичную наэкранную рулетку. Сражайтесь, перемещайтесь, побеждайте боссов и открывайте новые предметы без отрыва от боя.

В дополнение к основной наэкранной рулетке мод включает классическое казино-колесо со ставками золотом и предметами, режим высокого риска «Ставка Жизни», а также систему непредсказуемых событий Хаоса.

🎮 Основные механики

🎯 Наэкранная рулетка предметов (HUD Reel)

Основной способ получения экипировки в забеге:

• Мгновенный запуск [B]: анимированная лента предметов интегрирована прямо в верхнюю часть интерфейса над панелью инвентаря. Крутить рулетку можно на полном ходу — во время стрельбы, прыжков и маневров, не открывая лишних меню и не останавливая геймплей.
• Динамическая стоимость: базовая цена ролла масштабируется от сложности текущего забега и возрастает с каждой платной прокруткой на этапе, полностью сбрасываясь при переходе на следующую локацию.
• Бесплатные крутки:
  • Каждая 100% зарядка телепорта начисляет бесплатный ролл (с бонусами за каждый активированный Тотем Горы).
  • Предмет «Звезда скидок» (Sale Star) добавляет дополнительные бесплатные крутки в начале каждого этапа.
  • Накопление: неиспользованные бесплатные попытки не сгорают при смене локации, а переносятся дальше.
• Авто-прокрутка [Удержание V]: комфортный фоновый режим. При нехватке золота рулетка встает на паузу в режим ожидания и автоматически возобновляет вращение, как только вы заработаете нужную сумму.
• Синергия с предметами: поддержка «Куклы удачи» (Chance Doll) — каждый выпавший предмет получает шанс мгновенно повысить свою редкость прямо на ленте рулетки.

🔮 Предметы Бездны: Заражение, Перерол и Очищение

Выпадение предмета Бездны — это всегда важное решение. Когда рулетка останавливается на новом зараженном предмете, игра приостанавливает ленту и предлагает три варианта:

• [B] Взять предмет: принять силу Бездны и заразить соответствующие базовые предметы в инвентаре.
• [R] Перекрутить предмет: попытать удачу еще раз за Лунные монеты (стоимость и лимит попыток на предмет настраиваются в конфиге).
• [C] Отказаться от заражения:
  • За Лунные монеты: безопасное очищение предмета без последствий.
  • Ценой максимального здоровья: альтернативный вариант платы через временный штраф к макс. ХП до конца этапа (накапливается с каждым отказом, отображается характерной штриховкой проклятия на шкале здоровья и имеет защитный лимит).

🎰 Европейская рулетка и «Ставка Жизни»

Для тех, кто готов рискнуть накопленным золотом и лутом:

• Боковая панель [K]: компактное окно европейской рулетки (37 секторов: от 0 до 36), не перекрывающее прицел и обзор в бою.
• Ставки золотом: красное / черное, чет / нечет, 1–18 / 19–36, дюжины, колонки и точные числа с классическими коэффициентами выплат.
• Ставка предметом на Зеро (0): выберите любой предмет из своего инвентаря. Если шарик остановится на секторе Зеро — предмет удваивается; в противном случае вещь сгорает.
• ☠ Режим «Ставка Жизни» (Life Bet): предельный азарт. Вы ставите на кон саму жизнь своего персонажа. Эквивалент рассчитывается из уровня, текущего этапа и общей стоимости всех предметов инвентаря. Победа приносит колоссальный куш золота, а поражение ведет к мгновенной гибели выжившего. Предусмотрена двухэтапная защита подтверждения с таймером от случайных кликов.

🌀 События Хаоса (Chaos Events)

Периодически на ленте рулетки появляются специальные секторы со знаком вопроса — они активируют динамические события:

• 13 событий Удачи (зеленый маркер): мгновенное удвоение выигрыша, временный арсенал копий, призыв союзного отряда боевых дронов, благословения на повышенную редкость предметов и денежные бонусы.
• 15 событий Бедствия (красный маркер): инфляция цен, потеря золота, призыв элитных отрядов монстров и агрессивных дронов, лунная гравитация или временные испытания артефактами.
• Персональное действие: модификаторы шансов и эффектов действуют строго на игрока, активировавшего событие, не мешая союзникам по команде в мультиплеере.

⚙️ Настройки и кастомизация

Все ключевые параметры мода можно изменить на лету через внутриигровое меню Risk of Options или в конфигурационном файле:

• Управление пулами предметов: детальная настройка шансов, раздельное включение/отключение отдельных Лунных предметов и артефактов (включая черные списки).
• Сундуки снаряжения (Equipment Barrels): контейнеры с активным снаряжением сохранены на локациях в их классическом виде, чтобы не ломать привычный билд через активные слоты.
• Сетевая игра: полная поддержка мультиплеера с авторитетной синхронизацией через хост. Погибшие игроки в режиме дрона/наблюдателя также могут продолжать крутить рулетку для следующего этапа.
• Поддержка сторонних модов: совместимость с ZetAspects, модовыми артефактами и предметами.
• Админ-меню отладки [F7]: быстрое тестирование любого события Хаоса, баланса и механик.

⌨️ Управление по умолчанию

Все горячие клавиши свободно переназначаются в разделе настроек 01. Controls.

📦 Установка

1. Установите BepInExPack для Risk of Rain 2.
2. (Рекомендуется) Установите Risk of Options для настройки параметров прямо в игре.
3. Распакуйте архив мода в директорию: Risk of Rain 2/BepInEx/plugins/ItemRoulette/.

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.