ArceDev-ExoticUpgrades icon

ExoticUpgrades

Unlock and configure exotic effects for each firearm and melee model.

By ArceDev
Last updated 2 months ago
Total downloads 7983
Total rating 2 
Categories Mods AI Generated
Dependency string ArceDev-ExoticUpgrades-0.4.0
Dependants 1 other package depends on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2305 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2305
ArceDev-UpgradeCore-0.1.0 icon
ArceDev-UpgradeCore

Developer API for registering upgrades and managing persistent player ownership and activation.

Preferred version: 0.1.0
ArceDev-StatusCore-0.1.0 icon
ArceDev-StatusCore

Developer API for authoritative timed player statuses, synchronization, and native HUD presentation.

Preferred version: 0.1.0

README

🎰 Exotic Upgrades

Feed drip fish to the Reel of Fortune for a chance to unlock absurd new powers for your guns, Knife, and Knuckles. Exotic rewards coexist with regular skins and follow each island's native item pool, so you will not unlock upgrades for gear from later islands.

✨ Exotic upgrade pool

Identity Upgrade What it does
đŸŸŖ 🧲 Homing Bullets Steers projectiles toward nearby living creatures.
🟠 đŸ’Ĩ Explosive Bullets Adds a native-style explosion on impact.
🔴 â†Šī¸ Ricochet Reflects projectiles from level and boat surfaces.
đŸ”ĩ 🐌 Slow-Mo Bullets Gives every affected weapon the same clearly visible projectile speed.
🟡 🔱 Split Shot Turns each original shot into a horizontal projectile spread.
đŸŸĸ âš”ī¸ Cleave Knife and Knuckles strikes damage nearby extra targets.
đŸŸĨ đŸ’Ē Heavy Hitter Gives Knuckles much stronger knockback without adding damage.
🍷 🩸 Bleed Knife hits make enemy players bleed over time.
🟨 1-2 One-Two Knuckles automatically follow a landed punch with a weaker second punch.
đŸŸĻ đŸŽ¯ CoD-Like Holding Knife attack pursues the nearest visible target inside your current FOV and strikes once.

Pools by weapon type

Weapon type Available exotic upgrades
Firearms Homing Bullets, Explosive Bullets, Ricochet, Slow-Mo Bullets, Split Shot
Knife Cleave, Bleed, CoD-Like
Knuckles Cleave, Heavy Hitter, One-Two

All values can be changed in the generated BepInEx configuration file.

🎮 Controls

Hold the inspection key while using the normal skin/reload controls:

Action Default keyboard input
Inspect the held item and show exotic upgrades F
Select the previous unlocked upgrade Hold F + press Z
Select the next unlocked upgrade Hold F + press C
Enable or disable the selected upgrade Hold F + press R

The in-game instructions use your current bindings, so rebinding these actions is supported.

🔓 Unlocks and loadouts

  • Unlocks are permanent for the local player and apply to a specific item model.
  • Multiple compatible exotic upgrades can be active on the same item.
  • Each unlocked upgrade can be enabled or disabled independently.
  • Firearms, Knife, and Knuckles each receive only their compatible upgrade pool.
  • Native sights, suppressors, magazines, damage upgrades, lasers, and weapon skins continue to work normally.

🌐 Multiplayer

The mod is required for every player in the lobby. Projectile effects and melee hit metadata are synchronized; the server applies explosions, cleave damage, and player bleeding. Bleeding uses NativeStatusUI for its timed wine-red droplet indicator.

âš™ī¸ Configuration

After launching the game once, edit BepInEx/config/ArceDev.ExoticUpgrades.cfg to tune gacha chance and every firearm or melee effect.

AI Disclosure

This mod was developed with assistance from generative AI for programming, documentation, and promotional artwork. The author reviewed, tested, and approved the final implementation and assets.