Megabonk Community Patch

⚠ Work in Progress — Actively developed. Expect bugs and frequent updates.

Support Development

This mod takes a lot of time and effort to build and maintain. Donations are greatly appreciated and go directly toward continued development.

• Ko-fi: https://ko-fi.com/pheeesh
• PayPal: https://www.paypal.com/donate/?hosted_button_id=A27J3XGS5HDMG

Homage

Our map scanner was inspired by Aluielll's work on BonkScanner. If you appreciate where the idea came from, consider supporting him: https://www.patreon.com/cw/ALuiel

A community-driven balance and quality-of-life mod for Megabonk.

Community Leaderboard

• Replaces the Steam leaderboard with a shared community leaderboard
• Global / Friends / Personal (best run per character) tabs; weekly + lifetime modes
• Map filter (All/Forest/Desert/Graveyard) and character filter; mouse wheel scrolling with correct rank numbers
• Server rejects submissions from outdated mod versions; in-game warning banner if your mod is out of date
• Unauthorized mods detected at startup — score submission blocked and warning banner shown
• F1 menu features disable leaderboard for the run and show a warning banner

Gameplay

• Fast Fall — hold Slide while airborne to fast fall
• Full Heal — heart powerup fully heals instead of partial
• Pots — drop a random powerup instead of always health
• Greed Shrine — also grants +5% XP and +5% luck
• Microwaves — default spawn count raised to 2 (max 3)
• Cursed Sword — auto-aims the nearest enemy using holy-sword math (slope-parallel swings)
• Sucky Magnet — pulls drop chests (and placed free chests) toward you on each suck pulse

Characters

• Starting kits — every character begins each run with built-in items (shown in character select and the unlocks menu):

  Character	Starts with
  Fox	Dragonfire
  Oofie	Spiky Shield + 2× Cactus
  Calcium	Rollerblades + Turbo Socks + Coward's Cloak + Tactical Glasses
  Megachad	Mirror
  Ogre	Big Bonk
  Clank	Grandma's Secret Tonic + Forbidden Juice
  Athena	2× Cactus + Quin's Mask
  Robinette	Key + Golden Sneakers + Golden Glove
  Monke	Overpowered Lamp + Tactical Glasses
  Tony	Backpack + Battery
  Bush	Fork + Forbidden Juice
  Birdo	Feather + Eagle Claw + Tactical Glasses
  Noelle	Ice Crystal + Ice Cube
  Amog	Cheese + Moldy Gloves + Toxic Barrel + Snek
  Spaceman	Echo Shard + Time Bracelet + Shattered Wisdom
  Bandit	Joe's Dagger + Battery
  Ninja	2× Evasion Shroud + 2× Slippery Ring
  Vlad	Bloody Cleaver + Unstable Transfusion
  Chadwell	Chonkplate + Skuleg
  Dicehead	Wrench + Beacon
  Roberto	Ghost + Bob (Dead) + Tactical Glasses

• Stats — all characters normalized to minimum 1.2× speed, jump 10, pickup range 10. Characters with no starting shield receive +10 shield.

• Roberto — Hoarder passive also grants +0.5% elite spawn and +0.5% elite damage per level

Weapons

• All Weapons — +10% crit chance and +20% crit damage added to upgrade pool; knockback option removed
• Bow — cooldown 0.92s → 0.45s; Bow / Revolver — +2 projectiles per level upgrade instead of +1
• Sniper — post-burst cooldown roughly halved; tighter bursts
• Scythe — attack rate roughly doubled (endCooldown 0.85s → 0.425s, burstTime 1.5s → 0.75s)
• Black Hole / Mine / Hero Sword / Poison Flask / Sword / Corrupt Sword — fire-rate increases
• Blood Magic — faster; 35% chance to apply Bloodmark
• Space Noodle — cooldown/damage rework
• Flamewalker — 2× damage and size; AoE centered on player
• Bluetooth Dagger — correctly triggers Lightning Orb stun (element fix)
• Aura weapons — +0.15 attack speed upgrade option

Tomes

• Balance Tome — rarity-scaled % to every stat per take (29 stats, including Difficulty but excluding move speed and jump height; Common 1% up to Legendary 2%). Card shows the take, hover shows the run total.
• Hoarder Tome — chest drip decays over run time (full chest early, crumbs late); live "next chest" % in the description. Descriptions fixed everywhere.
• Chaos Tome — tooltip shows running totals of granted stats. Some stats removed from the chaos/gamble/shrine pool (see Stat Toggles).

Items

• Item Caps — Anvil (max 2), Overpowered Lamp (max 2), Za Warudo (max 10, pool-removed at 50 total)
• Grandma's Secret Tonic / Spicy Meatball / Quin's Mask — size caps enforced; pool slot removed once capped
• Backpack — +2 projectiles per stack instead of +1
• Brass Knuckles — size cap removed
• Bob's Lantern — fire rate doubled; now Legendary
• Power Gloves — on-hit damage buffed ~9×
• Key — 20% chest-open chance per stack
• Green Credit Card — chest price increase reduced from 10% to 0% per card
• Cursed Doll — 50% max HP damage (was 30%), 7 curses per doll; now Legendary
• Spiky Shield — 50% armor per stack (was 10%); now Legendary
• Leeching Crystal — −0.75 regen, +100 max HP; Kevin — 50% proc chance
• Echo Shard — overflow chance rolls extra shards
• Golden Ring — +1 banish per ring; drop chance 1/128
• Golden Shield — removes reduced gold penalty on Kevin self-damage
• Clover / Skuleg — multiplicative Luck / Difficulty bonuses

Rarity & Toggle Changes

Stat Toggles (Chaos / Gamble pool)

Curate which stats can roll from Chaos rolls, Gamble Tome, Dicehead passive, and Charge Shrines. Open the toggle menu with F3. Choices persist via config and apply live mid-run.

Level-Up

• Auto-Select Upgrade (F10) — toggle the game's built-in highest-rarity auto-pick. When ON, level-ups are chosen automatically. When OFF, you pick manually.
• Priority Sort — when the Priority List is ON, level-ups skip the offer screen and auto-pick your highest-priority item instead of the game's highest-rarity pick.
• Swap Starter Weapon (shop unlock) — your first level-up weapon pick replaces your starting weapon; the offer is guaranteed

Meta Shop Unlocks (1,000 silver each, refundable, saved)

• Extra Tome Slot — unlock a 5th tome slot, every run
• Swap Starter Weapon — first level-up weapon pick replaces your starter, every run
• Pot & Hat Gate — opt-in gating: Pot needs a level-40 weapon, Wizard Hat a level-99 tome to appear (ungated by default)

Bosses

• BOMBUS — giant Bee boss (15× scale). First appears 15 minutes into overtime (later on later stages), then every 5 minutes — multiple can be alive at once. Killable but debuff-immune with massive HP; gets faster over time and the smaller it shrinks. Drops a Corrupt chest on death.

Minimap & Map

• Custom 128px icon set with per-icon sizes, recolorable outlines (color picker with screen dropper), and toggles — all in the native Map settings tab
• Map Scanner (F4/F5) — pick map feature counts (shrines, microwaves by tier, moais, shady guys, curses) and auto-reroll runs until a map matches

Combat Scaling

• Mob HP ×2

Controls

All hotkeys rebindable in the native Community Patch settings tab.

Discord

Bug reports and feedback: https://discord.gg/BsqCqsX63u

Source

https://github.com/TurnipTheBeet/Megabonk---Community-Patch

AI Disclosure

This mod was developed with AI assistance (Claude by Anthropic).

Changelog

1.5.3

• Pot/Hat gate is one-shot: returns each item once at threshold, never touches pool again (banishes stick)
• Priority list reads equipped gear + auto-refreshes; Clover/Skuleg/Ring/Juice go in the true multi bracket

1.5.2

• Clank kit gains Forbidden Juice

1.5.1

• Removed mob HP doubling; Balance Tome drops move speed + jump height (29 stats)
• Priority Sort overrides auto-pick by priority, respects caps; pot/hat gate respects banishes
• Perf: hot-path hooks moved to events/data; shared icon materials; throttled egg/rotation work
• Reset Menu Positions button; Lamp cap 3; log warning cleanup
• Priority list reads equipped gear (not toggle pool), auto-refreshes on open
• Other-mods banner warns those mods may cause your bugs

1.5.0

• Starting kits for all 21 characters (shown in character select + unlocks menu)
• Balance Tome scales by rarity (1–2%); card shows take, hover shows run total
• Hoarder Tome rework: time-decayed chest drip with live next-chest %
• Meta shop unlocks (1k silver each): 5th tome slot, swap starter, pot/hat gate
• Map settings: baked defaults, Reset All, picker Def restores default; Forest filter includes untagged runs
• Map Scanner (F4/F5) auto-rerolls for shrines/microwaves/moais/shady/curses
• Custom minimap icons + outline masks; fullscreen icons snap north; Cursed Sword aim rework; Sucky Magnet chest pull; game-glyph keycaps; hitch fixes
• Priority Sort overrides auto-pick by priority; hotkey defaults Space/F7/F8/F9
• Perf: hot-path hooks moved to events/data; shared icon materials; Balance Tome drops move speed + jump height

1.4.1

• Added Map Scanner: pick how many map features you want, then auto-reroll the run until a map matches and it stops + pauses. Criteria: Moais, Shady Guys, a combined Moai+Shady count, Boss Curses (exact match), total Microwaves, and Microwaves by tier (Common/Rare/Epic/Legendary). Two rebindable hotkeys in the Community Patch settings tab — F4 opens the window, F5 starts/stops the scan. Runs fully in-process (reads the game's own interactable counts and uses its own restart, no external tool).
• Added a native "Community Patch" tab in the game's Settings menu: rebind every mod hotkey, and adjust the new sliders below — no config-file editing needed.
• Added three SFX volume sliders (Weapon / Hit / Item) in the settings tab, so you can tune or mute combat and item sounds independently of the game's master volume. (Note: some on-hit item effects share the game's generic impact sound and are scaled by the Hit slider.)
• Added a Mod Menu Opacity slider (settings tab) to set the background opacity of the mod's own windows.
• Added Priority Targeting: replaces auto-aim target selection with a scorer that prioritises bosses/elites, then the nearest enemy you can kill soonest (avoids leaving low-HP stragglers alive). Toggle hotkey in the settings tab.
• Added Scaling Auto-Upgrade: auto-picks level-up choices using a bucket system that favours run-defining scaling (new weapons/tomes & legendaries first, then XP/Difficulty, then luck/weapons), weighted by rarity and endgame stat importance. Comes with an Auto-Upgrade Log window (newest-first) showing what it picked and over what. Difficulty (Cursed) stops being prioritised once it hits the 600 effective cap.
• Added Smart Skip Chest Animation: auto-enables chest-open skipping when you run out of banishes, turns it back off when you gain a Golden Ring, and resets after each run.
• Added Fast Fall: hold the bind (default Left Ctrl) while airborne to drop faster.
• Added a Game Speed hotkey (default T) that toggles between 1x and 2x. Counts as a cheat, so it blocks leaderboard submission for that run.
• Added an Effects Opacity hotkey (default F11) that toggles the game's Settings > Effects particle opacity between 0% and 100%.
• Power Gloves: on-hit damage buffed roughly 9x (~22 → ~200 per hit) so it's actually useable.
• Rarity changes: Golden Shield moved Rare → Epic; Slurp Gloves moved Epic → Rare. Their baked rim colors are recolored to match (now correctly limited to the outer outline only).
• Key: chest open chance per stack changed to 15% (from the previous 20%), tooltip updated to match.
• Leaderboard moved to a dedicated VPS host (more reliable uptime); personal and global submission unchanged.

1.4.0

• Fixed fire-rate buffs that weren't applying: Black Hole (3×), Mine, Hero Sword, Poison Flask, Sword, and Corrupt Sword (2× each). The previous tweak only lowered the in-burst projectile spacing, which has no effect on these single-shot weapons; now scales the actual cooldown/burst timing so they really fire faster.
• Reverted the weapon/tome shop slot changes back to vanilla (base 2, buy up to 4). The earlier 1-slot-minimum change wrote an out-of-range shop level into the save, so after switching versions vanilla read it as a 5th tome/weapon slot even with the mod removed. Note: saves already affected need a one-time refund + rebuy of the slots in vanilla to clear it.
• Fixed item rarity rim color not updating for items we moved to a new rarity (e.g. Sucky Magnet Legendary→Epic, Backpack Rare→Common). The baked rim is now recolored at the source, so it shows correctly on every UI surface — unlocks menu, in-run inventory/pause menu, Shady Guy shop, and the world-drop/HUD icon.

1.3.19

