MochiFlow-BonkCoopNavigation icon

BonkCoopNavigation

Press Q to toggle teammate names through walls and direction arrows around your character. Includes distance, off-screen markers, and a bottom-left HUD hint. Requires BonkCoop.

Last updated 10 hours ago
Total downloads 8
Total rating 0 
Categories Mods
Dependency string MochiFlow-BonkCoopNavigation-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BonkCoop-BonkCoop-0.4.0 icon
BonkCoop-BonkCoop

Online co-op for 1-4 players over Steam. Same map for everyone, a wave of enemies per player, shared XP, no pause (you are protected while choosing), instant revive. Beta.

Preferred version: 0.4.0
BepInEx-BepInExPack_IL2CPP-6.0.788 icon
BepInEx-BepInExPack_IL2CPP

BepInEx pack for IL2CPP x64 Unity games. Preconfigured and ready to use.

Preferred version: 6.0.788

README

BonkCoopNavigation

Find your friends in MegaBonk co-op. Press Q to show or hide teammate names through walls and direction arrows around your character.

Requires BonkCoop 0.4.0. This is a separate, client-side add-on; it does not provide multiplayer by itself.

Features

  • One toggle: Q shows or hides teammate names and arrows together. Both start off when you launch the game.
  • Names through geometry: fixed-size labels stay readable behind walls, terrain, and at long distances.
  • Off-screen tracking: teammate names stay at the screen edge when friends are outside your view or behind you.
  • Direction arrows: colored arrows rotate around your character's body to point toward each teammate's horizontal direction.
  • Matching colors: arrows match teammate name colors. Downed teammates turn red and their labels show DOWN.
  • Distance: optional distance labels help you judge how far away friends are.
  • HUD reminder: a teammate icon and keycap in the bottom-left corner show Q Show teammates or Q Hide teammates.

Only players who want these visuals need this add-on installed. Your friends can play with BonkCoop alone; they will see BonkCoop's normal display. This add-on adds no network messages.

Install

Install BonkCoopNavigation through Thunderstore Mod Manager or r2modman. The package declares these dependencies:

  • BepInEx-BepInExPack_IL2CPP-6.0.788
  • BonkCoop-BonkCoop-0.4.0

Launch Modded, host or join a BonkCoop run, and press Q.

For manual installation, place BonkCoopNavigation.dll in BepInEx/plugins/BonkCoopNavigation/ inside your mod-manager profile. Keep only one copy installed. When upgrading from a local test build, replace its DLL or remove that local installation before installing the Thunderstore package.

Controls and key conflicts

The default key is Q. Change ToggleArrowsKey under [Navigation] in BepInEx/config/jerod.bonkcoopnavigation.cfg with the game closed, then restart. For example:

[Navigation]
ToggleArrowsKey = G

The setting name ToggleArrowsKey is retained for compatibility; it controls both names and arrows. The HUD reminder automatically displays the configured key. None disables the hotkey.

Before enabling the visuals, the mod checks your active game keyboard bindings. If the key is already assigned to a game action, it shows a warning and leaves the visuals off. Your game's action still works normally. Bindings used privately by other mods cannot be detected, so change the key if needed. The toggle is ignored outside a run and while a text input field is selected.

During gameplay, this add-on controls overhead and edge name visibility independently of BonkCoop's Names and Markers options. Disabling this add-on restores BonkCoop's original labels. The overlay does not intercept mouse clicks.

Configuration

After the first modded launch, edit BepInEx/config/jerod.bonkcoopnavigation.cfg through your mod manager or a text editor, with the game closed.

Section Setting Default Purpose
General Enabled true Enable the add-on
Display ShowDistance true Show teammate distance
Display ShowOffScreen true Show names at screen edges
Display ShowToggleHint true Show the bottom-left icon and key reminder
Display FontSize 24 Name size at 1920x1080, range 12-48
Display HeightOffset 2 Label height above teammates, range 0-6
Navigation ToggleArrowsKey Q Show/hide names and arrows together
Navigation ArrowRadius 1.8 Distance of arrows from your body, range 1-5
Navigation ArrowSize 1 Arrow size multiplier, range 0.5-2

Compatibility and limitations

Built against BonkCoop 0.4.0 and BepInEx IL2CPP 6.0.0-be.788. Everyone still needs compatible BonkCoop and game versions for multiplayer.

  • Teammates must have loaded into the run and received their first position before they appear.
  • Names may overlap when teammates stand together. Long names are shortened to fit.
  • Arrows indicate horizontal direction. A teammate directly above or below you at the same horizontal position has no arrow bearing.
  • A changed minimap layout does not move the bottom-left HUD reminder.
  • BonkCoop updates may require an update to this add-on's integration.

If the mod reports a problem, check BepInEx/LogOutput.log for BonkCoopNavigation messages and include those messages when reporting the issue. If nothing appears, confirm the add-on is enabled and press Q during a real co-op run.

BonkCoopNavigation is an independent add-on. Multiplayer is provided by the BonkCoop project; its DLL is not included in this package.