Guaranteed Cosmetic Crate

Tired of endless runs without finding any rare cosmetic crates? This mod grants you full control over the cosmetic box spawn rates in R.E.P.O., allowing you to guarantee high-tier drops or fully customize your lobby experience.

Whether you want to perfectly balance the vanilla game or turn every single box on the map into an Ultra Rare chest, this mod has you covered!

🚀 Key Features

• Guaranteed Crate Spawn: Dynamically forces at least one cosmetic box to spawn on the map right at the start of the round.
• Vanilla Spawn Controller: Added a dedicated toggle to completely disable the built-in game spawn engine. When disabled, ONLY your customized mod boxes will appear on the map.
• Hardcore Rarity Forcing (Spawn Only): Force the game to spawn strictly one specific type of cosmetic box (Common, Uncommon, Rare, or Ultra Rare) across the entire level.
• Intelligent Ref-Swapping: Uses advanced Harmony patching to dynamically alter vanilla box rarities in memory right as they spawn, preventing map generation glitches or out-of-bounds drops.
• Clean & Optimized Logging: Colorful console feedback (Green for mod injections, Orange for blocked vanilla bypasses) so you can easily verify the mod's performance in real-time.

⚙️ Configuration Guide

After running the game with the mod installed for the first time, a configuration file named nzoow.repo.guaranteedcosmeticcrate.cfg will be generated inside your BepInEx/config/ folder.

You can edit it manually or use Thunderstore Mod Manager / r2modman to tweak the following settings:

[General]

• GuaranteedCrate (Default: true) — Guarantees at least one cosmetic crate spawn per round.
• VanillaSpawnEnabled (Default: false) — Crucial Setting. If true, the vanilla game will spawn its own boxes alongside the mod. If false, the mod takes full control, blocking all default spawns and replacing them with your custom rates.
• SpawnChanceMultiplier (Default: 1.5) — General multiplier for the default cosmetic box distribution logic.

[Rarity Multipliers]

Adjust the weight for each rarity tier if Spawn Only mode is disabled:

• CommonMultiplier (Default: 0.3)
• UncommonMultiplier (Default: 0.5)
• RareMultiplier (Default: 4.0)
• UltraRareMultiplier (Default: 2.0)

[Spawn Only Mode]

• Spawn only one type of boxes mode (Default: false) — Enable this to turn off randomized calculations and strictly force a specific tier.
• Spawn only Common Boxes (Default: false)
• Spawn only Uncommon Boxes (Default: false)
• Spawn only Rare Boxes (Default: false)
• Spawn only UltraRare Boxes (Default: false)

🛠️ Installation

1. Make sure you have BepInEx 5 and Harmony installed.
2. Download this mod and extract the GuaranteedCosmeticCrate.dll file into your BepInEx/plugins/ folder (or simply click Install with Mod Manager on Thunderstore).
3. Launch the game and enjoy your custom loot hunt!

🤝 Developer

• Developed by nzoow.
• Includes AI content