You are viewing a potentially older version of this package. View all versions.
TeamTayne-LevelUpChoicesFixes-1.0.4 icon

LevelUpChoicesFixes

Compatibility fixes and configurable integrations for karaeren.LevelUpChoices, including optional Risk of Options controls, Item Qualities, quality interactable filtering, safe rerolls, pause recovery, blacklists, and interactables.

Date uploaded 2 days ago
Version 1.0.4
Download link TeamTayne-LevelUpChoicesFixes-1.0.4.zip
Downloads 295
Dependency string TeamTayne-LevelUpChoicesFixes-1.0.4

This mod requires the following mods to function

erenkara-LevelUpChoices-1.1.3 icon
erenkara-LevelUpChoices

Every level-up gives each player a choice of 3 items to pick from, with options to reroll or permanently banish items. Fully configurable. LookingGlass recommended.

Preferred version: 1.1.3
RiskofThunder-R2API_Director-3.1.0 icon
RiskofThunder-R2API_Director

API for easily modifiying the Director (RoR2 monster / interactable spawner) behaviour, cloning Spawn Cards and enabling/disabling Combat Directors

Preferred version: 3.1.0
RiskofThunder-R2API_Networking-1.0.3 icon
RiskofThunder-R2API_Networking

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

Preferred version: 1.0.3

README

LevelUpChoicesFixes

LevelUpChoicesFixes adds compatibility fixes and configurable quality support to LevelUpChoices for Risk of Rain 2.

Requirements

Install the package with a Thunderstore-compatible mod manager. R2API Director and R2API Networking are installed as dependencies. Item Qualities is only needed for the quality features.

Opening the choice menu

Use the configured toggle-menu key to open or close the item choices when the notification shows that you have unused tokens.

Quality features

When Item Qualities is installed, quality variants appear directly in LevelUpChoices item choices.

Why guaranteed sets exist

LevelUpChoices can remove chests and other item sources, while Item Qualities normally gets many of its quality rolls from those sources. Guaranteed sets replace some of those lost opportunities with predictable quality choices during the level-up progression.

Default quality settings:

  • Random quality chance: 4% per ordinary offered item
  • Guaranteed quality set: every 5 levels
  • Choices in a guaranteed set: 3
  • Quality weights: Uncommon / Rare / Epic / Legendary = 70 / 20 / 8 / 2
  • Quality item sources (chests, printers, the dropped-item barrel, cloaked chest, and equipment barrel) are disabled when LevelUpChoices removes item sources

Guaranteed sets use the normal LevelUpChoices item-rarity progression. Early sets are usually white; green and red base items become more likely as you select more items. The quality tier is selected randomly using the configured quality weights.

If an earlier choice set is still waiting to be selected, the guaranteed set is queued until the next set is generated. Guaranteed quality settings do not replace or alter choices already on screen.

Without guaranteed quality sets

Set Guaranteed Quality Every N Levels to 0 to use only the ordinary random quality chance. With the default Quality Chance=4%, each offered item has a 4% chance to be quality. A three-item choice screen therefore has an 11.53% chance of containing at least one quality item, but it is not guaranteed. Across 100 ordinary offered items, approximately 4 quality items are expected.

Probability chart

The chart shows ordinary LevelUpChoices rarity progression and the 4% random quality rate. The guaranteed quality setting is a periodic level-based event, so it is described below the chart rather than plotted as a token-based curve.

LevelUpChoices and Item Qualities probability chart

Configuration

All settings are server/host settings in the Server section of the BepInEx configuration file. Quality and interactable-credit settings also appear in Risk of Options when it is installed.

Setting Default Description
Enable Quality Integration true Enable quality variants in level-up choices.
Quality Chance 4% Random quality chance for ordinary offered items.
Guaranteed Quality Every N Levels 5 Queue a guaranteed quality choice set. Set to 0 to disable.
Guaranteed Quality Choice Count 3 Number of guaranteed quality choices.
Uncommon / Rare / Epic / Legendary Quality Weight 70 / 20 / 8 / 2 Relative quality-tier weights.
Remove Quality Interactables true Remove Item Qualities item sources (chests, printers, the dropped-item barrel, cloaked chest, and equipment barrel) when LevelUpChoices removes item sources.

Additional native configuration:

Setting Default Description
Item Blacklist DefensiveMicrobots Comma-separated item names removed from every LevelUpChoices player pool.
Interactable Credit Multiplier 1.0 Multiplies the original interactable credit budget.