• Reverted the weapon/tome shop slot changes back to vanilla (base 2, buy up to 4). The earlier 1-slot-minimum change wrote an out-of-range shop level into the save, so after switching versions vanilla read it as a 5th tome/weapon slot even with the mod removed. Note: saves already affected need a one-time refund + rebuy of the slots in vanilla to clear it.
• Fixed item rarity rim color not updating for items we moved to a new rarity (e.g. Sucky Magnet Legendary→Epic, Backpack Rare→Common). The baked rim is now recolored at the source, so it shows correctly on every UI surface — unlocks menu, in-run inventory/pause menu, Shady Guy shop, and the world-drop/HUD icon.

1.3.18

• Turbo Juice: now activates while you are moving instead of standing still (movement detected via player velocity, frame-rate independent)
• Idle Juice renamed to Turbo Juice
• Quin's Mask: size cap added (baseRadius 4, radiusPerAmount 2, maxRadius 16 — max 6 stacks; pool slot removed when cap reached)
• BOMBUS overhaul: now killable (invulnerability removed, debuff immunity kept); first spawn at 15 min overtime then every 5 min, stacking (multiple alive at once); boss-tanky HP (20x the bee's natural overtime-scaled HP); gets faster over time and the smaller it shrinks (up to ~2x); drops a Corrupt chest on death
• Corrupt chest fix: the game's evil/corrupt chest was missing its mesh and material (rendered magenta) — visuals now filled from the normal chest so it displays correctly; Corrupted-rarity loot pool is empty in the live game, so corrupt chests now give a guaranteed Golden Ring
• Corrupt chest now spawns on the ground (downward raycast) instead of floating at the bee's center; bee corpse colliders disabled so the ground is detected correctly
• Fix: winning the run by entering the final-stage portal now records your score to the leaderboard (the game's win-path upload fired too late to reach the server; we now upload the moment you commit to the portal)
• Chaos/Gamble stat toggles (F3): Duration and Movement Speed are now toggleable in the pool (both on by default — toggle off to remove)
• Mod menus (F1 cheat menu, F3 Chaos stats): open at double size by default and are now resizeable — drag the title bar to move, drag the ↘ grip in the bottom-right corner to scale
• Damage chart (F2): now scrollable via mouse wheel; renders above the pause menu so it's readable while paused; fixed it showing only one weapon and blocking the death-screen Continue button when opened mid-run- BOMBUS: minimap icon size fixed (no longer oversized); first arrival now delayed by +5 minutes per stage on later stages
• Bow: fire rate buffed (cooldown 0.92s → 0.45s, roughly double the shots per second)
• Sniper: post-burst cooldown halved (~2.0s → ~1.5s per shot; burst/audio unchanged); minBurstInterval lowered to 0.1 for tighter bursts when stacking projectiles; damage unchanged
• Spiky Shield: moved to the Legendary pool (was Epic) and armor per stack buffed 10 → 50 (fed through the game's hyperbolic armor curve, so damage reduction still caps below 100%)
• Energy Core: moved to the Rare pool (was Legendary) — weak item, better fit
• Burst fire rate buffed (lower minBurstInterval = tighter bursts): Black Hole 3×, and 2× for Mine, Hero Sword, Poison Flask, Sword, and Corrupt Sword
• Scythe: attack rate roughly doubled (endCooldown 0.85s → 0.425s and burstTime 1.5s → 0.75s; burstTime is the dominant term in the cooldown formula)
• Roberto (Hoarder passive): now also gains +0.5% elite damage per level
• Item icons: when an item is moved to a new rarity, its baked rarity-colored outline is now recolored to match the new rarity

1.3.17

• Add BOMBUS: giant invulnerable Bee boss (15× scale) that spawns at 28 minutes into overtime with a boss HP bar and one-shot contact damage
• Za Warudo: track cumulative pickups per run; remove from loot pool after 25 total received
• Leaderboard: scores now only submitted when a new personal best is set — personal bests cached on main menu load
• Leaderboard: unauthorized mods detected at startup via BepInEx chainloader reflection; score upload blocked and warning banner shown if any non-patch mods are loaded
• F1 menu: show warning banner when any cheat feature is used, informing player that leaderboard is disabled for the run; banner hidden on main menu

1.3.16

• Cactus: thorn range now scales with player size (SphereCast maxDistance × SizeMultiplier)
• Cactus: 4 projectiles per stack (up from default)

1.3.15

• Fix Key and Echo Shard missing from loot pool (save deactivation state was not overridden)
• Fix Backpack locale bug: set projPerAmount directly (was doubling amount — broke non-English locales)
• Fix Brass Knuckles size cap: move write to postfix so method can't overwrite it
• Golden Ring: restore 1/400 → 1/128 drop chance via safe Harmony patch (no VirtualProtect)
• DurationMultiplier removed from stat blacklists (Chaos, Gamble, Shrines)
• Leaderboard: Personal tab added — shows your best run per character, scrollable
• Leaderboard: mouse wheel scrolling on Global, Friends, and Personal tabs
• Leaderboard: rank numbers scroll correctly with entries
• Leaderboard: your entry no longer pins/locks when scrolling past it in Global
• Leaderboard: personal data pre-fetched on main menu load so it's ready instantly

1.3.14

• Remove VirtualProtect usage (Thunderstore TOS compliance)
• Golden Ring chest drop chance reverts to 1/400 (will be restored via Harmony patch in a future update)
• Add AI disclosure to README

1.3.13

• Golden Ring: chest drop chance increased from 1/400 to 1/128
• Remove MoveSpeedMultiplier from stat blacklists (Chaos, Gamble Tome, Dicehead, Charge Shrines)

1.3.12

• Fix Grandma's Secret Tonic and Spicy Meatball stack caps (now enforced via loot pool, was silently ignored)
• Fix Golden Ring not granting banishes when picked up normally (single-arg AddItem overload was unpatched)
• Fix leaderboard crash when server returns 0 entries
• Fix version check flagging newer local mod as outdated (now only warns when server required > local)
• Fix stale server URL in config not updating after mod update

1.3.11

• Key: chest open chance increased from 10% to 20% per stack
• Cursed Doll: fix maxNumCursesPerCheck (was 5, now matches enemiesCursedPerDoll = 7)
• Remove MaxHealth and PickupRange from stat blacklist

1.3.10

• Fix knockback resistance scaling removal — replace crashing method patch with direct memory write
• Grandma's Secret Tonic: force baseRadius=4, radiusPerAmount=2, maxRadius=16 (max 6 stacks)
• Spicy Meatball: baseRadius=8, radiusPerAmount=4, maxRadius=32 (2× Grandma's values)
• All weapons: +10% crit chance and +20% crit damage added to upgrade pool
• Add MoveSpeedMultiplier to stat blacklist
• Greed Shrine: fix XP bonus to use Addition modifier (matches Exp Tome bucket, no double-dip)
• Remove Clock Powerup time-freeze patch (too strong)

1.3.9

• Fix crash spam in GetKnockbackResistanceMultiplierAddition causing severe FPS drops during combat

1.3.8

• Fix combat scaling (2× HP/damage ramp, knockback resistance removal) — was silently broken due to IL2CPP static field access bug
• Remove leftover debug logging patches (Lightning Orb, Bluetooth Dagger, Backpack) that were causing significant per-frame log spam and GC pressure
• Fix Tony McZooms passive stacking duplicate handlers across runs

1.3.7

• Remove Spicy Meatball patch (was doubling max size from 8m to 16m, causing severe lag)

1.3.6

• Fix forced pool items (Sucky Magnet etc.) not appearing in runs due to save deactivation state

1.3.5

• Force Battery, Skuleg, OldMask, BrassKnuckles, DemonicBlood, IdleJuice, SuckyMagnet into loot pool; toggle hidden (always active)
• Show in-game warning banner if mod is outdated (server-driven version check on main menu load)
• ServerUrl added to config (hosts only — do not change)
• Leaderboard fixes and stability improvements

1.3.4

• Leaderboard now requires current mod version — outdated clients rejected

1.3.3

• Password protect F1 debug menu
• Mark mod as WIP in README

1.3.2

• Hardcode stat blacklists and leaderboard server — no longer user-configurable

1.3.1

• Fix in-game mod version display (was showing 1.1.0)

1.3.0

• Fix clock timer console spam
• Show mod version in main menu next to game version
• Tony McZooms (Zap passive): +0.25 projectiles per level
• Golden Shield: remove reduced gold penalty on Kevin self-damage
• Spicy Meatball: pool slot removed dynamically when size cap (16m) is reached, accounts for size stat
• Grandma's Secret Tonic: pool slot removed dynamically when size cap is reached
• Hardcode item caps and size cap removal as always-on
• Hardcode stat blacklists, remove dropdowns from F1 menu
• Remove item cap and size cap dropdowns from F1 menu

1.2.0

• Space Noodle free-aim rework

1.1.0

• Space Noodle rework (StartLaser timing + StopLaser AoE finisher)