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.

1.4.1

• Added a link to a gameplay video to the mod description. No changes to the mod itself.

1.4.0

• Weapon swap:
  • Switching weapons plays the pot breaking sound. PotBreakSound = false under [WeaponSwap] turns it off.
  • The popup turns like a carousel: icons slide one step over, the new choice pops in, the old one shrinks away, and the next one fades in.
  • Switching again while the popup is up just turns it. The popup no longer drops and slides up again.
  • The All choice shows a blue XP gem labelled "ALL WEAPONS".
• The download now also comes as a Nexus Mods zip that extracts straight into the game folder.

1.3.0

• Manual fire (on by default; Enabled = false under [ManualFire] turns it off): weapons fire when you press the fire button (left mouse, or R1 / RB), and each fire action costs stamina.
  • Passive weapons stay on at 10% damage, shown gray, until triggered. Aegis and Chunkers are unaffected.
  • Weapon swap: D-pad left / right or the number keys pick one weapon or All, with a popup.
  • Fire feedback: jump sound, dust and a brief character grow for weapons. Passive weapons get a portal sound, dust, and a charging loop while held.
  • On a controller only A jumps, so R1 doesn't also jump.
• New upgrades: Auto Fire (200), and Stamina, Efficiency, Fire Rate and Recharge (50 / 100 / 150 per level).
• Silver Pots now costs 50 silver, and Auto Shrine Rewards costs 300.
• Shop descriptions list every level's effect, with your current level highlighted.

1.2.0

• New upgrades:
  • Auto Pots (6 levels): pots in range break automatically, and their silver flies to you.
  • Faster Shrines (10 levels): charge shrines fill faster, and level 10 is instant.
  • Auto Shrine Rewards (free): charge shrine rewards are picked for you, instantly, with no window.
• More Pots has a 5th level (32x pots).
• The Silver upgrade is retuned: +10% silver per level, and level N costs 50 x N.
• The Shop, Unlocks, Quests, Quick Quests and Leaderboards are available from the first run.
• Fixes:
  • The level-up Banish, Skip and Refresh buttons are reachable again with More Choices.
  • There's no longer a gap above the level-up options.
  • More Choices no longer breaks the game's asset loading.

1.1.1

• Fixed Reset Progress. It now resets your progress: characters, unlocks, tomes, weapons, stats and silver. Before, it only reset the game's settings.
• Reset Progress now asks for confirmation in the game's own yes/no box.
• Your settings (graphics, audio, controls, gameplay) are kept through a reset. Only progress and the menu intro flags are reset.
• Resetting settings from the game's Settings screen no longer resets this mod's upgrades.

1.1.0

• The main menu has a new Reset Progress button, which opens the game's own reset confirmation.
• Before any reset, including the one in Settings, the game save and this mod's config files are backed up to BepInEx/backups/<date-time>/. The backup includes a RESTORE.txt with restore steps.
• After a reset, this mod's upgrade levels are set back to 0.
• The Rewind 30s and Skip 30s pause menu buttons now size to fit their text.

1.0.0

Initial release.

• Shop upgrades:
  • extra tome and weapon slots
  • More Pots
  • Silver Pots
  • Slow Timer
  • More Choices
• Linear keys, toggle everything, and jump-to-skip for the chest animation.
• Stage timer rewind and skip, using hotkeys or the pause menu buttons.
• Performance improvements for pots.