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

1. Install BepInEx.
2. Copy KeepContraband.dll into:

BepInEx/plugins/

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

Changelog

1.0.0

• Cleansed Contraband remains permanently available.
• Added a 5% chance to replace an Exotic world drop outside Ouroboros with an eligible Contraband.
• Added duplicate protection for permanent Contraband.
• Added element-aware duplicate protection for Cosmic Microwave.
• Preserved the original Ouroboros and Cleanse behaviour.
• Restored functionality for permanent Contraband effects that depend on inventory or grid refreshes.
• Added support for Multiversal Thievery outside Ouroboros.
• Removed obsolete collection-effect text from Fake ID (Biologicals Only) and Interim Manager outside Ouroboros.
• If no eligible unique Contraband is available, the original Exotic is retained.