RarityWeightMod

📖 About

RarityWeightMod is a R.E.P.O. mod that controls how many cosmetic boxes spawn per level and the rarity weight of each tier.

✨ Features

Enable/Disable toggle: turn the mod on or off without uninstalling
Two spawn modes: Volume (respects level spawn volumes) or All (forces target count using compensation loop)
Configurable box count: 1–20 boxes per level
Rarity weights: control spawn chance of Common, Uncommon, Rare, and UltraRare independently
Level-only: patches apply only during actual levels — not in shop, lobby, or arena
BepInEx config: edit BepInEx/config/com.yourname.rarityweightmod.cfg to change settings

⚙️ How It Works

Volume mode sets the spawn loop to run up to BoxCount times, then stops naturally when no spawn volumes remain. The actual number of boxes may be lower than BoxCount if the level does not have enough available cosmetic spawn volumes.

All mode uses a compensation window of up to BoxCount × 3 - 1 attempts to retry when an internal spawn fails, similar to how CosmeticBoxConfig by khalil works. This makes it more likely to reach the configured target even on smaller levels.

Rarity is selected using a weighted random roll across all four tiers. The weight values are ratios — 60:25:12:3 and 6:2.5:1.2:0.3 produce identical results. Setting all four to the same value gives equal 25% chance per tier.

🔧 Configuration

After running the mod once, edit:

BepInEx/config/com.yourname.rarityweightmod.cfg

[General]
## Enable or disable the mod entirely.
## false = vanilla behavior, no patches applied.
# Default: true
Enabled = true

## Spawn mode:
##   Volume - spawn up to BoxCount boxes, limited by available spawn volumes in the level
##   All    - force BoxCount boxes using compensation loop (BoxCount × 3 - 1 attempts)
## Changes apply on the next level load.
# Setting type: SpawnMode
# Default: Volume
Mode = Volume

## Number of cosmetic boxes to target per level.
##   1-20 = target box count
## Changes apply on the next level load.
# Acceptable values: 1-20
# Default: 3
BoxCount = 3

[RarityWeights]
## Rarity weights are ratios, not percentages.
## Example: 60:25:12:3 gives ~60% Common, ~25% Uncommon, ~12% Rare, ~3% UltraRare.
## Setting all four to the same value gives equal 25% chance per tier.

# Acceptable values: 0-100
# Default: 60
CommonWeight = 60

# Acceptable values: 0-100
# Default: 25
UncommonWeight = 25

# Acceptable values: 0-100
# Default: 12
RareWeight = 12

# Acceptable values: 0-100
# Default: 3
UltraRareWeight = 3

📦 Installation

Install BepInExPack REPO
Place RarityWeightMod.dll in your BepInEx/plugins/ folder
Launch the game

📜 Changelog

v1.0.0

Initial release
Enable/disable toggle
Volume/All dual spawn mode
Configurable 1–20 box count per level
Weighted rarity system for Common, Uncommon, Rare, UltraRare
Level-only guard using SemiFunc.RunIsLevel()

📄 Dependencies

BepInExPack_REPO >= 5.4.23

🧩 Compatibility

This mod patches ValuableDirector.SpawnCosmeticWorldObject, CosmeticWorldObjectLevelLoopsClampedGet, and CosmeticWorldObjectLevelLoopsGet. It does not modify EnemyDirector, LevelGenerator, or any other system. Monster counts and other level generation logic are unaffected.

📖 About

RarityWeightMod is a R.E.P.O. mod that controls how many cosmetic boxes spawn per level and the rarity weight of each tier.

✨ Features

Enable/Disable toggle: turn the mod on or off without uninstalling

Two spawn modes: Volume (respects level spawn volumes) or All (forces target count using compensation loop)

Configurable box count: 1–20 boxes per level

Rarity weights: control spawn chance of Common, Uncommon, Rare, and UltraRare independently

Level-only: patches apply only during actual levels — not in shop, lobby, or arena

BepInEx config: edit BepInEx/config/com.yourname.rarityweightmod.cfg to change settings

⚙️ How It Works

🔧 Configuration

After running the mod once, edit:

BepInEx/config/com.yourname.rarityweightmod.cfg

[General] ## Enable or disable the mod entirely. ## false = vanilla behavior, no patches applied. # Default: true Enabled = true ## Spawn mode: ## Volume - spawn up to BoxCount boxes, limited by available spawn volumes in the level ## All - force BoxCount boxes using compensation loop (BoxCount × 3 - 1 attempts) ## Changes apply on the next level load. # Setting type: SpawnMode # Default: Volume Mode = Volume ## Number of cosmetic boxes to target per level. ## 1-20 = target box count ## Changes apply on the next level load. # Acceptable values: 1-20 # Default: 3 BoxCount = 3 [RarityWeights] ## Rarity weights are ratios, not percentages. ## Example: 60:25:12:3 gives ~60% Common, ~25% Uncommon, ~12% Rare, ~3% UltraRare. ## Setting all four to the same value gives equal 25% chance per tier. # Acceptable values: 0-100 # Default: 60 CommonWeight = 60 # Acceptable values: 0-100 # Default: 25 UncommonWeight = 25 # Acceptable values: 0-100 # Default: 12 RareWeight = 12 # Acceptable values: 0-100 # Default: 3 UltraRareWeight = 3