FriendinaBox
Friend in a Box — deployable proximity-mine grenade that enables multiplayer-only Ouroboros upgrades while equipped.
| Date uploaded | 2 weeks ago |
| Version | 1.0.0 |
| Download link | Sparroh-FriendinaBox-1.0.0.zip |
| Downloads | 90 |
| Dependency string | Sparroh-FriendinaBox-1.0.0 |
This mod requires the following mods to function
BepInEx-BepInExPack_Mycopunk
BepInEx pack for Mycopunk. Preconfigured and ready to use.
Preferred version: 5.4.2403README
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
<Mycopunk>/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
CHANGELOG
Changelog
1.0.0
-
Friend in a Box custom grenade (runtime clone of Incendiary)
-
Lands as a proximity mine (default 20s duration, detect = 75% explosion radius)
-
While equipped, unlocks Ouroboros
UpgradeFlags.Coopupgrades in solo -
Auto-unlock into gear select; equip/spawn remap for NGO catalog clones
-
Magenta debug cube on armed mines (shared helper for future drone/turret)
-
First upgrades: Wider Net, Long Watch, Quick Deploy, Lingering Gift, Parting Boost
-
Baseline mine detect radius = 75% of explosion radius
-
Only one mine at a time; new deploy quietly replaces the oldest
-
Mode scaffolding: Mine (magenta) / Turret (green) / Mortar (orange) / Drone (cyan)
-
Mode converters: Sentry Kit, Lobber Kit, Buddy Protocol (drone hybrids supported)
-
Turret fires real RailBullet (Cycler); mortar fires real MortarBullet (enemy mortar)
-
Boot fix: register gear before PlayerData.OnAwake; harden upgrades; guard vanilla OnAwake RemoveAt bug
-
Guard GearSlot.Update NRE (new-upgrades badge) so gear menu stays stable
-
Registration scans AllGear instead of FindGear during boot; post-OnAwake GearData + upgrades
-
Combat upgrades: Squad Drop, Sympathetic Link (blue overheal), Field Recharge, Overtime, Painted Targets, Scuttle Charge, Reactive Shell
-
QoL: turret/mortar engage range floor 50; drone hovers above player (not inside)
-
Squad Drop drones use formation ring offsets so they don't occupy the same space
-
Calibrated Link: turret/mortar blend primary weapon stats (incl. bullets/shot); Designated Target: focus last player-hit enemy
-
Hive Kin: all Friend deployables (mine/turret/mortar/drone) count as Swarm Breeding Season allies
-
Squad Drop: one throw multi-spawns deployables in a ring spread (no overlap)
-
Fix first-time equip: stop OnClose double-spawn; deferred stamp after SpawnGear RPC
-
Post-stamp ApplyUpgrades so Friend upgrades/HUD bind on first close (not second open)
-
Project cleanup: rename CSPROJECT → FriendinaBox.csproj; remove Example* template files
