Skip to main content

​
What is SpawnLogger?

SpawnLogger is a BepInEx mod for MegaBonk that provides real-time tracking of spawned interactable objects during gameplay. Never miss a chest, shrine, or mysterious visitor again with an intuitive on-screen overlay that shows you exactly what’s active in your current run.

Installation

Get SpawnLogger installed and ready to use

Quickstart

Start tracking spawns in minutes

Features

Explore what SpawnLogger can track

​
What does it track?

SpawnLogger monitors four critical types of interactable objects that spawn during your MegaBonk runs:

​
Chests

Tracks the total number of chests spawned and how many remain unopened. The counter automatically decrements as you open chests, helping you ensure you don’t leave loot behind.

​
ShadyGuys

Monitors mysterious ShadyGuy NPCs that appear during runs. See how many have spawned, how many you’ve interacted with, and how many have disappeared before you could reach them.

​
Charge shrines

Keeps count of active Charge Shrines that need completing. The tracker updates in real-time as shrines are completed, showing you how many are still waiting.

​
Moai shrines

Tracks the enigmatic Moai Shrines, displaying both the total spawned and how many you’ve successfully interacted with.

​
The overlay UI

SpawnLogger displays a semi-transparent overlay in the bottom-left corner of your screen (positioned at 80% screen height). The overlay shows: 
Chests: 2/5
ShadyGuys: 1/3
Shrines: 1/2
Moai: 0/1
The overlay uses a bold, white font with subtle text shadows for excellent readability against any background. When no objects have spawned yet, it displays “Waiting for spawns…” to confirm the mod is active.
The overlay automatically appears when chests spawn and persists across stage transitions using Unity’s DontDestroyOnLoad functionality.

​
Key features

Real-time tracking

Counters update instantly as you interact with objects or they despawn

Persistent overlay

The UI persists across stage transitions and only resets between rounds

Round-aware

Automatically resets tracking when rounds end and re-enables when new rounds start

Performance optimized

Uses Harmony patches for efficient hooking with minimal game impact

​
How it works

SpawnLogger uses HarmonyX to patch into MegaBonk’s game logic:
  • Spawn detection: Hooks into SpawnInteractables.SpawnChests(), SpawnInteractables.SpawnShrines(), and related methods
  • Interaction tracking: Patches TrackStats.OnChestOpened(), InteractableShadyGuy.Interact(), and shrine completion methods
  • Round lifecycle: Monitors GameManager methods like StartPlaying(), OnDied(), and OnDestroy() to reset counters appropriately
SpawnLogger disables tracking outside of active rounds to prevent incorrect counts. Tracking automatically re-enables when a new round starts.

​
Version information

  • Current version: 0.5.3
  • Author: Antiparty
  • Plugin GUID: Antiparty_SpawnLogger
  • BepInEx compatibility: IL2CPP Unity builds

​
Ready to get started?

Head over to the installation guide to set up SpawnLogger, or jump straight to the quickstart if you already have BepInEx configured.

Build docs developers (and LLMs) love

Get started for freeTalk to us