
KeepContraband
Keep cleansed Contraband permanently and adds a 5% chance for Exotic world drops outside Ouroboros to be replaced with eligible Contraband.Keep Contraband
Description
Contraband upgrades felt too interesting to be limited to Ouroboros alone, especially for experimenting with different builds, so I created this mod to play around with them in normal game modes.
Features
Permanent Contraband
Contraband upgrades cleansed in Ouroboros become permanent and remain available in your inventory for future runs.
The mod does not add scrap prices to Contraband upgrades, so scrapping a permanent Contraband gives no resources.
Contraband outside Ouroboros
Whenever the game generates an Exotic world drop outside Ouroboros, there is a 5% chance that the Exotic is replaced with a random eligible Contraband upgrade.
This replacement only applies after the game has already selected an Exotic drop. It is not a 5% chance on every upgrade drop.
Duplicate protection
Permanent Contraband upgrades already owned by the player are excluded from normal-mode Contraband drops.
Exceptions:
- Cosmic Microwave is checked by element. Different elemental variants may be collected, while another copy of an already owned element is prevented.
- Duplicate protection is not applied inside Ouroboros, where the original game behaviour is preserved.
- If no eligible unique Contraband is available, the original Exotic drop is kept.
Original Ouroboros progression
The original Ouroboros gameplay and Cleanse system remain unchanged, providing the original way to obtain Contraband alongside normal-mode drops.
Description adjustments
Outside Ouroboros, obsolete collection-effect text is hidden for Fake ID (Biologicals Only) and Interim Manager because those collection effects do not apply to permanent copies.
Requirements
- Mycopunk
- BepInEx 5.x
Installation
- Install BepInEx.
- Copy the compiled
KeepContraband.dllinto:BepInEx/plugins/ - Launch the game.
Compatibility
The mod should be compatible with most BepInEx mods.
Conflicts may occur with mods that patch or alter the same systems, particularly:
PlayerData.RentRandomUpgrade(UpgradeFilterParams)PlayerData.CreateUpgradeInstance- Contraband generation or inventory visibility
- Ouroboros Cleanse logic
- upgrade grid-size calculations
- upgrade description generation
Permissions
Anyone may use, modify, repackage, improve, or redistribute this mod. Permission is not required.
Credits
Created with assistance from ChatGPT (OpenAI).