GuaranteedCosmeticCrate
GuaranteedCosmeticCrate is a BepInEx mod for REPO that improves the vanilla cosmetic crate spawn system while keeping full compatibility with the game's original logic.
Instead of replacing REPO's spawning system, this mod extends it.
Features
Vanilla Compatible
The mod uses REPO's internal:
SetupHost()SpawnCosmeticWorldObject()- cosmetic spawn curves
- bad luck system
No manual Photon spawning.
Guaranteed Cosmetic Crate
If vanilla fails to spawn a cosmetic crate:
- the mod detects it
- logs the result
- safely forces 1 cosmetic crate
If vanilla already spawned one:
- nothing is modified
- no duplicate spawn
Better Rarity Chances
Optional rarity multipliers allow better crates to appear more often.
Configurable:
- Rare chance multiplier
- UltraRare chance multiplier
- Global cosmetic spawn multiplier
Multiplayer Safe
Uses REPO's own spawning system.
Compatible with:
- Host
- Multiplayer
- Photon sync
- Vanilla networking
Console Logging
Detailed console logs included.
Examples:
[GuaranteedCrate] Vanilla already spawned crate(s): 1
[GuaranteedCrate] No vanilla cosmetic crate detected.
[GuaranteedCrate] Forcing cosmetic crate spawn...
[GuaranteedCrate] Selected rarity: UltraRare
[GuaranteedCrate] Cosmetic crate spawned successfully
Useful for:
- debugging
- testing spawn rates
- verifying compatibility
Installation
Requirements
Install
- Install BepInEx
- Place:
GuaranteedCosmeticCrate.dll
inside:
REPO/BepInEx/plugins/
- Launch the game once.
Config file will be generated automatically.
Configuration
Config location:
REPO/BepInEx/config/nzoow.repo.guaranteedcosmeticcrate.cfg
Example:
[General]
GuaranteedCrate = true
SpawnChanceMultiplier = 1.5
[Rarity]
RareMultiplier = 1.5
UltraRareMultiplier = 2.0
[Debug]
VerboseLogs = true
Config Options
GuaranteedCrate
Guarantees at least one cosmetic crate.
Default:
true
SpawnChanceMultiplier
Boosts vanilla cosmetic spawn chance.
Default:
1.5
RareMultiplier
Boosts Rare crate weight.
Default:
1.5
UltraRareMultiplier
Boosts UltraRare crate weight.
Default:
2.0
VerboseLogs
Enables detailed console logs.
Default:
true
Technical Details
The mod:
- patches
ValuableDirector.SetupHost()
- checks
cosmeticWorldObjectTargetAmount
- rolls rarity using vanilla
chanceCurve
- calls
SpawnCosmeticWorldObject() through reflection
- preserves
cosmeticWorldObjectBadLuckCount
No hardcoded crate prefabs.
No unsafe Photon spawning.
Compatibility
Designed for:
- REPO
- BepInEx 5
- Multiplayer
Should work with most gameplay mods.
Credits
Created by nzoow
Powered by:
- BepInEx
- Harmony
- Photon
- REPO reverse engineering
