KeepContraband
Keep cleansed Contraband permanently and adds a 5% chance for Exotic world drops outside Ouroboros to be replaced with eligible Contraband.
Screenshots 1 screenshots
About this mod Author’s original text
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.
The mod allows Contraband upgrades to appear in the original Ouroboros
Cleanse menu, allowing them to be cleansed just like any other upgrade.
Once cleansed, they become permanent and remain available for future
runs.
Whenever the game generates an Exotic world drop outside the Ouroboros
mode, there is a 5% chance that it will be replaced with a random
eligible Contraband upgrade.
Features
Cleanse support for Contraband upgrades
Contraband upgrades can now appear in the original Ouroboros Cleanse
menu.
After paying the normal Cleanse cost, they become permanent and remain
available in your inventory for future runs.
The original Cleanse costs are unchanged.
The mod does not add scrap prices to Contraband upgrades, so scrapping a
permanent Contraband upgrade gives no resources.
Contraband upgrades outside Ouroboros
Whenever the game generates an Exotic world drop outside the
Ouroboros mode, there is a 5% chance that the Exotic upgrade will be
replaced with a random eligible Contraband upgrade.
This replacement only occurs after the game has already selected an
Exotic world 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 upgrade drops.
Exceptions
- Cosmic Microwave is checked by element. Different elemental
variants may still be collected, while duplicate copies of the same
element are prevented.
- Duplicate protection is not applied inside the Ouroboros mode,
preserving the original game behaviour.
- If no eligible unique Contraband upgrade is available, the original
Exotic upgrade is kept.
Original Ouroboros progression
The original Ouroboros gameplay remains unchanged.
The mod only extends the existing Cleanse system by allowing Contraband
upgrades to appear in the Cleanse menu. All other Ouroboros mechanics
remain vanilla.
Requirements
- Mycopunk
- BepInEx 5.x
Installation
- Install BepInEx.
- Copy KeepContraband.dll into:
text
BepInEx/plugins/
- Launch the game.
Compatibility
The mod should be compatible with the vanilla game and most BepInEx
mods.
Conflicts may occur with mods that modify the same systems,
particularly:
- PlayerData.RentRandomUpgrade(UpgradeFilterParams)
- PlayerData.CreateUpgradeInstance
- Contraband upgrade generation or inventory visibility
- Ouroboros Cleanse logic
- Upgrade grid-size calculations
- Upgrade description generation
Permissions
Anyone may use, modify, improve, repackage, or redistribute this mod.
Permission is not required.
Credits
Created with assistance from ChatGPT (OpenAI).
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: