KeepContraband

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).