OmniBonk

OmniBonk

[![Download][download-shield]][download-url] [![Forks][forks-shield]][forks-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url] [![GPL-2.0 License][license-shield]][license-url]

About The Mod

A fully synced (To the best of my knowledge) online shared experience co-op mod for up to 6 players based on Megabonk Together by Fcornaire, running on BepInEX. Built with Claude.

Features:

• P2P via Steamworks, LAN networking
• Up to 6 players
• Can't fit teammate cards on the HUD beyond 6 players
• All in-game mechanics are synchronised (Haven't noticed any issues)
• XP (Tome works perfectly)
• Difficulty (I forgot the calculation for this)
• Weapons
• Projectiles/Sizes
• Monsters
• Chest/Shrines/Challenges
• Mini-bosses/Portal and Final Boss
• Stat counters
• VFX
• Skip chest animation
• Duo-charging Shrine
• Increase speed of Charging Shrine up to 2 players. Item still stack.
• Revives
• Revive via interacting with player's coffin which will spawn a Ghost you'll have to kill
• Shared experience mode
• Game pauses for everyone when opening chest or leveling up, and etc
• Fail-safe that triggers after 20s if users are stuck "Waiting for other players" or no players are choosing items after time is up
• Controller input grace period
• 0.35s by default to prevent accidentally choosing incorrect items while bunny hopping with controller
• Endless run
• Any tier opens up Portals
• Boss room every 3 stages
• After every boss room, enemies get ×1.5 HP and deal ×1.25 damage, on top of the game's own difficulty that rises with time
• End-game summary shows how much round you've survived
• More (Enable via lobby settings - Host)
• No projectile cap
• Go beyond 80
• No enemy cap
• Base game has a hard cap of 550
• Skip Chest Animation
• More explanatory settings in BepInEx/config/OmniBonk.cfg
• Leaderboard scores are disabled, but you can still get achievements
• Might consider doing a Endless run leaderboard

Everyone in a session must run the same version. In the lobby, a player on a different version shows WRONG VERSION, and the host cannot start until they update. On the Steam transport, a lobby from a different version cannot be joined at all.

Install

OmniBonk is developed and tested on Windows. It was never tested on Linux or Steam Deck. Back up your save before installing. It is in {user}/AppData/LocalLow/Ved/Megabonk; copying that whole folder is the simplest way.

OmniBonk runs on the BepInEx 6 Bleeding Edge build.

1. Download the latest BepInEx IL2CPP build
2. Extract to your root folder of Megabonk (i.e {your own path}/steamapps/common/Megabonk)
3. Launch the game once with BepInEX, so that it will generates the files it needs
4. Close the game, then download the latest release
5. Extract the zip and copy the OmniBonk folder into BepInEx/plugins (i.e ../steamapps/common/Megabonk/BepInEx/plugins)
6. Launch the game

There should be an OmniBonk button with the version release on the bottom right.

The button cannot be selected with a controller yet. Click it with the mouse; you can switch back to the controller afterwards.

Updating

• Manually - Download the latest release and replace the BepInEx/plugins/OmniBonk folder with the one in the zip. Your settings in

BepInEx/config/OmniBonk.cfg are kept.

• Thunderstore or r2modman or similar - Update through the mod manager

Everyone in a session needs the same OmniBonk version; the lobby shows WRONG VERSION otherwise.

Self-Hosting a Server

If you want to run your own matchmaking/relay server, check the Self-Hosting Guide.

License

OmniBonk is distributed under the GPL-2.0 (see LICENSE). It is based on Megabonk Together by Fcornaire.

[contributors-shield]: https://img.shields.io/github/contributors/CEOYap/OmniBonk.svg?style=for-the-badge [contributors-url]: https://github.com/CEOYap/OmniBonk/graphs/contributors [forks-shield]: https://img.shields.io/github/forks/CEOYap/OmniBonk.svg?style=for-the-badge [forks-url]: https://github.com/CEOYap/OmniBonk/network/members [stars-shield]: https://img.shields.io/github/stars/CEOYap/OmniBonk.svg?style=for-the-badge [stars-url]: https://github.com/CEOYap/OmniBonk/stargazers [issues-shield]: https://img.shields.io/github/issues/CEOYap/OmniBonk.svg?style=for-the-badge [issues-url]: https://github.com/CEOYap/OmniBonk/issues [license-shield]: https://img.shields.io/github/license/CEOYap/OmniBonk.svg?style=for-the-badge [download-shield]: https://img.shields.io/github/downloads/CEOYap/OmniBonk/total?style=for-the-badge [download-url]: https://github.com/CEOYap/OmniBonk/releases [license-url]: https://github.com/CEOYap/OmniBonk/blob/main/LICENSE