Host settings are authoritative in multiplayer and synchronize to connected clients when a run starts or settings change.

Other fixes

  • Prevents quality variants from causing duplicate-item reroll and banish problems.
  • Recovers cleanly when the choice menu is closed through the pause screen or when a run ends.
  • Adds configurable item blacklists, quality-interactable removal, and interactable credit scaling.

What is removed with item sources

While LevelUpChoices' Enable Interactable Removal option is on, this add-on also removes interactables that hand out items, including ones LevelUpChoices does not know about (DLC3's Temporary Item Distributor and Item Qualities' sources). Removal covers chests, printers, shops that sell items, recycling services, the item-producing Blood, Chance, Cleansing, and Restack shrine families, and item-granted sources (key lockboxes and shipping request deliveries). Stage pools are filtered before the stage populates, and item sources that a mod spawns directly are refused.

Kept shrine interactions: Shrine of the Mountain, Halcyon Shrine, Altar of Gold, Shrine of Shaping, Shrine of the Woods, and the Collective Shrine of Combat.

Kept on purpose: up to four equipment barrels per stage, the listed shrine interactions, void interactables, drone vendors and drone services, plain barrels, portals, and the radar tower. Equipment shops remain removed. The equipment-barrel cap prevents LevelUpChoices' redirected Barrels-category budget from creating extreme equipment density.

Support

Report issues with your mod versions, configuration values, host/client setup, and relevant BepInEx/LogOutput.log messages:

https://github.com/max-arias/level-up-fixes/issues

CHANGELOG

Changelog

1.0.4

  • Removed Starstorm 2's Security Chest (the Mimic) while LevelUpChoices' interactable removal is enabled.

1.0.3

  • Restored Shrine of the Mountain, Halcyon Shrine, Altar of Gold, Shrine of Shaping, Shrine of the Woods, and the Collective Shrine of Combat.
  • Corrected the release packaging after the 1.0.2 shrine policy was changed; Collective Shrine of Combat is explicitly removed from LevelUpChoices' private blacklist before stage population.

1.0.2

  • Fixed item-source removal missing DLC3's Temporary Item Distributor and the equipment-less DLC3 drone scrapper.
  • Item sources that spawn outside stage pools are now refused too: Item Qualities' dropped-item barrel and cloaked chest, key lockboxes, and shipping request deliveries.
  • Capped equipment barrels at four per stage and kept equipment shops removed. This preserves a small equipment supply without LevelUpChoices' Barrels-category weight redistribution causing extreme density. Item Qualities' equipment barrel remains removed when Remove Quality Interactables is enabled.
  • Restored Shrine of the Mountain, Halcyon Shrine, Altar of Gold, Shrine of Shaping, Shrine of the Woods, and the Collective Shrine of Combat; the latter is explicitly removed from LevelUpChoices' private blacklist.
  • Fixed runs stalling at high levels: the add-on no longer overwrites LevelUpChoices' XP table.
  • Fixed queued guaranteed quality sets carrying over while the mod is disabled and being spent after re-enabling.
  • Removed the XP Curve, Starting XP, and XP Scaling settings. LevelUpChoices' own Max Level and Enable Level System settings control the XP curve again, using its auto-tuned progression.

1.0.1

  • Fixed the probability chart image link in the Thunderstore README.

1.0.0

  • Added a configurable 4% random quality chance with weighted Uncommon, Rare, Epic, and Legendary results.
  • Added guaranteed quality choice sets, defaulting to three quality choices every five levels.
  • Guaranteed sets keep the normal progression from white to green and red item rarities as the run advances.
  • Added safe rerolls and banishes for quality variants without duplicate base items.
  • Added pause/menu cleanup so the game does not remain paused after closing the choice screen.
  • Added configurable item blacklists, interactable controls, interactable credit scaling, and XP curves.
  • Added optional Risk of Options controls for quality and interactable settings.
  • Host/server settings synchronize to clients in multiplayer.
  • Improved mod-manager installation and included the plugin's debugging symbols for troubleshooting.
  • Replaced granular interactable-preservation settings with one Remove Quality Interactables control.
  • Removed the reroll refresh and item-choice schedule settings; LevelUpChoices now uses its normal level-up cadence.
  • Switched interactable removal to R2API Director's DCCS-pool hook so chests and other item sources are filtered before stage population.