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

1. Install BepInEx.
2. Copy the compiled KeepContraband.dll into: BepInEx/plugins/
3. 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).

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.