FriendinaBox
Friend in a Box — deployable proximity-mine grenade that enables multiplayer-only Ouroboros upgrades while equipped.
模組介紹 作者原文
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
安裝與使用 安裝：按包內說明操作
- 解壓本站下載的壓縮包，先讀包內的 readme / 說明檔案。
- 多數模組依賴遊戲的模組載入器：常見做法是用社群模組管理器（如 r2modman）選中本遊戲安裝，由管理器自動處理載入器與依賴。
- 手動安裝時，把模組檔案放進遊戲目錄下對應的 Mod / plugins 資料夾。
- 啟動遊戲確認載入成功；帶「前置依賴」的模組需要把依賴一併安裝。
不同模組的安裝位置差異較大，包內說明是最可靠的依據。
下面這些內容需要先安裝，否則該模組不會生效：