MoreShopUpgrades

New permanent shop upgrades, a manual fire mode with stamina and weapon swap, and quality-of-life tweaks for Megabonk. Built and tested against game version 1.0.69 with BepInEx 6 IL2CPP (be.755).

The mod is two plugins: MorePots (almost everything) and MoreSlots (extra tome and weapon slots). Every feature can be turned off or retuned in the config.

Contents

• Shop upgrades
• Changes to the game's own upgrades
• Manual fire
• Quality of life
• Behind the scenes
• Installation
• Configuration
• Updating and uninstalling
• Troubleshooting
• Credits

Shop upgrades

New upgrades keep their levels in this mod's own file, never in your game save.

• Refunds undo one level at a time and return what that level costs now.
• Each upgrade's shop description lists every level's effect, with your current level highlighted.

Changes to the game's own upgrades

Manual fire

On by default: weapons no longer attack on their own. They fire when you press the fire button (left mouse, or R1 / RB on a controller). To get the game's normal auto attacks back, set Enabled = false under [ManualFire] in the config.

• Stamina.
  • Each fire action costs stamina for every weapon it fires.
  • Stamina refills while you're not firing.
  • The stamina bar shows under the character.
  • The Fire Rate upgrade limits how often you can fire (one action per 0.5 s, more with upgrades).
• Auto Fire. Without the Auto Fire upgrade, each press fires once. With it, holding the button keeps firing.
• Passive weapons (Aura, Dragon's Breath, Frostwalker, Space Noodle).
  • They stay on but deal 10% damage, and show gray, until triggered.
  • Each trigger gives them a full-damage window and their normal colour.
  • Holding with Auto Fire keeps them at full damage.
  • Aegis and Chunkers are unaffected and work as usual.
• Weapon swap.
  • D-pad left / right cycles through your weapons, then All.
  • On the keyboard, the number keys pick directly: 1 to N for each weapon, N+1 for All.
  • A popup in the bottom left shows the choice, with the neighbouring options at its sides.
• Fire feedback.
  • Other weapons play the jump sound and a dust cloud, and the character briefly grows, on each fire action. While holding, these repeat at the fire rate.
  • Passive weapons play the stage portal sound and a dust cloud when triggered. A charging sound loops while you hold.
• Controller jump. On a controller only A jumps, so R1 can fire without jumping. L2 stays as aim, and keyboard Space still jumps.
• Manual fire and weapon swap only work during a run.

Quality of life

• Linear keys. Each key adds a flat 10% free-chest chance, so 5 keys give 50% and 10 keys give 100%.
• Toggle everything. Every unlocked weapon, tome and item can be toggled off with the Toggler.
• Chest skip. Press jump (Space, or the A button) to skip the chest opening animation.
• Stage timer rewind / skip. Use [ / ] in a run, or the Rewind 30s / Skip 30s buttons added to the pause menu.
• Menus from the start. The Shop, Unlocks, Quests, Quick Quests and Leaderboards are available from your first run. Normally they unlock after 1 to 6 runs.
• Reset Progress. A main menu button asks for confirmation in the game's own yes/no box.
  • It wipes your progress and this mod's upgrade levels. Your settings are kept.
  • The save and this mod's files are backed up first to BepInEx/backups/<date-time>/.
  • Restart the game after a reset.

Behind the scenes

• Pot performance. Pots don't cast shadows and use GPU instancing, which keeps the high pot counts from More Pots cheap.
• Performance monitor. Off by default. It logs FPS, the worst frame and the enemy count during a run.
• Fold check. At startup, it warns in the log if a patched game method shares its native code with an unrelated one. This is a safety check against a class of IL2CPP bugs.

Installation

Option A: r2modman or Thunderstore Mod Manager (easiest)

1. Install the mod from the mod manager, or use Settings > Import local mod with this zip.
2. The manager installs the required BepInExPack_IL2CPP 6.0.755.
3. Start the game with Start modded.

Option B: manual install

1. Install BepInEx 6 IL2CPP (be.755, Windows x64) into the game folder, usually C:\Program Files (x86)\Steam\steamapps\common\Megabonk. BepInEx\, winhttp.dll and doorstop_config.ini should sit next to Megabonk.exe.
2. Run the game once, then close it. The first launch is slow while BepInEx generates its files. When it finishes, you have BepInEx\plugins\ and BepInEx\interop\.
3. Create BepInEx\plugins\MoreShopUpgrades\ and copy MorePots.dll and MoreSlots.dll into it.
4. Start the game normally from Steam.

Check that it worked

• BepInEx\LogOutput.log contains Loading [MorePots ...], Loading [MoreSlots ...] and a line like MorePots ... loaded.
• The shop lists the new upgrades (More Pots, Silver Pots, Auto Fire, Stamina, ...).

Configuration

These files are created in BepInEx\config\ on first launch:

Close the game before editing, then relaunch.

• Turn off manual fire: set Enabled = false under [ManualFire].
• Controller buttons: the defaults are R1 to fire and D-pad left / right to swap weapons.
  • If your controller names its buttons differently, set LogControllerButtons = true under [ManualFire]. The log then names each button as you press it.
  • Put those names in PadButtonNames (under [ManualFire]) and in NextButtons / PreviousButtons (under [WeaponSwap]).
• Effects and sounds:
  • WeaponFx, WeaponGrowScale and PassiveDustSize change the weapon effects.
  • PassiveHoldCharge and PassiveHoldClipName change the passive hold sound.
  • PassiveIdleTint and PassiveIdleColor change the passive gray tint.

Updating and uninstalling

Updating: replace the two DLLs in BepInEx\plugins\MoreShopUpgrades\, or update in the mod manager. Your configs and upgrade levels are kept.

Uninstalling:

1. Refund the extra tome and weapon slot levels in the shop first. Those are stored in the game's own save. The other upgrades live only in this mod's file and leave nothing in your save.
2. Delete BepInEx\plugins\MoreShopUpgrades\, or remove the mod in the mod manager.
3. To remove BepInEx completely, also delete BepInEx\, winhttp.dll, doorstop_config.ini and dotnet\ from the game folder.

Troubleshooting

• Nothing changed in game.
  • Check that BepInEx\LogOutput.log exists and is recent.
  • If it doesn't, BepInEx isn't loading. Make sure winhttp.dll is next to Megabonk.exe.
• Errors after a game update. The mod is built for game version 1.0.69 and may need an update for newer versions.
• Undo a Reset Progress. Backups are in BepInEx\backups\<date-time>\, with a RESTORE.txt explaining the steps.

Credits

• The linear key chance idea comes from IntuitiveKeys by Twinzet.
• Toggle everything comes from ToggleEverything by Semibox/Slimaeus (BepInEx port by Intancote).
• The stage timer rewind/skip approach comes from GoblinLab by Compton.