FriendinaBox
Friend in a Box — deployable proximity-mine grenade that enables multiplayer-only Ouroboros upgrades while equipped.
About this mod Author’s original text
Friend in a Box
A BepInEx mod for Mycopunk that adds Friend in a Box — a deployable grenade that:
- Lands as a proximity mine (Incendiary stats, ~20s duration)
- Detonates when enemies enter its detect radius
- While equipped, enables multiplayer-only (UpgradeFlags.Coop) upgrades in Ouroboros solo runs
- Supports mine / turret / mortar / drone modes and 18 upgrades
Features
| Feature | Detail |
|---|---|
| Gear | friend_in_a_box (id 92100), auto-unlocked |
| Baseline | Cloned Incendiary Grenade stats / visuals |
| Deploy | On fuse/detonate → arm field entity instead of instant boom |
| Duration | 20s default |
| Detect | Defaults to 75% of explosion radius |
| Concurrent | 1 by default; Squad Drop multi-spawns in a spread |
| Modes | Mine / Turret (RailBullet) / Mortar (MortarBullet) / Drone |
| Coop unlock | Equipped Friend enables multiplayer-only Ouroboros upgrades in solo |
| Upgrades | 18 total — mine path, mode kits, combat, Hive Kin (Swarm Breeding Season) |
Install
/BepInEx/plugins/FriendinaBox.dll
Build:
dotnet build FriendinaBox.sln --configuration Release
Output: bin/Release/netstandard2.1/FriendinaBox.dll
Architecture
| Type | Role |
|---|---|
| FriendinaBoxPlugin | BepInEx entry, registration, Harmony |
| GrenadeRegistration | Clone Incendiary → AllGear + GearInfo |
| FriendinaBoxBehaviour | Deploy data host on gear |
| FriendGrenadeHooks | Detonate prefix → spawn deployable(s) |
| FriendDeployable | Mine / turret / mortar / drone field entity |
| FriendDeployTracker | Concurrent deploys, formation, Hive Kin allies |
| CoopUnlockHook | Solo Coop upgrade unlock while equipped |
| SpawnGearHooks | NGO equip remap + identity stamp + ApplyUpgrades |
| SwarmFriendFireHooks | Hive Kin ↔ Swarm Breeding Season |
| FriendCombatHooks | Lifesteal, marks, kill charge/duration, scuttle |
Test checklist
- Log shows gear registration + Registered 18 upgrades
- Gear select lists Friend in a Box; equip works on first menu close
- Throw → lands → sits (no instant boom)
- Enemy enters radius → explodes
- Duration ends → despawn / expire effects
- Solo Ouroboros with Friend equipped → Coop upgrades can appear
- Squad Drop → multi-spawn ring; Hive Kin + Swarm Breeding Season → pellets from deploys
License
MIT — see LICENSE
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: